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

给文档库打质量分:五个维度与三档动作

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

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

你能否说出当前最该修的 3 份文档,以及各自的问题?

文档库也需要"质量分"

RAG 的效果上限由资料质量决定 ✔。但多数团队只优化模型与提示词 ✗,

从不看"文档本身好不好用" ✔ —— 于是永远在修下游 ✔。

给文档打质量分 ✔,就能把优化力气花在真正薄弱的资料上 ✔。

一、五个可自动计算的维度

```

① 完整性:是否包含常见问题所需的关键信息(用查询日志对照,见检索日志那篇)

② 结构:标题层级是否清晰、是否有分节(层级乱的文档切分后很碎)

③ 时效:最后更新时间、是否已被新版替代(见版本那篇)

④ 可检索性:能否被常见问法命中(用真实 query 抽样测)

⑤ 规范:术语是否统一、是否含大量图片/表格而缺文字说明

```

第 ④ 项最有价值 ✗→✔:把真实查询拿来测"这份文档能不能被搜到" ✔ ——

这是直接的效果指标 ✔,而不是间接的结构指标 ✔。

二、怎么打分(别搞复杂)

· 每项 0~2 分(差/一般/好 ✔)× 权重 ✔ → 总分 10 分 ✔;

· 只分三档(好 / 一般 / 待改 ✔)—— 分太细没人看 ✗;

· 按月更新 ✔(文档在变 ✔)。

示例 ✔:

```

《退款政策 v3》 8/10 好 (建议:补一段时效说明)

《产品手册 2022》 3/10 待改 (时效 0 分,已被新版替代)

```

三、分数要变成行动

| 分数 | 动作 |

|---|---|

| 好(≥7) | 保持,纳入"可信来源"白名单 ✔ |

| 一般(4~6) | 排期待改(补结构/补说明 ✔) |

| 待改(≤3) | 优先:要么修,要么从检索范围里移出 ✔ |

关键:低分文档不修就该移出 ✗→✔ ——

留着它只会让检索命中坏资料 ✔(比"没有资料"更糟 ✔)。

四、三个反模式

· 只看文档数量 ✗(1000 份烂文档不如 100 份好文档 ✔);

· 分数只算不用 ✗(没有对应动作 ✔);

· 让模型给文档打分 ✗(不可复现、不可解释 ✔)→ 用可计算的规则 ✔。

一条判据

> 你能否说出当前最该修的 3 份文档 ✔ 以及它们各自的问题 ✔?

> 说不出,说明文档库还没有质量视角 ✗。

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

相关文章

顺序阅读

← 上一篇:AI 功能的发布节奏:多久发一次比较好
下一篇:输入校验分级:硬拦、软提示与仅记录 →

第 148 / 171 篇

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

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