エージェントのアクショングループを管理する - Amazon Bedrock
アクショングループに関する情報を表示するアクショングループを編集するアクショングループを削除する

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

エージェントのアクショングループを管理する

アクショングループを作成したら、そのアクショングループを表示、編集、または削除できます。変更は、エージェントの作業中のドラフトバージョンに適用されます。

アクショングループに関する情報を表示する

アクショングループに関する情報を表示する方法については、選択した方法に対応するタブを選択し、ステップに従います。

Console
アクショングループに関する情報を表示するには

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

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

  3. [エージェント] セクションでエージェントを選択します。

  4. エージェントの詳細ページの「ドラフトの作成」セクションで、作業ドラフトを選択します。

  5. アクショングループ セクションで、情報を表示するアクショングループを選択します。

API

アクショングループに関する情報を取得するには、 Agents for Amazon Bedrock ビルドタイムエンドポイントを使用してGetAgentActionGroupリクエストを送信し (リクエストとレスポンスの形式とフィールドの詳細のリンクを参照）actionGroupId、、agentId、および を指定しますagentVersion。

エージェントのアクショングループに関する情報を一覧表示するには、Agents for Amazon Bedrock ビルドタイムエンドポイント を使用してListAgentActionGroupsリクエストを送信します (リクエストとレスポンスの形式とフィールドの詳細のリンクを参照）。アクショングループを表示する agentVersion agentIdと を指定します。以下のオプションのパラメータを含めることができます。

フィールド 簡単な説明
maxResults レスポンスとして返す結果の最大数。
nextToken maxResults フィールドで指定した数よりも多くの結果がある場合、レスポンスはnextToken値を返します。結果の次のバッチを表示するには、別のリクエストでnextToken値を送信します。

コード例を参照

アクショングループを編集する

アクショングループを編集する方法については、選択した方法に対応するタブを選択し、ステップに従います。

Console
アクショングループを編集するには

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

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

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

  4. アクショングループ セクションで、編集するアクショングループを選択します。次に、[編集] を選択します。

  5. 必要に応じて既存のフィールドを編集します。詳細については、「Amazon Bedrock エージェントのアクショングループを作成する」を参照してください。

  6. インラインスキーマエディタを使用してアクショングループのOpenAPIスキーマを定義するには、API スキーマ を選択 で、インラインOpenAPIスキーマエディタ で定義 を選択します。編集可能なサンプルスキーマが表示されます。次のオプションを設定できます。

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

    • スキーマを元のサンプルスキーマに復元するには、リセットを選択し、確認 を選択して表示されるメッセージを確認します。

    • スキーマに別の形式を選択するには、JSON というラベルのドロップダウンメニューを使用します。

    • スキーマの外観を変更するには、スキーマの下にある歯車アイコンを選択します。

  7. エージェントがアクショングループを使用できるかどうかを制御するには、 の有効化または無効化を選択します。この関数を使用して、エージェントの動作のトラブルシューティングを行います。

  8. 変更をテストできるように同じウィンドウにとどまるには、保存 を選択します。アクショングループの詳細ページに戻るには、保存を選択して を終了します。

  9. 問題がなければ、成功バナーが表示されます。スキーマの検証に問題がある場合は、エラーバナーが表示されます。エラーのリストを表示するには、バナーで詳細を表示を選択します。

  10. テストする前にエージェントに加えた変更を適用するには、テストウィンドウまたは作業ドラフトページの上部にある準備を選択します。

API

アクショングループを編集するには、 Agents for Amazon Bedrock のビルドタイムエンドポイント を使用して、 UpdateAgentActionGroup リクエストを送信します (リクエストとレスポンスの形式とフィールドの詳細のリンクを参照）。すべてのフィールドが上書きされるため、更新するフィールドと、同じままにするフィールドの両方を含めます。を agentVersionとして指定する必要がありますDRAFT。必須フィールドとオプションフィールドの詳細については、「」を参照してくださいAmazon Bedrock エージェントのアクショングループを作成する。

作業中のドラフトに変更を適用するには、 Agents for Amazon Bedrock のビルドタイムエンドポイント を使用してPrepareAgentリクエストを送信します (リクエストとレスポンスの形式とフィールドの詳細についてはリンクを参照）。リクエストagentIdに を含めます。変更は、TSTALIASIDエイリアスが指すDRAFTバージョンに適用されます。

アクショングループを削除する

アクショングループを削除する方法については、選択した方法に対応するタブを選択し、ステップに従います。

Console
アクショングループを削除するには

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

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

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

  4. アクショングループ セクションで、削除するアクショングループの横にあるオプションボタンを選択します。

  5. 削除の結果について警告するダイアログボックスが表示されます。アクショングループを削除することを確認するには、入力フィールドに と入力し、delete「削除」を選択します。

  6. 削除が完了すると、成功バナーが表示されます。

  7. テストする前にエージェントに加えた変更を適用するには、テストウィンドウまたは作業ドラフトページの上部にある準備を選択します。

API

アクショングループを削除するには、 DeleteAgentActionGroup リクエストを送信します。削除agentVersion元の actionGroupIdと agentIdおよび を指定します。デフォルトでは、 skipResourceInUseCheckパラメータは falseで、リソースが使用中の場合、削除は停止します。skipResourceInUseCheck を に設定するとtrue、リソースが使用中であってもリソースは削除されます。

作業中のドラフトに変更を適用するには、 Agents for Amazon Bedrock のビルドタイムエンドポイント を使用してPrepareAgentリクエストを送信します (リクエストとレスポンスの形式とフィールドの詳細についてはリンクを参照）。リクエストagentIdに を含めます。変更は、TSTALIASIDエイリアスが指すDRAFTバージョンに適用されます。