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

始める前に

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

  • API を有効にする:Google Cloud プロジェクトで次の API が有効になっていることを確認します。
    • Cloud Trace API
    • Cloud Logging API
    • Telemetry API
  • エージェントのトレースを構成する: トレースデータを Google Cloudに送信するようにエージェントを構成する必要があります。さまざまなエージェント タイプでトレースを有効にする手順については、トレースを設定するをご覧ください。
  • 権限を構成する: トレースとログを表示するには、Cloud Trace ユーザー（roles/cloudtrace.user）ロールやログ閲覧者（roles/logging.viewer）ロールなど、必要な権限を提供する IAM ロールが必要です。詳細については、Cloud Trace アクセス制御と Cloud Logging アクセス制御をご覧ください。

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

トレースを調べる

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

  1. Google Cloud コンソールで、[エージェント プラットフォーム] > [エージェント レジストリ] ページに移動します。

    Agent Registry に移動

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

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

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

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

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

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

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

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

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

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

セキュリティとコンプライアンスを維持するため、Gemini Enterprise エージェント プラットフォームでは、運用メタデータと実際の会話コンテンツが分離されています。

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

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

会話データの保存先を構成する方法については、マルチモーダル プロンプトとレスポンスを収集して表示するをご覧ください。

次のステップ