エージェント動作のテストとトラブルシューティング - Amazon Bedrock

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

エージェント動作のテストとトラブルシューティング

エージェントを作成すると、作業中のドラフト が表示されます。作業中のドラフトは、エージェントを反復的に構築するために使用できるエージェントのバージョンです。エージェントを変更するたびに、作業ドラフトが更新されます。エージェントの設定に満足したら、エージェントのスナップショットであるバージョン と、バージョンを指すエイリアス を作成できます。その後、エイリアスを呼び出すことで、エージェントをアプリケーションにデプロイできます。詳細については、「Amazon Bedrock エージェントをアプリケーションにデプロイして統合する」を参照してください。

次のリストは、エージェントのテスト方法を示しています。

  • Amazon Bedrock コンソールで、 側のテストウィンドウを開き、エージェントが応答するための入力を送信します。作業ドラフトまたは作成したバージョンを選択できます。

  • ではAPI、作業ドラフトは DRAFTバージョンです。を使用してエージェントに入力を送信します。 InvokeAgent テストエイリアス、TSTALIASID、または静的バージョンを指す別のエイリアス。

エージェントの動作のトラブルシューティングに役立つように、Amazon Bedrock Agents はエージェントとのセッション中にトレースを表示する機能を提供します。トレースには、エージェントの step-by-step推論プロセスが表示されます。トレースの詳細については、「」を参照してくださいトレースを使用してエージェントの推論プロセスを追跡する step-by-step 。

エージェントをテストするステップを次に示します。選択した方法に対応するタブを選択し、ステップに従います。

Console
エージェントをテストするには

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

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

  3. エージェントセクションで、エージェントのリストからテストするエージェントのリンクを選択します。

  4. 右側のペインにテストウィンドウが表示されます。

    注記

    テストウィンドウが閉じている場合は、エージェントの詳細ページの上部にあるテスト、またはその中の任意のページを選択して、再度開くことができます。

  5. エージェントを作成したら、次のいずれかの方法で準備して、作業中のドラフト変更をパッケージ化する必要があります。

    • テストウィンドウで、 の準備 を選択します。

    • 作業ドラフトページで、ページの上部にある準備を選択します。

    注記

    作業ドラフトを更新するたびに、エージェントに最新の変更をパッケージ化するようにエージェントを準備する必要があります。ベストプラクティスとして、Working draft ページの Agent 概要セクションで、エージェントの最後の準備時間を常に確認し、最新の設定でエージェントをテストしていることを確認することをお勧めします。

  6. テストするエイリアスと関連するバージョンを選択するには、テストウィンドウ の上部にあるドロップダウンメニューを使用します。デフォルトでは、TestAlias: 作業ドラフトの組み合わせが選択されます。

  7. （オプション) エイリアスのプロビジョンドスループットを選択するには、選択したテストエイリアスの下のテキストに PT の使用 ODT または の使用 と表示されます。プロビジョンドスループットモデルを作成するには、「変更」を選択します。詳細については、「Amazon Bedrock のプロビジョンドスループットでモデル呼び出し容量を増やす」を参照してください。

  8. エージェントをテストするには、メッセージを入力し、実行 を選択します。レスポンスの生成を待つ間、または生成後に、次のオプションがあります。

    • プロンプト、推論設定、各ステップのエージェントの推論プロセス、アクショングループとナレッジベースの使用など、エージェントのオーケストレーションプロセスの各ステップの詳細を表示するには、トレースを表示 を選択します。トレースはリアルタイムで更新されるため、レスポンスが返される前にトレースを表示できます。ステップのトレースを展開または折りたたむには、ステップの横にある矢印を選択します。トレースウィンドウと表示される詳細については、「」を参照してくださいトレースを使用してエージェントの推論プロセスを追跡する step-by-step 。

    • エージェントがナレッジベースを呼び出す場合、レスポンスには脚注が含まれます。レスポンスの特定部分の引用情報を含む S3 オブジェクトへのリンクを表示するには、関連する脚注を選択します。

    • Lambda 関数を使用してアクショングループを処理するのではなく、エージェントにコントロールを返すように設定した場合、レスポンスには予測アクションとそのパラメータが含まれます。アクションの APIまたは 関数からの出力値の例を指定し、送信を選択してエージェントレスポンスを生成します。例については、次の画像を参照してください。

      アクションの出力例を提供するテストウィンドウリクエスト。

    テストウィンドウで次のアクションを実行できます。

    • エージェントと新しい会話を開始するには、更新アイコンを選択します。

    • トレースウィンドウを表示するには、展開アイコンを選択します。トレースウィンドウを閉じるには、縮小アイコンを選択します。

    • テストウィンドウを閉じるには、右矢印アイコンを選択します。

アクショングループとナレッジベースを有効または無効にできます。この機能を使用して、異なる設定で動作を評価することで、どのアクショングループまたはナレッジベースを更新する必要があるかを特定することで、エージェントのトラブルシューティングを行います。

アクショングループまたはナレッジベースを有効にするには

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

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

  3. エージェントセクションで、エージェントのリストからテストするエージェントのリンクを選択します。

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

  5. アクショングループまたはナレッジベースセクションで、状態を変更するアクショングループまたはナレッジベースの状態にカーソルを合わせます。

  6. [編集] ボタンが表示されます。編集アイコンを選択し、ドロップダウンメニューからアクショングループまたはナレッジベースが を有効または無効にするかどうかを選択します。

  7. アクショングループが Disabled の場合、エージェントはアクショングループを使用しません。ナレッジベースが Disabled の場合、エージェントはナレッジベースを使用しません。アクショングループまたはナレッジベースを有効または無効にしてから、テストウィンドウを使用してエージェントのトラブルシューティングを行います。

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

API

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

コード例を参照

注記

作業ドラフトを更新するたびに、エージェントに最新の変更をパッケージ化するようにエージェントを準備する必要があります。ベストプラクティスとして、 GetAgent Agents for Amazon Bedrock ビルドタイムエンドポイントでリクエスト (リクエストとレスポンスの形式とフィールドの詳細についてはリンクを参照) を行い、エージェントが最新の設定でエージェントをテストしていることを確認するpreparedAt時間を確認します。

エージェントをテストするには、 InvokeAgent Agents for Amazon Bedrock ランタイムエンドポイント を使用した リクエスト (リクエストとレスポンスの形式とフィールドの詳細についてはリンクを参照）。

注記

AWS CLI は をサポートしていません InvokeAgent.

コード例を参照

リクエストには次のフィールドがあります。

  • 最低限、次の必須フィールドを指定します。

    フィールド 簡単な説明
    agentId エージェントの ID
    agentAliasId エイリアスの ID。TSTALIASID を使用してDRAFTバージョンを呼び出す
    sessionId セッションの英数字 ID (2～100 文字）
    inputText エージェントに送信するユーザープロンプト

  • 次のフィールドはオプションです。

    フィールド 簡単な説明
    enableTrace TRUE トレースを表示するには、 を指定します。
    endSession このリクエスト後にエージェントとのセッションを終了するTRUEには、 を指定します。
    sessionState エージェントの動作またはエージェントにアタッチされたナレッジベースの動作に影響を与えるコンテキストが含まれます。詳細については、「エージェントセッションコンテキストを制御する」を参照してください。

レスポンスはイベントストリームで返されます。各イベントにはchunk、 bytesフィールド内のレスポンスの一部を含む が含まれています。この一部はデコードする必要があります。エージェントがナレッジベースをクエリした場合、 には chunkも含まれますcitations。次のオブジェクトが返される場合もあります。