Amazon Bedrock のエージェントにアクショングループを追加する

アクショングループをエージェントに追加するには

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

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

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

4. [アクショングループ] セクションで [追加] を選択します。

5. (オプション) [アクショングループの詳細] セクションで、自動的に生成された [名前] を変更し、アクショングループの [説明] (オプション) を指定します。

6. [アクショングループタイプ] セクションで、エージェントがアクションを実行するためにユーザーから取得するパラメータを定義する方法として、次のいずれかを選択します。

   1. 関数の詳細で定義 – アクションを実行するためにエージェントがユーザーから取得するパラメータを定義します。関数の追加について詳しくは、「Amazon Bedrock エージェントで使用するアクショングループの関数の詳細を定義する」を参照してください。

   2. API スキーマで定義 — エージェントが呼び出すことができるAPIオペレーションとパラメータ を定義します。作成した OpenAPI スキーマを使用するか、コンソールテキストエディタを使用してスキーマを作成します。OpenAPI スキーマの設定の詳細については、「」を参照してください。 定義 OpenAPI Amazon Bedrock でのエージェントのアクショングループのスキーマ

7. アクショングループの呼び出しセクションでは、エージェントが呼び出す必要がある APIまたは 関数を予測し、必要なパラメータを受け取った後に、エージェントが何をするかを設定します。以下のオプションのいずれかを選択します。

   • 新しい Lambda 関数のクイック作成 – 推奨 – Amazon Bedrock がエージェント用の基本的な Lambda 関数を作成し、後でユースケース AWS Lambda に合わせて変更できるようにします。エージェントは、予測する APIまたは 関数と、セッションに基づくパラメータを Lambda 関数に渡します。

   • 既存の Lambda 関数を選択する – で以前に作成した Lambda 関数 AWS Lambda と、使用する関数のバージョンを選択します。エージェントは、予測する APIまたは 関数と、セッションに基づくパラメータを Lambda 関数に渡します。

     注記

     Amazon Bedrock サービスプリンシパルが Lambda 関数にアクセスできるようにするには、Lambda 関数にリソースベースのポリシーをアタッチします。

   • 戻り制御 – エージェントは、予測した APIまたは 関数のパラメータを Lambda 関数に渡すのではなく、セッションから決定したアクションのパラメータと情報に加えて、呼び出される必要があると予測したアクションを渡すことで、アプリケーションに制御を返します。 InvokeAgent レスポンス。詳細については、「InvokeAgent レスポンスで引き出された情報を送信して、エージェントデベロッパーにコントロールを返す」を参照してください。

8. [アクショングループタイプ] の選択に応じて、次のいずれかのセクションが表示されます。

   • [関数の詳細で定義] を選択した場合は、[アクショングループ関数]セクションが表示されます。以下を実行して関数を定義します。

     1. [名前] とオプションの [説明] (記述することを推奨) を入力します。

     2. 関数が呼び出される前にユーザーからの確認をリクエストするには、[有効] を選択します。関数を呼び出す前に確認をリクエストすると、悪意のあるプロンプトインジェクションによるアクションが実行されないようにアプリケーションを保護できる場合があります。

     3. [パラメータ] サブセクションで、[パラメータを追加] を選択します。以下のフィールドを定義します。

        フィールド	説明
        名前	パラメータに名前を付けます。
        Description (オプション)	パラメータの説明を記述します。
        Type	パラメータのデータ型を指定します。
        必須	エージェントでユーザーからのパラメータを必須とするかどうかを指定します。

     4. 別のパラメータを追加するには、[パラメータを追加] を選択します。

     5. パラメータのフィールドを編集するには、フィールドを選択し、必要に応じて編集します。

     6. パラメータを削除するには、パラメータが含まれる行の削除アイコン ( ) を選択します。

     JSON オブジェクトを使用して関数を定義する場合は、テーブルの代わりにJSONエディタを選択します。JSON オブジェクトの形式は次のとおりです ( parameters オブジェクトの各キーは、指定したパラメータ名です）。

     {
         "name": "string",
         "description": "string",
         "parameters": [
             {
                 "name": "string",
                 "description": "string",
                 "required": "True" | "False",
                 "type": "string" | "number" | "integer" | "boolean" | "array"
             }
         ]
     }

     別のパラメータセットを定義してアクショングループに別の関数を追加するには、[アクショングループ関数を追加] を選択します。

   • API スキーマで定義を選択した場合は、以下のオプションを含むアクショングループスキーマセクションがあります。

     • アクショングループAPIの説明、構造、パラメータで以前に準備した OpenAPI スキーマを使用するには、スキーマの選択を選択し、APIスキーマURIの Amazon S3 へのリンクを指定します。

     • インラインスキーマエディタで OpenAPI スキーマを定義するには、インラインスキーマエディタで定義を選択します。編集可能なサンプルスキーマが表示されます。

       1. [フォーマット] の横にあるドロップダウンメニューを使用して、スキーマのフォーマットを選択します。

       2. S3 から既存のスキーマをインポートして編集するには、スキーマのインポートを選択し、S3 を指定してURI、インポートを選択します。

       3. スキーマを元のサンプルスキーマに復元するには、[リセット] を選択し、もう一度 [リセット] を選択して表示されるメッセージを確認します。

9. アクショングループの作成が完了したら、[追加] を選択します。API スキーマを定義した場合、問題がなければ緑色の成功バナーが表示されます。スキーマの検証に問題がある場合は、赤いバナーが表示されます。次のオプションがあります。

   • スキーマをスクロールして、フォーマットに関するエラーまたは警告がある行を確認します。X はフォーマットエラーを示し、感嘆符はフォーマットに関する警告を示します。

   • API スキーマのコンテンツに関するエラーのリストを表示するには、赤色のバナーで詳細の表示を選択します。

10. テストする前に、必ず [準備] を選択してエージェントに加えた変更を適用します。