マルチエージェントコラボレーションを作成する

注記

マルチエージェントコラボレーション機能は Amazon Bedrock のプレビューリリースであり、変更される可能性があります。

マルチエージェントコラボレーションの作成は、次のステップで構成されます。

1. 共同作業者エージェントを作成してデプロイします。マルチエージェントコラボレーションワークフロー内で特定のタスクを実装するように、各共同作業者エージェントを設定してください。

2. 新しいスーパーバイザーエージェントを作成するか、既存のエージェントにスーパーバイザーのロールを割り当てます。新しいスーパーバイザーエージェントを作成するとき、または既存のエージェントをスーパーバイザーエージェントとして識別するときに、スーパーバイザーエージェントが複数の共同作業者エージェント間で情報を処理する方法を指定することもできます。

   共同作業者エージェントからのレスポンスを調整するタスクをスーパーバイザーエージェントに割り当てることも、ルーティング情報のタスクを適切な共同作業者エージェントに割り当てて最終レスポンスを送信することもできます。スーパーバイザーエージェントにルーティング情報のタスクを割り当てると、レイテンシーが短縮されます。

3. 共同作業者エージェントのエイリアスバージョンをスーパーバイザーエージェントに関連付けます。

   注記

   現時点では、最大 10 人の共同作業者エージェントをスーパーバイザーエージェントに関連付けることができます。

4. マルチエージェントコラボレーションチームを準備してテストします。

5. スーパーバイザーエージェントをデプロイして呼び出します。

マルチエージェントコラボレーションは、Amazon Bedrock コンソール、 APIs、 CLI、または AWS SDK AWS を使用して作成できます。マルチエージェントコラボレーションを作成する方法については、任意の方法のタブを選択し、手順に従ってください。

Console

ステップ 1: 共同作業者エージェントを作成する

• エージェントを作成および設定する手順に従います。必ず各共同作業者エージェントが特定のタスクを実行するように設定します。

ステップ 2: 新しいスーパーバイザーエージェントを作成するか、既存のエージェントにスーパーバイザーロールを割り当てる

1. 新しいスーパーバイザーエージェントを作成する場合は、「」の手順に従ってエージェントを手動で作成および設定する、次のステップに進みます。

   エージェントがすでに設定されていて、エージェントにスーパーバイザーロールを割り当てる場合は、次のステップに進みます。

2. エージェントビルダーを開いていない場合は、次の操作を行います。

   1. Amazon Bedrock アクセス許可を持つ IAM ロール AWS Management Console を使用して にサインインし、https://console.aws.amazon.com/bedrock/ で Amazon Bedrock コンソールを開きます。

   2. 左側のナビゲーションペインで [エージェント] を選択します。次に、[エージェント] セクションでエージェントを選択します。

   3. [エージェントビルダーで編集] を選択します。

   4. エージェントビルダーで、マルチエージェントコラボレーションセクションまでスクロールし、編集を選択します。

3. マルチエージェントコラボレーションページのコラボレーションステータスセクションで、マルチエージェントコラボレーションを有効にします。これにより、エージェントはスーパーバイザーエージェントとして識別されます。

4. コラボレーション設定セクションで、スーパーバイザーエージェントが複数の共同作業者エージェントの情報をどのように処理して最終応答を調整するかを選択します。

   1. スーパーバイザーエージェントに共同作業者エージェントからの応答を調整する場合は、スーパーバイザーを選択します。

   2. スーパーバイザーエージェントが情報を適切な共同作業者エージェントにルーティングして最終レスポンスを送信する場合は、ルーティングのあるスーパーバイザーを選択します。

   3. 次のステップに進み、共同作業者エージェントを追加します。

ステップ 3: 共同作業者エージェントを追加する

1. エージェント共同作業者セクションを展開し、マルチエージェントコラボレーション用に作成した共同作業者エージェントの詳細を入力します。

   1. コラボレーターエージェントの場合、ドロップダウンからコラボレーターエージェントとエージェントのエイリアスを選択します。表示を選択して、共同作業者エージェントの詳細を表示できます。

   2. コラボレーター名には、コラボレーターエージェントの代替名を入力します。この名前は、このエージェントの元の名前を置き換えるものではありません。

   3. コラボレーション手順で、この共同作業者をスーパーバイザーエージェントで使用するタイミングの詳細を入力します。

   4. （オプション) スーパーバイザーエージェントが以前の会話のコンテキストをこの共同作業者エージェントと共有する場合は、会話履歴を有効にするを有効にします。これをオンにすると、スーパーバイザーは、ユーザー入力テキストや会話の各ターンからのスーパーバイザーエージェントの応答など、現在のセッションの完全な履歴を含めます。

2. 共同作業者を追加 を選択して、この共同作業者エージェントをmulti-agent-collaborationチームに追加します。共同作業者エージェントを追加するには、すべての共同作業者エージェントを追加するまでステップ 1 を繰り返します。

