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

把文档更新变成流程:谁改、谁审、谁通知

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

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

审核者与编写者不应是同一个人。

文档更新不是"上传一下就完事"

RAG 系统的资料在持续变化 ✔:政策改、手册改、产品改 ✔。如果更新流程不清晰 ✗,

就会出现:旧版还在被检索、新版没进索引、改了没人知道 ✔ —— 三类问题都会让答案出错 ✔。

把"文档更新"做成流程 ✔:谁改、谁审、何时生效、如何通知 ✔。

一、四个角色(小团队可以兼任,但职责要写明)

```

① 提出者:业务方提出变更(附原因与影响范围 ✔)

② 编写者:改文档(保持结构,便于切分 ✔)

③ 审核者:确认内容正确 + 合规(谁有权批 ✔)

④ 发布者:触发索引更新并确认生效(自动化最好 ✔)

```

要点:审核者与编写者不应是同一个人 ✗ ✔(至少对高影响文档 ✔)。

二、五个必须记录的字段

```

doc_id(稳定不变 ✔)| version | 生效时间(effective_from ✔)

变更摘要(一句话 ✔)| 审核人 + 时间 ✔

```

生效时间很关键 ✗:很多变更应"未来生效" ✔(例如新政策下月执行 ✔),

否则会出现"提前按新规回答"的错误 ✔。

三、更新要自动触发索引(别靠人记得 ✗)

```

文档库变更 → 触发解析/切分/嵌入 → 生成新版本 → 切换 current → 旧版标 superseded

```

· 删除要同步(下线文档必须从索引移除 ✔);

· 重建要有灰度(新索引与旧索引并存,切流后再删旧 ✔ —— 见新鲜度那篇 ✔);

· 验证:更新后自动抽查 5 个相关问题 ✔,确认新内容可检索 ✔。

四、通知谁

· 值班/客服(他们最先被用户问到 ✔);

· 产品/运营(涉及口径变化 ✔);

· 高影响变更:提前通知用户 ✔(见变更说明那篇 ✔)。

五、三个反模式

· 直接覆盖文件 ✗(没有版本,无法回退 ✔);

· 改了不通知 ✗(一线还在按旧口径答 ✔);

· 上传即生效 ✗(未审核内容进索引 ✔)。

六、一个小检查清单

```

□ 每次更新有 doc_id / version / 生效时间 / 审核人

□ 索引更新自动触发,且删除同步

□ 更新后自动抽查 5 个问题

□ 旧版标 superseded(不删)

□ 值班与客服收到通知

□ 高影响变更提前对外说明

```

一条判据

> 从"业务方提出改一份文档"到"用户能看到新答案" ✔,平均要多久 ✔?谁负责 ✔?

> 答不出,说明更新还没有流程 ✗。

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

相关文章

顺序阅读

← 上一篇:把重复问题聚类:从处理个案到修一类问题
下一篇:AI 功能的分层定价:把成本映射到价格 →

第 112 / 171 篇

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

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