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

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

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

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

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

  • 次のいずれか。

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

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

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

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

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

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

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

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

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

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

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

  6. 次の手順に進んでエージェントを設定するか、後で エージェントビルダーに戻ります。

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

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

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

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

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

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

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

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

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

    3. モデルを選択 で、オーケストレーション中にエージェントが呼び出す 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. 追加設定 を展開すると、次の設定を変更できます。

      ユーザー入力 – 十分な情報がない場合に、エージェントにユーザーへの詳細情報のリクエストを許可するかどうかを選択します。

      • 有効化 を選択すると、エージェントはアクショングループで API を呼び出す必要があるが、API リクエストを完了するのに十分な情報がない場合に、詳細についてユーザーに再プロンプトする監視を返します。

      • Disabled を選択した場合、エージェントはユーザーに追加の詳細を要求せず、代わりにタスクを完了するのに十分な情報がないことをユーザーに通知します。

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

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

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

      注記

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

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

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

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

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

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

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

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

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

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

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

API

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

コード例を参照

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

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

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

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

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