反馈服务概览

借助 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

准备工作

如需使用 Feedback 服务，请确保您具备以下条件：

获取所需的角色

如需获得使用 Feedback 服务所需的权限，请让您的管理员为您授予项目的以下 IAM 角色：

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义 角色或其他预定义 角色来获取所需的权限。

如果您要从 Google Cloud向 Feedback 服务发出请求，请 确保您的服务帐号具有必要的权限。用户管理 的服务账号必须具有 Agent Platform User (aiplatform.user) 权限才能与 Feedback 服务互动。

The Reasoning Engine Service Agent 已经拥有管理 反馈所需的权限，因此来自 Agent Runtime 的出站请求应该已经拥有访问 Feedback 服务的 权限。

后续步骤