大模型应用开发 / 系统课时
建立知识审核发布回滚流程
建立知识审核发布回滚流程
知识库一旦进入线上客服链路,错误政策或过期口径会直接放大为批量错误回答。本节建立一套可执行的知识版本流程:提交后先审核,高风险变更必须复核,发布时保留审计证据,异常时能快速切回上一稳定版本,并让失效内容退出检索。
学习目标
- 定义知识从提交、审核、发布到失效、回滚的状态与合法迁移
- 为每次变更记录操作者、版本差异、审核意见和发布时间
- 为高风险政策设置双重复核,并在异常时快速恢复稳定版本
用状态机约束知识生命周期
不要把“是否可检索”只做成一个布尔字段。至少要区分草稿、待审核、已通过、已发布、已失效和已回滚,因为审核通过不等于已经在线,回滚也不等于简单删除当前版本。
推荐把主状态定义为 DRAFT、IN_REVIEW、APPROVED、PUBLISHED、INVALID、ROLLED_BACK。正常路径是草稿提交审核,审核通过后发布;失效只允许从已发布版本进入;回滚则由当前已发布版本切回此前稳定版本,并把故障版本保留为不可服务的历史记录。

状态迁移必须由服务端校验,不能依赖前端按钮隐藏。例如 IN_REVIEW 可以被驳回到 DRAFT,但不能直接进入 PUBLISHED;INVALID 也不能再次上线,除非复制为新版本重新走审核。
记录版本差异与审计证据
每一次提交都生成不可变版本号,发布记录只指向某个版本,而不是覆盖原文。这样才能回答“谁改了什么、谁批准的、线上当时使用哪一版”。
| 记录项 | 最低要求 |
|---|---|
| 版本 | knowledgeId、versionId、父版本、内容哈希 |
| 变更 | 标题、正文、适用范围、来源、有效期的差异 |
| 操作人 | 提交人、审核人、复核人、发布人 |
| 审批 | 风险级别、审核意见、复核意见、结果 |
| 发布 | 发布时间、发布批次、当前稳定版本 |
| 回滚 | 回滚原因、目标版本、执行人、关联故障单 |
审计时间应由服务端生成,例如 <TIME>,不要接受客户端自由传入。对于政策、价格、合规口径等高风险知识,还应保存来源文档或审批单据的引用标识,确保后续能追溯依据。
为高风险变更增加发布门禁
风险分级可以从“影响范围”和“错误代价”两个维度判断。普通 FAQ 可由一名审核人批准;涉及退款规则、合同条款、监管政策、资费或安全限制的知识,应要求第二名复核人确认,而且提交人、审核人、复核人不能是同一人。
下面用一个可运行的 Python 示例演示最小状态机。它不依赖具体工作流产品,但能用于验证“未复核的高风险版本不能发布”和“回滚只能指向稳定版本”这两个核心约束。
from dataclasses import dataclass
@dataclass
class Version:
version_id: str
state: str = "DRAFT"
risk: str = "NORMAL"
approved: bool = False
second_reviewed: bool = False
stable: bool = False
def publish(version: Version) -> None:
# 发布只能从审核通过状态进入,并在服务端执行风险门禁。
if version.state != "APPROVED" or not version.approved:
raise ValueError("publish blocked: approval required")
if version.risk == "HIGH" and not version.second_reviewed:
raise ValueError("publish blocked: second review required")
version.state = "PUBLISHED"
version.stable = True
def rollback(current: Version, target: Version) -> None:
# 只允许切回已经验证过的稳定版本,故障版本仍保留审计记录。
if not target.stable:
raise ValueError("rollback blocked: target is not stable")
current.state = "ROLLED_BACK"
current.stable = False
target.state = "PUBLISHED"
v41 = Version("v41", approved=True, stable=True, state="PUBLISHED")
v42 = Version("v42", state="APPROVED", risk="HIGH", approved=True)
online_version = "v41"
try:
publish(v42)
except ValueError as exc:
print(exc)
# 完成第二人复核后再发布,并切换在线版本指针。
v42.second_reviewed = True
publish(v42)
online_version = v42.version_id
print(online_version, v42.state)
rollback(v42, v41)
online_version = v41.version_id
print(v42.version_id, v42.state)
print(online_version, v41.state)预期输出
publish blocked: second review required
v42 PUBLISHED
v42 ROLLED_BACK
v41 PUBLISHED生产系统还应在发布前校验必填来源、有效期、检索可见范围以及索引构建状态。门禁失败时应阻断发布,而不是先上线再等待人工补资料。
让发布与索引切换成为一个受控动作
知识“发布成功”必须同时满足版本状态和检索侧可用性。较稳妥的做法是先为新版本构建索引并完成抽样验证,再原子切换“当前在线版本”指针;切换后旧稳定版本暂时保留,不立即删除。
验证至少覆盖三类问题:新版本能否被目标问题召回、旧失效版本是否退出召回、关键问答的引用是否指向正确来源。若系统使用向量库和关键词索引两套检索,也要确认二者都完成切换,避免半发布状态。
在线异常时快速回滚
回滚前先冻结当前故障版本,阻止继续编辑和重复发布;随后将在线指针切回上一稳定版本,并同步恢复对应索引、缓存和检索路由。回滚目标必须是已成功发布且验证过的版本,不能临时选择一个未审核草稿。
回滚完成后立即执行固定验收集:抽查高频问题、受影响政策问法、同义改写和引用来源,并确认故障版本不再参与召回。故障版本保留 ROLLED_BACK 状态,用于后续复盘和修复;修复时从稳定版本或故障版本派生新版本,再重新经过审核流程。
真正可运营的知识库不是“有人能改文档”,而是每次变更都有状态、证据和责任人,每次高风险发布都有独立复核,每次线上异常都有确定的稳定回退点。