フィードバック サービスの概要

Agent Platform Feedback サービスを使用すると、エージェントとのやり取りからユーザー フィードバックを収集して分析できます。必要なインフラストラクチャが提供されるため、独自のフィードバック データベースを維持する必要がなくなります。サービスはユーザーのリアクションを保存し、対応する会話イベントのタイムラインにリンクします。

フィードバック サービス API と直接統合するか、SDK を使用して、エンドユーザーからエージェントのフィードバックの収集を開始できます。API と SDK を使用すると、標準の CRUDL（作成、取得、更新、削除、一覧表示）オペレーションを使用してフィードバック エントリを管理し、FeedbackContext リソースを介して追加の会話の詳細をフィードバック エントリに関連付けることができます。

詳細については、Python SDK または REST API を使用してフィードバックを管理するまたはコンソールでフィードバックを表示するをご覧ください。

基本コンセプト

  • フィードバック エントリ: エンドユーザーから提供された個別の定性データをトラッキングします。各エントリには、バイナリの感情、特定のフィードバック ラベル、任意の自由形式のテキストが記録されます。
  • フィードバック タイプ: エンドユーザーからのバイナリ感情。 thumbs_up と thumbs_down で表されます。
  • セッション ID（session_id）とイベント ID（event_id）: フィードバックを特定の会話のターンまたはイベントに接続するために必要なフィールド。
  • フィードバック コンテキスト: フィードバック エントリに添付されるオプションのリソース。元のセッションが削除されてもコンテキストが保持されるように、文字起こしや会話ログを保存します。このリソースには、含める内容に応じて、会話全体またはユーザーが選択したメッセージを保存できます。
  • フィードバック ラベル: 運用上の問題や成功した結果の性質を指定する分類。
    • 肯定的なフィードバック ラベル（通常は thumbs_up とともに使用）には、次のものがあります。
      • accurate
      • complete
      • helpful
      • on_topic
      • fast
      • safe
      • factual
      • tool_success
    • 否定的なフィードバック ラベル（通常は thumbs_down とともに使用）には、次のものがあります。
      • inaccurate
      • incomplete
      • unhelpful
      • off_topic
      • too_slow
      • unsafe
      • hallucination
      • tool_error

始める前に

フィードバック サービスを使用するには、次のものが必要です。

  • 既存の Agent Runtime インスタンス。詳しくは、Agent Development Kit エージェントを開発するをご覧ください。
  • 省略可: コンソールでトレースイベントの横にフィードバック エントリを表示するには、Agent Runtime インスタンスでトレースが有効になっていることを確認します。

必要なロールを取得する

フィードバック サービスの使用に必要な権限を取得するには、プロジェクトに対する次の IAM ロールを付与するよう管理者に依頼してください。

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

Google Cloudからフィードバック サービスにリクエストを送信する場合は、サービス アカウントに必要な権限が付与されていることを確認してください。ユーザー管理のサービス アカウントには、フィードバック サービスとやり取りするための Agent Platform ユーザー（aiplatform.user）権限が必要です。

Reasoning Engine サービス エージェントには、フィードバックを管理するために必要な権限がすでに付与されているため、Agent Runtime からのアウトバウンド リクエストには、Feedback サービスにアクセスする権限がすでに付与されているはずです。

次のステップ