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

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

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

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

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

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

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

    注記

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

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

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

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

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

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

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

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

    1. Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM ID 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 共同作業者エージェントに何をすべきかを指示する手順を提供します。
    relayConversationHistory

    に設定TO_COLLABORATORして、スーパーバイザーエージェントがこの共同作業者エージェントとの以前の会話のコンテキストを共有するように指定します。

    有効な値: TO_COLLABORATOR | DISABLED。
ステップ 4: マルチエージェントコラボレーターチームの準備とテスト

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

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

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