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

把评测失败分类成可行动的类型

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

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

分不清「资料有但答错」与「资料没有却说」,就会一直在换模型。

"失败了 23 条"不是可行动的信息

评测跑完报"23 条失败" ✗ —— 接下来该干嘛 ✔?没有分类,就只能一条条看 ✔,

而人一忙就只看前几条 ✔,剩下的长期没人管 ✔。

把失败分成"可行动的类型" ✔,每类对应一个明确的修复方向 ✔。

一、一张实用的失败类型表(8~12 类)

```

① 格式不符(要 JSON 给了散文 / 字段缺失 ✔)

② 事实错误(与资料冲突 ✔)

③ 编造(资料里没有却断言 ✔)★最危险

④ 漏答(该说的没说 ✔)

⑤ 理解偏差(答非所问 ✔)

⑥ 拒答过度(该答却说不确定 ✔)

⑦ 未标注不确定(推断当事实 ✔)

⑧ 引用错误(引用不支持结论 ✔)

⑨ 延迟/超时 ✔

⑩ 越权/合规(不该答却答 ✔)★高危

```

要点:类型要互斥且可判定 ✗ ✔ —— 一条失败只归一类(选最主要的 ✔),

否则统计会重叠 ✔,谁也说不清该先修哪类 ✔。

二、每类要配"修复方向"(这才是可行动的关键)

| 类型 | 优先查哪里 |

|---|---|

| ① 格式不符 | 输出 schema、示例、校验与重试 ✔ |

| ② 事实错误 | 检索召回与片段质量(先查资料 ✔) |

| ③ 编造 | 证据表、引用校验、拒答标准 ✔ |

| ④ 漏答 | 检索覆盖、上下文截断 ✔ |

| ⑤ 理解偏差 | 任务说明与澄清机制 ✔ |

| ⑥ 拒答过度 | 拒绝阈值、提示词过保守 ✔ |

| ⑦ 未标注不确定 | 不确定性传递 ✔ |

| ⑧ 引用错误 | 引用一致性校验 ✔ |

| ⑨ 延迟 | 并行化、输出长度、缓存 ✔ |

| ⑩ 越权 | 权限模型与检索层过滤 ✔ |

注意 ② 与 ③ 的区别 ✗:② 是"资料里有正确信息但答错" ✔;③ 是"资料里根本没有却说了" ✔。

两者的修法完全不同 ✔(前者改检索,后者加引用校验与拒答 ✔)——

分不清这两类,就会一直在换模型 ✗。

三、怎么让分类"真的被执行"

1. 报告里只给 Top 3 类型 ✔(每类给 1 条样例原文 + 建议动作 ✔);

2. 每周例会只看类型分布变化 ✔(不看总量 ✔);

3. 每类指定一个"待办" ✔(谁、什么时候、怎么验证 ✔);

4. 修复后重跑,确认该类下降且其它类没有上升 ✔(常见副作用 ✔)。

四、三个反模式

· 只统计总失败数 ✗;

· 类型太多(30 类) ✗ → 没人记得住,标注也不一致 ✔;

· 类型不改 ✗ → 系统变了,失败模式也变了 ✔(每季度校准一次 ✔)。

一条判据

> 看到"本周失败率上升 2 个点" ✔,你能否立刻说出"是第 3 类上升了" ✔ 以及"该改哪里" ✔?

> 不能,说明失败没有被分类 ✗。

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

相关文章

顺序阅读

← 上一篇:把知识过期做成产品能力:时效提示与刷新入口
下一篇:输入规范化:先把用户输入弄干净 →

第 106 / 171 篇

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

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