Google Cloud コンソールでフィードバックを表示する

このページでは、Google Cloud コンソールで受信したエンドユーザーのフィードバックを表示する方法について説明します。

始める前に

Google Cloud コンソールでフィードバック エントリを表示するには、次のことを確認してください。

  • Agent Runtime インスタンスでトレースが有効になっている。
  • エージェントは、OpenTelemetry（OTel）を使用してトレース スパンを生成し、トレース コンテキストの伝播を処理するように構成されています。コンソール UI は、OpenTelemetry で生成されたスパン属性 gcp.vertex.agent.event_id を使用して、フィードバック エントリをトレースにマッピングします。

フィードバックを表示

フィードバック サービスは、Google Cloud コンソールの [トレース] タブと統合されています。[トレース] タブでは、[セッション ビュー] タブと [トレース ビュー] タブの両方で、フィードバックが添付されたトレースを表示してフィルタできます。

エージェントのフィードバック エントリを表示するには:

  1. Google Cloud コンソールで、[Agent Platform] > [エージェント] ページに移動します。
  2. 左側のナビゲーション メニューで、[デプロイ] を選択します。

  3. エージェントを選択します。

    [デプロイメント] に移動

    選択したプロジェクトの一部である Agent Engine インスタンスがリストに表示されます。[フィルタ] フィールドを使用して、指定した列でリストをフィルタできます。

  4. Agent Engine インスタンスの名前をクリックします。

  5. [トレース] タブをクリックします。セッション ビューまたはトレース ビューを使用して、フィードバック付きのトレースを見つけます。

    • セッション ビュー:
      1. [フィードバック] 列でセッションのリストをフィルタします。
      2. 表示するセッションをクリックして、トレースのリストを表示します。
      3. フィードバック アイコン バッジが表示されているトレース ID を選択します。
    • トレースビュー:
      1. [トレースビュー] タブをクリックします。
      2. [フィードバック] 列でトレースリストをフィルタします。
      3. フィードバック アイコン バッジが表示されているトレース ID を選択します。

  6. トレースの詳細ペインで [フィードバック] タブをクリックして、フィードバックのタイプ、コメント、ラベル、ID、作成時間などのフィードバックの詳細を表示します。

UI の制限事項

  • イベント ID の要件: UI は、トレース スパンから取得した OpenTelemetry 生成の UUID（gcp.vertex.agent.event_id）を使用するフィードバック エントリのトラッキングとマッピングのみをサポートします。
  • 重複する送信: 同じ session_id と event_id の組み合わせで複数のフィードバック エントリが送信された場合、コンソール UI には最後に受信したフィードバック エントリのみが表示されます。

Cloud Trace の統合

ユーザーがフィードバックを送信すると、フィードバック サービスはテレメトリー スパンを Cloud Trace にエクスポートします。推論エンジン実行イベントとともにユーザー フィードバックを見つけるには、エクスポートされたスパンを属性で検索してフィルタします。これらのトレースを検索して表示する方法については、トレースを設定するガイドをご覧ください。

トレースは不変であるため、フィードバック エントリを削除または更新しても、以前にエクスポートされたトレースには影響しません。

各フィードバック テレメトリー トレースには、次のリソース属性とスパン属性を持つ gcp.vertex.agent.feedback という名前のスパンが含まれています。

属性 属性タイプ 説明
gcp.project_id リソース Google Cloud コンソール プロジェクトのプロジェクト ID。
cloud.resource.id リソース 推論エンジン インスタンスの ID。
gcp.vertex.agent.feedback.type スパン フィードバックのタイプ（THUMBS_UP、THUMBS_DOWN、FEEDBACK_TYPE_UNSPECIFIED）。
gen_ai.conversation_id スパン インタラクションに関連付けられたセッション ID。
gcp.vertex.agent.event_id スパン 特定の会話ターンに関連付けられたイベント ID。
gcp.vertex.agent.feedback.entry.name スパン 作成されたフィードバック エントリのリソースパス。
gcp.vertex.agent.feedback.labels スパン 省略可。フィードバック ラベルのリスト。

次のステップ