反馈服务概览

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

准备工作

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

获取所需的角色

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

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

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

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

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

后续步骤