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 関数にアタッチして、Amazon Bedrock サービスプリンシパルが Lambda 関数にアクセスできるようにします。

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

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

   • 関数の詳細 で定義を選択した場合は、アクショングループ関数セクションがあります。関数を定義するには、以下を実行します。

     1. 名前とオプション (推奨) の説明 を指定します。

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

     3. Parameters サブセクションで、Add parameter を選択します。以下のフィールドを定義します。

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

     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. テストする前に、エージェントに加えた変更を適用する準備をしてください。