收集预设反馈

Preset Feedback 可将应用中的评分关联到生成回答的预设。利用真实用户信号比较提示词和路由变更，而非只依赖延迟和成本。

Preset Feedback 目前处于 Alpha 阶段。我们会根据团队评估生产环境 AI 回答的方式持续改进 API 和控制台。请通过 Preset Feedback 页面上的 Feedback 按钮告诉我们如何让它更实用。

开始之前

你需要：

具有 feedback:write 能力的 Phaseo API 密钥
Phaseo 返回的请求 ID
要分析预设的 UUID

记录反馈时请包含预设 ID，这样事件才会显示在预设比较和群组分析中。

记录评分

用户为回答评分后，或应用确定结果后，发送反馈。

cURL

curl https://api.phaseo.app/v1/feedback \
  -X POST \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requestId": "gen_01K...",
    "presetId": "8f54b2d9-9ba3-4ced-8a7f-9bb70a44dbea",
    "rating": "thumbs_up",
    "score": 1,
    "comment": "The answer resolved the customer question.",
    "metadataDimensions": {
      "plan": "pro",
      "surface": "support_chat"
    }
  }'

反馈事件必须至少关联一个请求、会话、预设或测试运行。分数为可选项，范围必须是 0 到 1。

选择评分

选择能描述实际收集到的信号的评分：

简单的用户反馈使用 thumbs_up 或 thumbs_down
已评估回答使用 correct、partly_correct 或 incorrect
运行问题使用 bad_format、too_slow 或 too_expensive
安全结果使用 unsafe 或 refused_incorrectly
其他值不适用时使用 not_helpful 或 other

不要将所有信号都转换成数字分数。明确的评分更便于解释控制台中的比较结果。

比较预设

打开设置 → 预设 → 反馈以：

比较正面、部分正面和负面评分的比例
选择基准预设
按日期、评分和元数据维度筛选
查看事件关联的请求、会话、评论和标签

将套餐、部署、区域设置或应用界面等低基数值添加到 metadataDimensions。任意或高基数上下文应放在 metadata 中。

通过 API 读取反馈

列出最近事件：

curl "https://api.phaseo.app/v1/feedback?preset_id=PRESET_UUID&limit=100" \
  -H "Authorization: Bearer $PHASEO_API_KEY"

请求服务器端汇总：

curl "https://api.phaseo.app/v1/feedback/summary?group_by=preset&since=2026-08-01T00:00:00Z" \
  -H "Authorization: Bearer $PHASEO_API_KEY"

读取操作需要 feedback:read。结果仅限于已认证工作区以及调用者可见的预设。

当前 Alpha 限制

控制台在所选时间范围内最多分析最近 10,000 条匹配的反馈记录。预设比较使用明确评分；数字分数仅作为补充信息显示。测试运行和自定义结果事件 API 已可用，但控制台工作流仍在完善。

概览

模型与路由

功能

集成

工作区与访问

可靠性与运维

平台与研究

迁移指南

社区

开始之前

记录评分

选择评分

比较预设

通过 API 读取反馈

当前 Alpha 限制

相关指南

​开始之前

​记录评分

​选择评分

​比较预设

​通过 API 读取反馈

​当前 Alpha 限制

​相关指南

开始之前

记录评分

选择评分

比较预设

通过 API 读取反馈

当前 Alpha 限制

相关指南