大模型应用开发 / 系统课时

建立知识审核发布回滚流程

建立知识审核发布回滚流程

知识库一旦进入线上客服链路,错误政策或过期口径会直接放大为批量错误回答。本节建立一套可执行的知识版本流程:提交后先审核,高风险变更必须复核,发布时保留审计证据,异常时能快速切回上一稳定版本,并让失效内容退出检索。

学习目标

  • 定义知识从提交、审核、发布到失效、回滚的状态与合法迁移
  • 为每次变更记录操作者、版本差异、审核意见和发布时间
  • 为高风险政策设置双重复核,并在异常时快速恢复稳定版本

用状态机约束知识生命周期

不要把“是否可检索”只做成一个布尔字段。至少要区分草稿、待审核、已通过、已发布、已失效和已回滚,因为审核通过不等于已经在线,回滚也不等于简单删除当前版本。

推荐把主状态定义为 DRAFT、IN_REVIEW、APPROVED、PUBLISHED、INVALID、ROLLED_BACK。正常路径是草稿提交审核,审核通过后发布;失效只允许从已发布版本进入;回滚则由当前已发布版本切回此前稳定版本,并把故障版本保留为不可服务的历史记录。

知识版本审核发布回滚状态图

状态迁移必须由服务端校验,不能依赖前端按钮隐藏。例如 IN_REVIEW 可以被驳回到 DRAFT,但不能直接进入 PUBLISHED;INVALID 也不能再次上线,除非复制为新版本重新走审核。

记录版本差异与审计证据

每一次提交都生成不可变版本号,发布记录只指向某个版本,而不是覆盖原文。这样才能回答“谁改了什么、谁批准的、线上当时使用哪一版”。

记录项 最低要求
版本 knowledgeId、versionId、父版本、内容哈希
变更 标题、正文、适用范围、来源、有效期的差异
操作人 提交人、审核人、复核人、发布人
审批 风险级别、审核意见、复核意见、结果
发布 发布时间、发布批次、当前稳定版本
回滚 回滚原因、目标版本、执行人、关联故障单

审计时间应由服务端生成,例如 <TIME>,不要接受客户端自由传入。对于政策、价格、合规口径等高风险知识,还应保存来源文档或审批单据的引用标识,确保后续能追溯依据。

为高风险变更增加发布门禁

风险分级可以从“影响范围”和“错误代价”两个维度判断。普通 FAQ 可由一名审核人批准;涉及退款规则、合同条款、监管政策、资费或安全限制的知识,应要求第二名复核人确认,而且提交人、审核人、复核人不能是同一人。

下面用一个可运行的 Python 示例演示最小状态机。它不依赖具体工作流产品,但能用于验证“未复核的高风险版本不能发布”和“回滚只能指向稳定版本”这两个核心约束。

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)

预期输出

text
publish blocked: second review required
v42 PUBLISHED
v42 ROLLED_BACK
v41 PUBLISHED

生产系统还应在发布前校验必填来源、有效期、检索可见范围以及索引构建状态。门禁失败时应阻断发布,而不是先上线再等待人工补资料。

让发布与索引切换成为一个受控动作

知识“发布成功”必须同时满足版本状态和检索侧可用性。较稳妥的做法是先为新版本构建索引并完成抽样验证,再原子切换“当前在线版本”指针;切换后旧稳定版本暂时保留,不立即删除。

验证至少覆盖三类问题:新版本能否被目标问题召回、旧失效版本是否退出召回、关键问答的引用是否指向正确来源。若系统使用向量库和关键词索引两套检索,也要确认二者都完成切换,避免半发布状态。

在线异常时快速回滚

回滚前先冻结当前故障版本,阻止继续编辑和重复发布;随后将在线指针切回上一稳定版本,并同步恢复对应索引、缓存和检索路由。回滚目标必须是已成功发布且验证过的版本,不能临时选择一个未审核草稿。

回滚完成后立即执行固定验收集:抽查高频问题、受影响政策问法、同义改写和引用来源,并确认故障版本不再参与召回。故障版本保留 ROLLED_BACK 状态,用于后续复盘和修复;修复时从稳定版本或故障版本派生新版本,再重新经过审核流程。

真正可运营的知识库不是“有人能改文档”,而是每次变更都有状态、证据和责任人,每次高风险发布都有独立复核,每次线上异常都有确定的稳定回退点。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

建立知识审核发布回滚流程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通