エージェントを手動で作成および設定する - Amazon Bedrock

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

エージェントを手動で作成および設定する

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

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

  • 少なくとも次のいずれか。

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

    • 検索とクエリを許可することでエージェントの生成機能を強化するためのデータソースのナレッジベース。

名前のみを持つエージェントは、最小限作成できます。エージェントをテストまたはデプロイできるように準備するには、次のコンポーネントを最低限設定する必要があります。

構成 説明
エージェントリソースロール エージェントでAPIオペレーションを呼び出すアクセス許可を持つサービスロールARNの 。
基盤モデル (FM) オーケストレーションを実行するためにエージェントが呼び出す FM
手順 エージェントが何をすべきか、ユーザーとやり取りする方法を説明する自然言語

また、エージェントのアクショングループまたはナレッジベースを少なくとも 1 つ設定する必要があります。アクショングループやナレッジベースがないエージェントを準備すると、FM と手順、およびベースプロンプトテンプレート のみに基づいてレスポンスが返されます。

エージェントを作成する方法については、選択した方法に対応するタブを選択し、ステップに従います。

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

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

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

  4. (オプション) エージェントに対して自動的に生成された名前を変更し、オプションの説明を指定します。

  5. [Create] (作成) を選択します。エージェントが作成され、新しく作成されたエージェントの Agent Builder に移動し、エージェントを設定できます。

  6. エージェントを設定するか、後で Agent Builder に戻るには、次の手順に進んでください。

エージェントを設定するには
  1. エージェントビルダーにまだいない場合は、次の操作を行います。

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

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

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

  2. エージェントの詳細セクションでは、次の設定を設定できます。

    1. エージェント名またはエージェントの説明 を編集します。

    2. エージェントリソースロール で、次のいずれかのオプションを選択します。

      • 新しいサービスロールを作成して使用する – Amazon Bedrock にサービスロールを作成して、ユーザーに代わって必要なアクセス許可を設定させます。

      • 既存のサービスロールを使用する – 以前に設定したカスタムロールを使用します。

    3. Select モデル では、オーケストレーション中にエージェントが呼び出す FM を選択します。

    4. エージェント の手順に詳細を入力して、エージェントに何をすべきか、ユーザーとやり取りする方法を伝えます。手順は、オーケストレーションプロンプトテンプレート の $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.
    5. 追加設定 を展開すると、次の設定を変更できます。

      • Code Interpreter – (オプション) コードの書き込み、実行、テスト、トラブルシューティングを含むタスクをエージェントが処理できるようにするかどうかを選択します。詳細については、「コード解釈によるコードの生成、実行、テスト」を参照してください。

      • ユーザー入力 - (オプション) 十分な情報がない場合、エージェントにユーザーからの追加情報のリクエストを許可するかどうかを選択します。詳細については、「ユーザーから情報をリクエストするようにエージェントを設定する」を参照してください。

      • KMS キー選択 – (オプション) デフォルトでは、 はエージェントリソースを AWS マネージドキーでAWS暗号化します。独自のカスタマーマネージドキーでエージェントを暗号化するには、KMSキー選択セクションで暗号化設定をカスタマイズ (アドバンスド) を選択します。新しいキーを作成するには、AWSKMSキーの作成を選択してから、このウィンドウを更新します。既存のキーを使用するには、 キーを選択 のAWSKMSキーを選択します

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

    6. アクセスIAM許可セクションでは、エージェントリソースロール でサービスロール を選択します。Amazon Bedrock がユーザーに代わってサービスロールを作成できるようにするには、「作成」を選択し、新しいサービスロールを使用します。以前に作成したカスタムロールを使用するには、「既存のサービスロールを使用する」を選択します。

      注記

      Amazon Bedrock が作成するサービスロールには、プレビュー中の機能に対するアクセス許可は含まれません。これらの機能を使用するには、サービスロール に正しいアクセス許可をアタッチします

    7. (オプション) デフォルトでは、 はエージェントリソースを で AWS 暗号化します AWS マネージドキー。独自のカスタマーマネージドキーでエージェントを暗号化するには、KMSキー選択セクションで暗号化設定をカスタマイズ (アドバンスド) を選択します。新しいキーを作成するには、 AWS KMS キーの作成を選択してから、このウィンドウを更新します。既存のキーを使用するには、 キーを選択 の AWS KMS キーを選択します

    8. (オプション) タグをこのエージェントに関連付けるには、タグ – オプションセクションで、新しいタグを追加を選択し、キーと値のペアを指定します。

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

  3. アクショングループ セクションで、追加を選択してアクショングループをエージェントに追加できます。アクショングループの設定の詳細については、「」を参照してくださいアクショングループを使用して、エージェントが実行するアクションを定義する。エージェントにアクショングループを追加する方法については、「」を参照してくださいAmazon Bedrock でエージェントにアクショングループを追加する

  4. ナレッジベースセクションで、追加を選択してナレッジグループをエージェントに関連付けることができます。ナレッジベースの設定の詳細については、「」を参照してくださいナレッジベースを使用してデータを取得し、AI レスポンスを生成する。ナレッジベースをエージェントに関連付ける方法については、「」を参照してくださいナレッジベースを使用してエージェントのレスポンス生成を拡張する

  5. ガードレールの詳細セクションで、編集を選択してガードレールをエージェントに関連付けると、有害なコンテンツをブロックおよびフィルタリングできます。使用するガードレールを、ガードレールの選択のドロップダウンメニューから選択し、Guardrail バージョン で使用するバージョンを選択します。表示を選択して、ガードレール設定を表示できます。詳細については、「Amazon Bedrock ガードレールを使用してモデル内の有害なコンテンツを停止する」を参照してください。

  6. 詳細プロンプトセクションで、編集を選択して、オーケストレーションの各ステップでエージェントによって FM に送信されるプロンプトをカスタマイズできます。カスタマイズに使用できるプロンプトテンプレートの詳細については、「」を参照してくださいAmazon Bedrock の高度なプロンプトテンプレートを使用してエージェントの精度を向上させる。高度なプロンプトを設定する方法については、「」を参照してください

  7. エージェントの設定が完了したら、次のいずれかのオプションを選択します。

    • エージェントビルダー にとどまるには、保存 を選択します。その後、エージェントを準備して、テストウィンドウで更新された設定でテストできます。エージェントをテストする方法については、「」を参照してくださいエージェント動作のテストとトラブルシューティング

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

API

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

コード例を参照

エージェントを準備し、テストまたはデプロイしてテストまたはデプロイできるようにするには、以下のフィールドを最低限含める必要があります (必要に応じて、これらの設定をスキップして後で設定するには、 UpdateAgent リクエスト):

フィールド ユースケース
agentResourceRoleArn エージェントで APIオペレーションを呼び出すアクセス許可を持つサービスロールARNの を指定するには
foundationModel エージェントが とオーケストレーションするための基盤モデル (FM) を指定するには
命令 エージェントに何をすべきかを指示する手順を提供します。オーケストレーションプロンプトテンプレートの $instructions$ プレースホルダーで使用されます。

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

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

レスポンスは を返します。 CreateAgent 新しく作成したエージェントに関する詳細を含む オブジェクト。エージェントの作成に失敗した場合、 CreateAgent レスポンスの オブジェクトは、トラブルシューティングrecommendedActionsのために のリストfailureReasonsと のリストを返します。