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

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

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（ADK）エージェントを開発するをご覧ください。
  • 省略可: コンソールでトレース イベントの横にフィードバック エントリを表示するには、Agent Runtime インスタンスでトレースが有効になっていることを確認します。

必要なロールを取得する

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

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

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

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

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

次のステップ