意見回饋服務總覽

您可以透過 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 的外送要求應已具備存取意見回饋服務的權限。

後續步驟