エージェントのトレースを表示する

始める前に

エージェント トレースを表示するには、次の要件を満たす必要があります。

分散トレースは、アーキテクチャ内のさまざまな分散サービスやコンポーネントを通過する単一のリクエストの進行状況を追跡する診断手法です。生成 AI エージェントは、非決定論的な推論ループを使用してツールと実行パスを動的に選択するため、従来の特定の時点の指標ではデバッグに十分でないことがよくあります。トレースは、これらの予測不可能なインタラクションの完全なシーケンシャル タイムラインを提供するため、エージェントのオブザーバビリティに不可欠です。これにより、エージェントが特定の決定を行った理由を正確に把握できます。

トレースの探索

エージェントの詳細な実行データにアクセスするには:

  1. コンソールで、 Google Cloud Agent Platform > Agent Registry ページに移動します。

    Agent Registry に移動

  2. 特定のエージェントを選択します。

  3. [トレース] タブをクリックします。

このインターフェースでは、エージェントのステップごとの実行の詳細を確認できます。トレース は、モデルの入力、レスポンス、ツール呼び出しなど、エージェントの動作の事実に基づいた不変のレコードです。トレースビューには、スパンの有向非巡回グラフ（DAG）、入力と出力、メタデータ属性が含まれます。

[トレース] タブには、テレメトリー データを探索するための 3 つの異なるビューがあります。

  • セッション ビュー: 個々のユーザー セッションで実行をグループ化し、複数ターンの会話とエージェントの動作を時系列で分析できます。
  • トレースビュー: 単一の実行パスを表す、個々のエンドツーエンドのリクエスト トレースに焦点を当てます。
  • スパンビュー: 特定の基盤モデルの呼び出し、API リクエスト、外部ツールの実行など、トレース内で実行される個々のオペレーション（スパン）の詳細なリストを提供します。

単一トレースビュー（セッション コンテキスト）

[**セッション ビュー**] で特定のセッションを選択すると、[詳細ウィンドウ] が開き、左側のリストパネルに、その複数ターンのセッションに含まれる個々のトレースがすべて表示されます。メインパネルには、セッション全体のコンテキストが集約され、フォーマットされた入力メッセージとアシスタント メッセージが表示されます。また、期間、生成 AI トークンの合計数、継続評価スコアなどのセッション全体の指標も表示されます。

単一トレースビュー（直接トレースまたはスパン コンテキスト）

または、[トレースビュー] で特定のトレースを選択するか、[スパンビュー] で個別のスパンを選択すると、[詳細ウィンドウ] がその特定の実行に直接開きます。グループ化されたセッションではなく単一のオペレーションを表示しているため、左側のリストパネルは非表示になり、そのオペレーションの特定のレイテンシ、属性、潜在的なエラーをすぐに集中的に確認できます。

データ ストレージとアクセス制御

セキュリティとコンプライアンスを維持するため、Gemini Enterprise Agent Platform はオペレーション メタデータを実際の会話コンテンツから分離します。

  • 実行指標と属性: 標準のテレメトリー（レイテンシ、ステータス コード、構造化メタデータなど）は、トレース スパンに直接保存されます。
  • プロンプトとレスポンス: ユーザー プロンプトやモデル レスポンスなど、センシティブ データはスパンに保存されません。代わりに、組織の構成に応じて Cloud Logging または Cloud Storage にルーティングされます。これにより、管理者は機密性の高い会話データに対して Identity and Access Management（IAM）の粒度の細かい制御を実装できます。

Gemini Enterprise Agent Platform UI は、トレース スパンとこれらの安全に保存されたプロンプトとレスポンスのログの間の基盤となる相関関係を自動的に認識します。トレースの詳細ビューを開くと、プラットフォームはこのデータをシームレスに再構成し、データガバナンス ルールを損なうことなく、エージェントの動作の全体像を表示します。

会話データのストレージ宛先を構成する方法については、 Google Cloud Observability のマルチモーダル プロンプト レスポンス ロギングドキュメント をご覧ください。

次のステップ