本頁說明如何在Google Cloud 控制台中查看收到的使用者意見回饋。
事前準備
如要在 Google Cloud 控制台中查看意見回饋項目,請確認下列事項:
- 您的 Agent Runtime 執行個體已啟用追蹤。
- 代理程式已設為使用 OpenTelemetry (OTel) 產生追蹤記錄範圍,並處理追蹤記錄脈絡傳播。控制台 UI 會使用 OpenTelemetry 產生的時距屬性
gcp.vertex.agent.event_id,將意見回饋項目對應至追蹤記錄。
查看意見回饋
意見回饋服務已整合至Google Cloud 控制台的「追蹤」分頁。在「追蹤記錄」分頁中,您可以在「工作階段檢視」和「追蹤記錄檢視」分頁中,查看及篩選附有意見回饋的追蹤記錄。
如要查看代理程式的意見回饋項目:
- 在 Google Cloud 控制台中,前往「Agent Platform」>「Agents」頁面。
- 選取左側導覽選單中的「Deployments」。
選取代理程式。
清單中會顯示屬於所選專案的 Agent Engine 執行個體。您可以使用「篩選」欄位,依據指定欄位篩選清單。
按一下 Agent Engine 執行個體的名稱。
按一下「追蹤」分頁標籤。使用「工作階段」檢視畫面或「追蹤記錄」檢視畫面,找出含有意見回饋的追蹤記錄:
- 工作階段檢視畫面:
- 依「意見回饋」欄篩選工作階段清單。
- 按一下要查看的階段作業,顯示追蹤清單。
- 選取顯示意見回饋圖示徽章的追蹤記錄 ID。
- 追蹤記錄檢視畫面:
- 按一下「追蹤檢視畫面」分頁標籤。
- 依「意見回饋」欄篩選追蹤記錄清單。
- 選取顯示意見回饋圖示徽章的追蹤記錄 ID。
- 工作階段檢視畫面:
在追蹤記錄詳細資料窗格中,按一下「意見回饋」分頁標籤,即可查看意見回饋詳細資料,例如意見回饋類型、留言、標籤、ID 和建立時間。
使用者介面限制
- 事件 ID 規定:使用者介面僅支援追蹤及對應使用 OpenTelemetry 產生的 UUID (
gcp.vertex.agent.event_id) (從追蹤範圍擷取) 的意見回饋項目。 - 重複提交:如果提交多筆意見回饋,但
session_id和event_id組合相同,控制台使用者介面只會顯示最後收到的意見回饋。
整合 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 |
時距 | 選用。意見回饋標籤清單。 |