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

把检索质量做成可回归的:黄金集与定期抽样

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

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

不要只看有没有结果,要看结果里有没有用。

检索质量会"悄悄退化"

检索退化最麻烦的地方是没人会发现 ✗:文档在变、切分规则在变、向量模型在升级、

索引重建的时机不同 —— 每一处都可能让召回悄悄变差 ✔,而线上只表现为"用户好像不太满意" ✗。

对策是两件老办法:黄金集(固定小样本)+ 定期抽样(从真实流量里抽)✔。

一、黄金集:20~50 个问题,长期不动

· 每个问题标注应命中的片段(哪一段真正能回答它 ✔);

· 覆盖不同查询类型:短查询、长句、含编号、跨章节、口语化 ✔;

· 覆盖"该无结果"的情况(语料里确实没有 ✔);

· 冻结:进版本库 ✔,改动要留痕(改了就不能与历史指标直接比 ✔)。

二、每次改动都跑(三件事)

```

召回@20 → 该命中的片段有没有进候选集

命中位次 → 第一条正确片段平均排第几(MRR ✔)

无结果正确率 → 该无结果时是否返回空(而不是硬凑 ✗)

```

接进流水线(见评测接进 CI 那篇 ✔),改动即回归 ✔。

三、定期抽样:从真实流量看漂移

黄金集是"固定的考题",它不会告诉你用户问法变了 ✗。所以每周/每月:

1. 从真实查询里按比例随机抽 30~50 条 ✔;

2. 人工标注"检索结果里有没有真正有用的片段" ✔;

3. 与上期对照,看有用率与重复率的变化 ✔;

4. 把新出现的失败类型补进黄金集 ✔(让固定考题跟上现实 ✔)。

四、四种常见退化原因(按频率)

| 原因 | 表现 | 对策 |

|---|---|---|

| 切分规则改动 | 召回骤降,碎片增多 | 切分规则也要跑黄金集 ✔ |

| 文档更新未重建索引 | 新内容搜不到 | 索引重建纳入发布流程 ✔ |

| 向量模型升级 | 整体轻微变差 | 升级前用黄金集对照 ✔ |

| 过滤条件收紧 | 召回下降 | 过滤规则与召回指标一起看 ✔ |

五、两条纪律

1. 不要只看"有没有结果" ✗ —— 要看结果里有没有用 ✔(这是检索与"能搜到"的区别 ✔);

2. 指标要留档 ✔(时间序列才看得出"悄悄退化" ✔)。

一条判据

> 如果检索链路的任何一处改动(切分、模型、索引、过滤)都不需要跑黄金集就能上线 ✔,

> 那这套检索质量保障是有洞的 ✗。

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

相关文章

顺序阅读

← 上一篇:AI 功能的需求评审:先问这七个问题
下一篇:服务降级时的用户体验:把「抱歉」写成有用的提示 →

第 58 / 171 篇

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

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