3. 共同作業者エージェントの追加が完了したら、次のいずれかのオプションを選択します。

   • マルチエージェントコラボレーションを続けるには、保存を選択して次のステップに進み、マルチエージェントコラボレーションチームを準備してテストします。

   • [エージェントの詳細] ページに戻る場合は、[保存して終了] を選択します。

ステップ 4: マルチエージェントコラボレーションを準備してテストする

• 手順に従って、マルチエージェントコラボレーションチームの準備とテストを行います。

ステップ 5: マルチエージェントコラボレーションをデプロイする

• InvokeAgent リクエストを行うようにスーパーバイザーエージェントを設定して、マルチエージェントコラボレーションをデプロイします。

API

マルチエージェントコラボレーションチームを作成するには、次の手順を実行します。

ステップ 1: 共同作業者エージェントを作成する

• エージェントを作成および設定する手順に従います。必ず各共同作業者エージェントが特定のタスクを実行するように設定します。

ステップ 2: 新しいスーパーバイザーエージェントを作成するか、既存のエージェントにスーパーバイザーロールを割り当てる

• 新しいスーパーバイザーエージェントを作成するには、Amazon Bedrock エージェントのビルドタイムのエンドポイントを使用してCreateAgentリクエストを送信します (リクエストとレスポンスの形式とフィールドの詳細についてはリンクを参照）。

  既存のエージェントにスーパーバイザーロールを割り当てるには、Amazon Bedrock エージェントのビルドタイムエンドポイントを使用して UpdateAgentリクエストを送信します。すべてのフィールドが上書きされるため、更新するフィールドと、変更せずに維持するフィールドの両方を含めます。

  以下のフィールドは最小限含める必要があります。

  フィールド	ユースケース
  agentResourceRoleArn	エージェントで API オペレーションを呼び出すアクセス許可を持つサービスロールの ARN を指定する
  foundationModel	エージェントがオーケストレーションで使用する基盤モデル (FM) を指定する
  instruction	エージェントに何をすべきかの指示を提供する。オーケストレーションプロンプトテンプレートの $instructions$ プレースホルダーで使用されます。
  agentCollaboration	エージェントにスーパーバイザーロールを割り当てるには。 スーパーバイザーエージェントが共同作業者エージェントからのレスポンスを調整し、レスポンスを出力SUPERVISORするかどうかを指定します。 スーパーバイザーエージェントが情報を適切な共同作業者エージェントにルーティングして最終応答を送信するSUPERVISOR_ROUTERかどうかを指定します。 デフォルトでは、このフィールドは に設定されていますDISABLED。

  次のフィールドはオプションです。

  フィールド	ユースケース
  description	エージェントが何をするかの説明
  idleSessionTTLInSeconds	エージェントがセッションを終了して保存された情報を削除するまでの時間。
  customerEncryptionKeyArn	エージェントリソースを暗号化するための KMS キーの ARN
  tags	タグをエージェントに関連付ける。
  promptOverrideConfiguration	オーケストレーションの各ステップで FM に送信されるプロンプトをカスタマイズする。
  guardrailConfiguration	エージェントにガードレールを追加する。使用するガードレールの ID または ARN とバージョンを指定します。
  clientToken	API リクエストが 1 回だけ完了するようにします。詳細については、「べき等性の確保」を参照してください。

  レスポンスは、新しく作成したスーパーバイザーエージェントに関する詳細を含む CreateAgent オブジェクトを返します。エージェントの作成に失敗すると、トラブルシューティング用に、レスポンスの CreateAgent オブジェクトで failureReasons のリストと recommendedActions のリストが返されます。

ステップ 3: 共同作業者エージェントを追加する

• 共同作業者エージェントをスーパーバイザーエージェントに関連付けるには、Amazon Bedrock エージェントのビルドタイムのエンドポイントにAssociateAgentCollaboratorリクエストを送信します (リクエストとレスポンスの形式とフィールドの詳細についてはリンクを参照）。

  以下のフィールドは最小限含める必要があります。

  フィールド	ユースケース
  collaboratorName	共同作業者エージェントの代替名を指定するには。この名前はコラボレーション手順にのみ表示され、元のエージェント名は置き換えられません。
  agentDescriptor	エージェントのエイリアス Arn を指定します。
  collaborationInstruction	共同作業者エージェントに何をすべきかを指示する手順を提供します。
  collaboratorState	この共同作業者エージェントENABLEDをスーパーバイザーエージェントに関連付けるには、 に設定します。
  relayConversationHistory	に設定TO_COLLABORATORして、スーパーバイザーエージェントがこの共同作業者エージェントとの以前の会話のコンテキストを共有するように指定します。 有効な値: TO_COLLABORATOR | DISABLED。

ステップ 4: マルチエージェントコラボレーターチームの準備とテスト

• 手順に従って、マルチエージェントコラボレーションチームを準備してテストします。

ステップ 4: マルチエージェントコラボレーションチームをデプロイする

• InvokeAgent リクエストを行うようにスーパーバイザーエージェントを設定して、マルチエージェントコラボレーションチームをデプロイします。