在 Google Cloud 控制台中查看反馈

本页面介绍了如何在Google Cloud 控制台中查看收到的最终用户反馈。

准备工作

如需在 Google Cloud 控制台中查看反馈条目，请确保满足以下条件：

  • 您的 Agent Runtime 实例已启用跟踪。
  • 您的代理已配置为使用 OpenTelemetry (OTel) 生成跟踪记录 span 并处理跟踪记录上下文传播。控制台界面使用 OpenTelemetry 生成的 span 属性 gcp.vertex.agent.event_id 将反馈条目映射到轨迹。

查看反馈

反馈服务已与Google Cloud 控制台中的轨迹标签页集成。在轨迹标签页中，您可以在会话视图和轨迹视图标签页中查看和过滤附有反馈的轨迹。

如需查看代理的反馈条目，请执行以下操作：

  1. 在 Google Cloud 控制台中，前往 Agent Platform > 智能体页面。
  2. 在左侧导航菜单中，选择部署。

  3. 选择您的代理。

    转到部署

    属于所选项目的 Agent Engine 实例会显示在列表中。您可以使用过滤字段按指定列过滤列表。

  4. 点击 Agent Engine 实例的名称。

  5. 点击轨迹标签页。使用会话视图或轨迹视图查找包含反馈的轨迹：

    • “会话”视图：
      1. 按反馈列过滤会话列表。
      2. 点击要查看的会话，以显示其轨迹列表。
      3. 选择显示反馈图标标记的轨迹 ID。
    • “轨迹”视图：
      1. 点击轨迹视图标签页。
      2. 按反馈列过滤轨迹列表。
      3. 选择显示反馈图标标记的轨迹 ID。

  6. 在轨迹详情窗格中，点击反馈标签页，查看反馈详情，例如反馈类型、评论、标签、ID 和创建时间。

界面限制

  • 事件 ID 要求：界面仅支持跟踪和映射使用从轨迹 span 中提取的 OpenTelemetry 生成的 UUID (gcp.vertex.agent.event_id) 的反馈条目。
  • 重复提交：如果提交的多个反馈条目具有相同的 session_id 和 event_id 组合，控制台界面只会显示最后收到的反馈条目。

Cloud Trace 集成

当用户提交反馈时，反馈服务会将遥测跨度导出到 Cloud Trace。如需查找用户反馈以及推理引擎执行事件，请按属性搜索和过滤这些导出的 span。如需详细了解如何查找和查看这些轨迹，请参阅设置跟踪指南。

由于轨迹是不可变的，因此删除或更新反馈条目不会影响之前导出的轨迹。

每个反馈遥测轨迹都包含一个名为 gcp.vertex.agent.feedback 的 span，其中包含以下资源和 span 属性：

属性 属性类型 说明
gcp.project_id 资源 Google Cloud 控制台项目的项目 ID。
cloud.resource.id 资源 推理引擎实例的 ID。
gcp.vertex.agent.feedback.type span 反馈类型（THUMBS_UP、THUMBS_DOWN 或 FEEDBACK_TYPE_UNSPECIFIED）。
gen_ai.conversation_id span 与互动关联的会话 ID。
gcp.vertex.agent.event_id span 与特定对话轮次关联的事件 ID。
gcp.vertex.agent.feedback.entry.name span 已创建的反馈条目的资源路径。
gcp.vertex.agent.feedback.labels span 可选。反馈标签列表。

后续步骤