意見回饋服務總覽

Gemini Enterprise Agent Platform 的意見回饋服務可讓您收集及分析使用者與代理互動後的意見回饋。這項服務提供必要的基礎架構，您不必自行維護意見回饋資料庫。這項服務會儲存使用者回應，並連結至對應的對話事件時間軸。

您可以直接與 Feedback Service 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向意見回饋服務提出要求，請確認服務帳戶具備必要權限。使用者自行管理的服務帳戶必須具備 Agent Platform 使用者 (aiplatform.user) 權限，才能與意見回饋服務互動。

Reasoning Engine 服務代理已具備管理意見回饋的必要權限，因此 Agent Runtime 的傳出要求應已具備存取意見回饋服務的權限。

後續步驟