Amazon Bedrock でエージェントを作成する - Amazon Bedrock

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

Amazon Bedrock でエージェントを作成する

Amazon Bedrock でエージェントを作成するには、以下のコンポーネントを設定します。

  • エージェントの設定。これにより、エージェントの目的が定義され、プロンプトとレスポンスの生成に使用する基盤モデル (FM) が示されます。

  • (オプション) エージェントが実行するように設計されているアクションを定義するアクショングループ。

  • (オプション) データソースのナレッジベース: エージェントの生成機能を強化します。

エージェントはコンソールまたは API で作成できます。選択した方法に対応するタブを選択し、手順に従います。

Console

方法によって異なります。

  1. にサインインし AWS Management Console、https://console.aws.amazon.com/bedrock/ にある Amazon Bedrock コンソールを開きます。

  2. 左側のナビゲーションペインから [エージェント] を選択します。

  3. 「エージェント」セクションで、「エージェントを作成」を選択します。

  4. [作成] を選択します。

  5. 新しく作成したエージェントの Agent Builder が表示され、そこでエージェントを設定できます。

  6. エージェント詳細セクションでは、以下の設定を行うことができます。

    1. 「名前」または「説明」は編集できます。

    2. [モデルの選択] では、[変更] を選択して、オーケストレーション中にエージェントが呼び出す FM を選択します。

    3. 「エージェントへの指示」に、エージェントに何をすべきか、どのようにユーザーとやり取りすべきかを伝えるための詳細を入力します。このインストラクションは、オーケストレーションプロンプトテンプレートの $instructions$ プレースホルダーに代わるものです。手順の例を以下に示します。

      You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.

    4. [その他の設定] を展開すると、以下の設定を変更できます。

      ユーザー入力 — 十分な情報がない場合に、エージェントがユーザーに追加情報を要求できるようにするかどうかを選択します。

      • アイドルセッションタイムアウト — デフォルトでは、Amazon Bedrock エージェントとのセッション中にユーザーが 30 分間応答しなかった場合、エージェントは会話履歴を保持しなくなります。会話履歴は、対話を再開したり、会話のコンテキストでレスポンスを補足するためにも使用されます。このデフォルトの時間を変更するには、「セッションタイムアウト」フィールドに数値を入力し、時間単位を選択します。

    5. エージェント設定の設定が完了したら、[次へ] を選択します。

  7. アクショングループセクションでは、アクショングループをエージェントに追加できます。アクショングループの設定について詳しくは、を参照してくださいAmazon Bedrock エージェントのアクショングループを作成する。アクショングループを追加するには、「作成」または「アクショングループの作成」を選択します。

    1. アクショングループ呼び出しセクションでは、呼び出す API または関数、および渡す必要があるパラメータをエージェントが予測した後の処理を設定します。これを行うには、アクションの呼び出し時に実行されるビジネスロジックを提供する Lambda 関数を定義します。Lambda 関数のオプションを次の中から選択します。

    2. エージェントに別のアクショングループを設定するには、[別のアクショングループを追加] を選択します。アクショングループの追加が完了したら、[次へ] を選択します。

API

エージェントを作成するには、Agents for Amazon Bedrock のビルド時エンドポイントを使用してリクエスト (CreateAgentリクエストとレスポンスの形式とフィールドの詳細についてはリンクを参照) を送信します。

コード例を参照してください。

次のリストは、リクエストのフィールドについて説明しています。

  • 最低限、以下の必須フィールドを入力してください。

    フィールド 簡単な説明
    agentName エージェントの名前。
    agentResourceRoleARN エージェントのサービスロールの ARN
    ファウンデーション/モデル エージェントがオーケストレーションを行うための基盤モデル

  • 以下のフィールドはオプションですが、推奨されます。

    フィールド 簡単な説明
    説明 エージェントが行うことを説明します。
    命令 エージェントに何をすべきかを伝える指示。オーケストレーションプロンプトテンプレートで使用されます。

  • セキュリティ上の理由から、以下のフィールドを指定できます。

    フィールド 簡単な説明
    clientToken API リクエストが 1 回だけ完了することを保証する識別子。
    customerEncryptionKeyアーン エージェントリソースを暗号化するための KMS キーの ARN
    アイドルセッション (TTL) InSeconds エージェントがセッションを終了し、保存されている情報をすべて削除するまでの期間。

  • デフォルトのプロンプトテンプレートをオーバーライドしてエージェントの動作をカスタマイズするには、オブジェクトを含めてください。promptOverrideConfiguration詳細については、「Amazon Bedrock の高度なプロンプト」を参照してください。

  • エージェントにタグを付けるには、Tagsフィールドを使用します。詳細については、「リソースのタグ付け」を参照してください。

エージェントの作成に失敗した場合、CreateAgentfailureReasonsrecommendedActionsレスポンス内のオブジェクトはのリストとトラブルシューティング用のリストを返します。