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

把用户报告变成可复现用例:四步转换

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

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

上周的用户投诉,有多少条变成了带期望的评测用例?

用户投诉不是"待办",是"用例"

"用户说答得不对" ✗ 这种信息无法直接修复 ✔ ——

要把它变成可复现的用例 ✔:固定输入 + 明确期望 ✔,然后才能修、才能验证 ✔。

一、四步转换

```

① 还原(从日志里取原始输入与输出,见日志那篇)

② 缩小(把输入缩到最小可复现,见复盘连评测那篇)

③ 定期望(正确应该是什么?谁来定?)

④ 入库(进评测集,加断言,进冒烟集)

```

第 ③ 步最容易含糊 ✗:用户说"不对" ✔,但对的标准是什么 ✔?

→ 必须由业务方确认 ✔(而不是工程师自己猜 ✔ —— 见团队分工 ✔)。

二、三类"用户报告"各自怎么处理

| 类型 | 处理 |

|---|---|

| 事实错误(答错了事实 ✔) | 取原始输入 → 期望"正确事实或拒答" ✔ |

| 理解偏差(答非所问 ✔) | 期望"澄清或按意图回答" ✔ |

| 体验问题(太长/太慢/太啰嗦 ✔) | 转成可测指标(长度/延迟/句数 ✔) |

第三类常被忽略 ✗→✔:它不是"内容错" ✔,因此常被排除在评测之外 ✔ ——

但它占投诉比例很高 ✔(见可读性那篇 ✔)。

三、四个纪律

1. 必须带原文(不要只记录"用户说不准" ✔);

2. 必须可复现(用当时的模型/提示词版本重跑 ✔ —— 见可复现那篇 ✔);

3. 必须有 owner ✔;

4. 修完要回归(该用例进评测集 ✔ —— 见发布门禁 ✔)。

四、三个反模式

· 把投诉当"个例"忽略 ✗(同一问题往往重复出现 ✔ —— 见问题聚类 ✔);

· 只改提示词不复现 ✗(改完不知道有没有修好 ✔);

· 期望由工程师拍 ✗(业务方不认 ✔)。

五、一条判据

> 上周的用户投诉 ✔,有多少条变成了带期望的评测用例 ✔?

> 是 0,说明投诉还在"处理个案"而不是"修系统" ✗。

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

相关文章

顺序阅读

← 上一篇:缓存、索引与库的版本一致:三份真相别打架
下一篇:AI 功能的运维手册:凌晨三点该看什么 →

第 167 / 171 篇

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

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