アプリケーションのエージェントを作成する - Amazon Bedrock

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

アプリケーションのエージェントを作成する

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

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

  • 次のいずれか。

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

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

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

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

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

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

Console
エージェントを作成するには

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

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

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

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

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

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

エージェントを設定するには

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

    1. にサインインする AWS Management Console IAM Amazon Bedrock のアクセス許可を持つ ロールを使用して、 で Amazon Bedrock コンソールを開きますhttps://console.aws.amazon.com/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リクエストを完了するのに十分な情報がない場合に、詳細についてユーザーに再プロンプトする監視を返します。

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

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