选型指南 架构设计 含可复制代码

把用户反馈做成闭环:收集、分类、归因、回归

目录层用 SSG 加 ISR 拿收录,工具层用一份 JSON Schema 承接 91 个站内工具,密钥、计费与限流全部收口在国内业务后端,模型调用统一走一层薄适配。这篇把我们真实的目录结构、Schema 字段定义、路由闸门、预扣结算伪代码和合规清单完整摊开。

陈
陈默架构组
2026-09-28 · 14 分钟阅读 · 8,432 次浏览

归因顺序决定修复成本:从最便宜的那层往下查。

反馈不是"收集起来看看"

上线后用户会点踩、会改写、会放弃。这些信号极其宝贵(它们标出了系统的真实短板),

但如果只堆在日志里,等于没有。要做成闭环:收集 → 分类 → 归因 → 修复 → 回归。

一、收集:把反馈接到具体请求

· 每条反馈必须带上请求 id(否则无法定位当时的输入、模型版本、检索结果);

· 记录反馈类型:点踩 / 改写 / 放弃 / 转人工;

· 记录上下文(用了哪个入口、第几轮、是否走了降级);

· 给用户一个可选的文字说明入口(哪怕一句话,价值很高)。

二、分类:把反馈变成失败类型

原始反馈是杂乱的,要归到有限几类(数量控制在 8~12 类)例如:

· 事实错误 / 编造;

· 漏答(该说的没说);

· 格式不符(要 JSON 给了散文);

· 理解偏差(答非所问);

· 延迟不可接受;

· 语气/长度不合预期。

分类要人工先标 100~200 条,形成标准后能量化的再自动化。

三、归因:别停在"答错了"

每一类继续往下问:

· 输入是否清楚?(需求本身模糊 → 加澄清机制)

· 检索是否给对了片段?(片段不足导致的错不该记在生成头上)

· 提示词是否约束不足?(格式类问题多半在此)

· 模型能力不足?(换模型是最后手段)

归因顺序决定了修复成本 —— 从最便宜的那层往下查。

四、修复与回归

· 每次修复都要转成一条评测样本(否则同类问题会再犯);

· 修复后跑评测集(见"评测集接进流水线"那篇),确认没有引入新问题;

· 记录"修复前/后"的失败率变化,用数据说明有效。

五、定期看两件事

1. 失败类型的分布变化(不是总量)—— 总量下降但"编造"占比上升,说明质量在恶化;

2. 沉默的失败:用户没点踩但直接离开了 —— 这类信号要靠行为埋点(重试、二次提问、放弃)捕获。

一个最小闭环(一周可跑起来)

1. 反馈接请求 id(半天);

2. 人工标 150 条,归纳 8 类(一天);

3. 每周挑占比最高的 2 类做归因与修复;

4. 每条修复进评测集;

5. 周会上只过一张图:失败类型分布 + 本周修复项。

本文由云枢 AI导航整理,内容以官方来源为准。

相关文章

顺序阅读

← 上一篇:长文摘要流水线:切分、归并、校验、成稿
下一篇:AI 功能的容量规划:怎么估并发与峰值 →

第 39 / 171 篇

术语速查 · 本页出现的 12 个词展开看中文名与一句话解释,点术语看完整条目
  • token词元:模型处理文本的最小单位,中文约 1–2 个汉字;计费与上下文长度都按它算。
  • 转写 / 字幕Transcription:把音视频人声逐句变成带时间戳的文字稿,便于做字幕与章节切分。
  • SSE服务器发送事件:服务器通过长连接持续推送增量文本,是对白逐字出现的常见实现。
  • API应用编程接口:程序之间约定的调用方式;站内工具由服务端调用,浏览器里不出现密钥。
  • CDN内容分发网络:把静态资源缓存到离用户更近的节点,缩短加载时间。
  • 缓存Cache:把结果暂存复用,复用得越多平均耗时越低;需要约定过期与刷新策略。
  • 限流Rate Limit:限制单位时间内的请求次数,防止单用户或异常流量打满服务端。
  • SSG静态站点生成:构建阶段就生成 HTML,访问时直接返回,不必每次请求都渲染。
  • ISR增量静态再生:先返回静态页,再在后台按需重新生成,兼顾速度与更新时效。
  • 灰度发布Canary Release:先让一小部分用户用新版本,确认无误再放量,出问题的爆炸半径最小。
  • 提示词Prompt:交给模型的指令文本;写清角色、任务、输入与输出格式比反复试更省。
  • 积分Credits:站内计费单位:按工具单价预扣,调用失败自动退还;单价以定价页为准。

完整解释与站内出现处见 AI 术语表(40 条)。