翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# エージェントのデプロイ
Amazon Bedrock エージェントを初めて作成すると、作業中のドラフトバージョン (`DRAFT`) と、作業中のドラフトバージョンを指すテストエイリアス (`TSTALIASID`) が作成されます。エージェントに変更を加えると、変更が作業中のドラフトに適用されます。エージェントの動作に満足するまで、作業中のドラフトで繰り返し編集を行います。次に、アプリケーションへのデプロイと統合のために、エージェントの*エイリアス*を作成して、エージェントを設定できます。
**エイリアスとバージョン**
エージェントをデプロイするには、*エイリアス*の作成が必要です。エイリアスの作成中に、Amazon Bedrock でエージェントのバージョンが自動的に作成されます。エイリアスはこの新しく作成されたバージョンを指します。または、以前に作成したバージョンのエージェントを指すようにエイリアスを変更することもできます。次に、そのエイリアスに API コールを行うようにアプリケーションを設定します。
*バージョン*は、それが作成されたときに存在していたリソースを保存したスナップショットです。作業中のドラフトを引き続き変更し、必要に応じてエージェントの新しいエイリアス (ひいてはバージョン) を作成できます。Amazon Bedrock で、エージェントの新しいバージョンを作成します。それには、この新しいバージョンをデフォルトで指すエイリアスを作成します。Amazon Bedrock は、バージョンを作成して、バージョン名として 1 から始まる番号を順に付けます。
バージョンは、エージェントの作成当時のスナップショットの役割を果たすため、変更できません。本番稼働中のエージェントを更新するには、新しいバージョンを作成し、そのバージョンを指すエイリアスに呼び出しを行うようアプリケーションを設定する必要があります。
エイリアスを使用すると、アプリケーションでバージョンを追跡しなくても、エージェントの複数のバージョン間を効率的に切り替えることができます。例えば、すぐに元に戻す必要がある変更の場合は、以前のバージョンのエージェントを指すようにエイリアスを変更できます。
## デプロイ済みエージェントの一時停止
エージェントの実行を一時的に停止する必要がある場合があります。例えば、メンテナンス中、アップデート中、またはパフォーマンスの問題に対処する場合などがあります。エージェントを一時停止するには、[UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html) オペレーションでエージェントのエイリアスを使用します。エージェントを一時停止するには、`aliasInvocationState` フィールドを `REJECT_INVOCATIONS` に設定します。エージェントの実行を再開するには、`aliasInvocationState` を `ACCEPT_INVOCATIONS` に設定します。エージェントを一時停止するのに IAM ポリシーを変更する必要はありません。
エージェントが現在一時停止中かどうかを確認するには、[GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) を呼び出して `aliasInvocationState` フィールドを確認します。[ListAgentAliases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentAliases.html) からのレスポンスで、エイリアスの `aliasInvocationState` フィールドを確認することもできます。
**Topics**
+ [デプロイ済みエージェントの一時停止](#agent-pause)
+ [エージェントのエイリアスを作成する](deploy-agent-proc.md)
+ [Amazon Bedrock でエージェントのバージョンに関する情報を表示する](agents-version-view.md)
+ [Amazon Bedrock でエージェントのバージョンを削除する](agents-version-delete.md)
+ [Amazon Bedrock でエージェントのエイリアスに関する情報を表示する](agents-alias-view.md)
+ [Amazon Bedrock でエージェントのエイリアスを編集する](agents-alias-edit.md)
+ [Amazon Bedrock でエージェントのエイリアスを削除する](agents-alias-delete.md)
# エージェントのエイリアスを作成する
以下の手順は、エージェントのエイリアスとバージョンを作成する方法を説明しています。エイリアスを作成したら、[Amazon Bedrock エージェントのランタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt)を使用して [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) リクエストを実行することで、アプリケーションでエージェントを使用できます。
**エイリアスを作成するには**
+ エージェントのエイリアスとバージョンを作成します。任意の方法のタブを選択し、その手順に従います。
------
#### [ Console ]
**エイリアス (およびオプションで新しいバージョン) を作成するには**
1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。
1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。
1. **[エイリアス]** セクションで、**[作成]** を選択します。
1. **[エイリアス名]** に一意の名前を入力し、オプションで **[説明]** を入力します。
1. **[バージョンを関連付ける]** で、次のいずれかのオプションを選択します。
+ 新しいバージョンを作成するには、**[新しいバージョンを作成してこのエイリアスに関連付ける]** を選択します。
+ 既存のバージョンを使用するには、**[既存のバージョンを使用してこのエイリアスを関連付ける]** を選択します。ドロップダウンメニューから、エイリアスを関連付けるバージョンを選択します。
1. **[スループットを選択]** で、次のいずれかのオプションを選択します。
+ アカウントに設定されたレートでエージェントにモデル推論を実行させるには、**[オンデマンド (ODT)]** を選択します。詳細については、「[Amazon Bedrock のクォータ](quotas.md)」を参照してください。
+ モデル用に以前に購入したプロビジョンドスループットを使用して、高いレートでエージェントにモデル推論を実行させるには、**[プロビジョンドスループット (PT)]** を選択してから、プロビジョンドモデルを選択します。詳細については、「[Amazon Bedrock のプロビジョンドスループットでモデル呼び出し容量を増やす](prov-throughput.md)」を参照してください。
1. **[エイリアスを作成]** を選択します。
------
#### [ API ]
エージェントのエイリアスを作成するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [CreateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgentAlias.html) リクエストを送信します。
以下のフィールドが必要です。
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/deploy-agent-proc.html)
次のフィールドはオプションです。
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/bedrock/latest/userguide/deploy-agent-proc.html)
```
def create_agent_alias(self, name, agent_id):
"""
Creates an alias of an agent that can be used to deploy the agent.
:param name: The name of the alias.
:param agent_id: The unique identifier of the agent.
:return: Details about the alias that was created.
"""
try:
response = self.client.create_agent_alias(
agentAliasName=name, agentId=agent_id
)
agent_alias = response["agentAlias"]
except ClientError as e:
logger.error(f"Couldn't create agent alias. {e}")
raise
else:
return agent_alias
```
詳細については、「[Amazon Bedrock エージェントの始め方](bedrock-agent_example_bedrock-agent_Hello_section.md)」を参照してください。
------
# Amazon Bedrock でエージェントのバージョンに関する情報を表示する
エージェントのバージョンを作成したら、そのバージョンに関する情報を表示または削除できます。エージェントの新しいバージョンの作成は、新しいエイリアスを作成することでのみ行えます。
エージェントのバージョンに関する情報を表示する方法については、使用する方法に対応するタブを選択して、手順に従ってください。
------
#### [ Console ]
**エージェントのバージョンに関する情報を表示するには**
1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。
1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。
1. **[バージョン]** セクションで、表示するバージョンを選択します。
1. エージェントのバージョンにアタッチされたモデル、アクショングループ、ナレッジベースの詳細を表示するには、表示する情報の名前を選択します。バージョンの一部を変更することはできません。エージェントを変更するには、作業用のドラフトを使用して新しいバージョンを作成します。
------
#### [ API ]
エージェントのバージョン情報を一覧表示するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [GetAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentVersion.html) リクエストを送信します。`agentId` と `agentVersion` を指定します。
エージェントのバージョン情報を一覧表示するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して、`agentId` を指定し、[ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html) リクエストを送信します。以下のオプションパラメータを指定できます。
****
| フィールド | 簡単な説明 |
| --- | --- |
| maxResults | レスポンスとして返す結果の最大数。 |
| nextToken | maxResults フィールドで指定した数よりも結果の件数が多い場合は、レスポンスで nextToken 値が返されます。結果の次のバッチを表示するには、別のリクエストで nextToken 値を送信します。 |
------
# Amazon Bedrock でエージェントのバージョンを削除する
エージェントのバージョンを削除する方法については、使用する方法に対応するタブを選択して、手順に従ってください。
------
#### [ Console ]
**エージェントのバージョンを削除するには**
1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。
1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。
1. 削除するバージョンを選択するには、**[バージョン]** セクションで、削除するバージョンの横にあるオプションボタンを選択します。
1. **[削除]** を選択します。
1. 削除の結果について警告するダイアログボックスが表示されます。バージョンの削除を確定するには、入力フィールドに **delete** と入力し、**[削除]** を選択します。
1. バージョンが削除されていることを知らせるバナーが表示されます。削除が完了すると、成功を示すバナーが表示されます。
------
#### [ API ]
エージェントのバージョンを削除するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [DeleteAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentVersion.html) リクエストを送信します。デフォルトでは、`skipResourceInUseCheck` パラメータは `false` となっており、リソースが使用中の場合は削除が停止されます。`skipResourceInUseCheck` を `true` に設定すると、リソースは使用中であっても削除されます。
------
# Amazon Bedrock でエージェントのエイリアスに関する情報を表示する
エージェントのエイリアスに関する情報を表示する方法については、使用する方法に対応するタブを選択して、手順に従ってください。
------
#### [ Console ]
**エイリアスの詳細を表示するには**
1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。
1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。
1. **[エイリアス]** セクションで、表示するエイリアスを選択します。
1. エイリアスの名前と説明、およびエイリアスに関連付けられているタグを表示できます。
------
#### [ API ]
エージェントのエイリアスに関する情報を取得するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) リクエストを送信します。`agentId` と `agentAliasId` を指定します。
エージェントのエイリアスに関する情報を一覧表示するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して、`agentId` を指定し、[ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.html) リクエストを送信します。以下のオプションパラメータを指定できます。
****
| フィールド | 簡単な説明 |
| --- | --- |
| maxResults | レスポンスとして返す結果の最大数。 |
| nextToken | maxResults フィールドで指定した数よりも結果の件数が多い場合は、レスポンスで nextToken 値が返されます。結果の次のバッチを表示するには、別のリクエストで nextToken 値を送信します。 |
エイリアスのすべてのタグを表示するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して、エイリアスの Amazon リソースネーム (ARN) を含め、[ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.html) リクエストを送信します。
------
# Amazon Bedrock でエージェントのエイリアスを編集する
エージェントのエイリアスを編集する方法については、使用する方法に対応するタブを選択して、手順に従ってください。
------
#### [ Console ]
**エイリアスを編集するには**
1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。
1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。
1. **[エイリアス]** セクションで、編集するエイリアスの横にあるオプションボタンを選択します。次に、**[編集]** を選択します。
1. 必要に応じて既存のフィールドを編集します。フィールドの詳細については、「」を参照してください[アプリケーションに Amazon Bedrock エージェントをデプロイして使用する](agents-deploy.md)
1. **[保存]** を選択します。
**エイリアスに関連付けられたタグを追加または削除するには**
1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。
1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。
1. **[エイリアス]** セクションで、タグを管理するエイリアスを選択します。
1. **[タグ]** セクションで、**[タグを管理]** を選択します。
1. タグを追加するには、[**新しいタグの追加**] を選択します。**[キー]** を入力し、オプションで **[値]** を入力します。タグを削除するには**[削除]** を選択してください。詳細については、「[Amazon Bedrock リソースにタグ付け](tagging.md)」を参照してください。
1. タグの編集が終了したら、**[送信]** を選択します。
------
#### [ API ]
エージェントのエイリアスを編集するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して、[UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html) リクエストを送信します。すべてのフィールドが上書きされるため、更新するフィールドと、変更せずに維持するフィールドの両方を含めます。
エイリアスにタグを追加するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して、エイリアスの Amazon リソースネーム (ARN) を含め、[TagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TagResource.html) リクエストを送信します。リクエスト本文には、各タグに指定したキーと値のペアを含むオブジェクトである `tags` フィールドが含まれています。
エイリアスからタグを削除するには、[Amazon Bedrock エージェントのビルドタイムAmazon Bedrock エージェントのエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して、エイリアスの Amazon リソースネーム (ARN) を含め、[UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.html) リクエストを送信します。`tagKeys` リクエストパラメータは、削除するタグのキーを含むリストです。
------
# Amazon Bedrock でエージェントのエイリアスを削除する
エージェントのエイリアスを削除する方法については、使用する方法に対応するタブを選択して、手順に従ってください。
------
#### [ Console ]
**エイリアスを削除するには**
1. Amazon Bedrock コンソールを使用するためのアクセス許可を持つ IAM ID を使用して、AWS マネジメントコンソールにサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。
1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。
1. 削除するエイリアスを選択するには、**[エイリアス]** セクションで、削除するエイリアスの横にあるオプションボタンを選択します。
1. **[削除]** を選択します。
1. 削除の結果について警告するダイアログボックスが表示されます。エイリアスの削除を確定するには、入力フィールドに **delete** と入力し、**[削除]** を選択します。
1. エイリアスが削除中であることを知らせるバナーが表示されます。削除が完了すると、成功を示すバナーが表示されます。
------
#### [ API ]
エージェントのエイリアスを削除するには、[Amazon Bedrock エージェントのビルドタイムエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [DeleteAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentAlias.html) リクエストを送信します。デフォルトでは、`skipResourceInUseCheck` パラメータは `false` となっており、リソースが使用中の場合は削除が停止されます。`skipResourceInUseCheck` を `true` に設定すると、リソースは使用中であっても削除されます。
```
def delete_agent_alias(self, agent_id, agent_alias_id):
"""
Deletes an alias of an Amazon Bedrock agent.
:param agent_id: The unique identifier of the agent that the alias belongs to.
:param agent_alias_id: The unique identifier of the alias to delete.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
response = self.client.delete_agent_alias(
agentId=agent_id, agentAliasId=agent_alias_id
)
except ClientError as e:
logger.error(f"Couldn't delete agent alias. {e}")
raise
else:
return response
```
詳細については、「[Amazon Bedrock エージェントの始め方](bedrock-agent_example_bedrock-agent_Hello_section.md)」を参照してください。
------