翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # アプリケーションに Amazon Bedrock エージェントをデプロイして使用する エージェントを使用する前に、エイリアスを作成して、エージェントをデプロイする必要があります。その後、[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) オペレーションを呼び出すと、アプリケーションでそのエージェントを使用できます。このセクションでは、エイリアスを作成および管理する方法と、アプリケーションからエージェントを呼び出す方法について説明します。 **Topics** + [エージェントのデプロイ](deploy-agent.md) + [アプリケーションからエージェントを呼び出す](agents-invoke-agent.md) # エージェントのデプロイ 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)」を参照してください。 ------ # アプリケーションからエージェントを呼び出す [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) リクエストを実行することで、アプリケーションでエージェントを使用できます。 デフォルトでは、`InvokeAgent` からのレスポンスには、エージェントからの完全なレスポンスを含むチャンクが含まれており、完了するまでに時間がかかる場合があります。別の方法として、レスポンスを複数の小規模のチャンクに分割してストリーミングするように、`InvokeAgent` を設定することもできます。これにより、エージェントからの最初のレスポンスのレイテンシーを短縮できます。 **ストリーミングレスポンス** 必要に応じて、ストリーミング設定 ([StreamingConfigurations](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StreamingConfigurations.html)) で `streamFinalResponse` を `true` に設定することで、レスポンスのストリーミングを有効にできます。レスポンスストリームには、レスポンスの各部分のチャンクが順番に含まれる、複数のイベントが含まれます。 レスポンスをストリーミングするには、エージェント実行ロールに、設定済みのエージェントのモデルの `bedrock:InvokeModelWithResponseStream` アクセス許可が含まれていることを確認します。詳細については、「[エージェントサービスロールのアイデンティティベースのアクセス許可](agents-permissions.md#agents-permissions-identity)」を参照してください。 エージェントにガードレールが設定されている場合は、`StreamingConfigurations` で `applyGuardrailInterval` を指定して、`ApplyGuardrail` コールが実行される頻度を、送信されるレスポンス文字数 (50 文字ごとなど) で制御することもできます。 デフォルトのガードレール間隔は、50 文字ごとに設定されています。間隔をより大きく指定すると、レスポンスはよりサイズの大きいチャンクに分割され、`ApplyGuardrail` コールの回数が低減します。次の例では、「*Hello, I am an agent*」という入力文字列に対して生成されたレスポンスが示されています。 **複数のチャンクでのレスポンスの例: 間隔を 3 文字に設定** ``` 'Hel', 'lo, ', 'I am', ' an', ' Age', 'nt' ``` 各チャンクには、最後のチャンクを除き、少なくとも 3 つの文字が含まれます。 **複数のチャンクでのレスポンスの例: 間隔を 20 文字数以上に設定** ``` 'Hello, I am an Agent' ``` ## エージェントを呼び出す 次の Python の例では、[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) オペレーションを呼び出し、エージェントからの出力と、呼び出しによって生成される[証跡](trace-events.md)情報を表示する方法を説明しています。 **エージェントを呼び出すには** 1. 「[エージェントを手動で作成および設定する](agents-create.md)」の手順に従って、エージェントを作成します。エージェントの ID を書き留めます。ID は、必要に応じて後で取得できます。詳細については、「[エージェントに関する情報を表示する](agents-view.md)」を参照してください。 1. 「[エージェントのエイリアスを作成する](deploy-agent-proc.md)」の手順に従って、エージェントのエイリアスを作成します。エイリアスの ID を書き留めます。ID は、必要に応じて後で取得できます。詳細については、「[Amazon Bedrock でエージェントのエイリアスに関する情報を表示する](agents-alias-view.md)」を参照してください。 1. 以下のコードを実行します。`agent_id` の値をエージェントの ID に、`alias_id` の値はエージェントのエイリアス ID に更新します。エージェントからのレスポンスをストリーミングするには、`streamFinalResponse` の値を `True` に変更します。`applyGuardrailInterval` の値を変更すると、ガードレールの間隔を変更することもできます。 ``` import boto3 import logging from botocore.exceptions import ClientError logging.basicConfig(level=logging.INFO) logger = logging.getLogger(__name__) def invoke_agent(client, agent_id, alias_id, prompt, session_id): response = client.invoke_agent( agentId=agent_id, agentAliasId=alias_id, enableTrace=True, sessionId = session_id, inputText=prompt, streamingConfigurations = { "applyGuardrailInterval" : 20, "streamFinalResponse" : False } ) completion = "" for event in response.get("completion"): #Collect agent output. if 'chunk' in event: chunk = event["chunk"] completion += chunk["bytes"].decode() # Log trace output. if 'trace' in event: trace_event = event.get("trace") trace = trace_event['trace'] for key, value in trace.items(): logging.info("%s: %s",key,value) print(f"Agent response: {completion}") if __name__ == "__main__": client=boto3.client( service_name="bedrock-agent-runtime" ) agent_id = "AGENT_ID" alias_id = "ALIAS_ID" session_id = "MY_SESSION_ID" prompt = "Prompt to send to agent" try: invoke_agent(client, agent_id, alias_id, prompt, session_id) except ClientError as e: print(f"Client error: {str(e)}") logger.error("Client error: %s", {str(e)}) ```