服务注册与分布式协调 / 系统课时
建立 AI 资源发布流程
建立 AI 资源发布流程
生产级 AI Registry 不能让资源编辑完成后直接影响运行时。本节把提交、自动校验、人工发布、上线、下线和紧急兜底串成一条可审计流程,并给出发布门禁配置与验收方法。
学习目标
- 设计 AI 资源从草稿到上线、下线的标准发布路径
- 为自动校验、人工确认和强制发布划分清晰权限边界
- 建立能回退、能审计、能验证运行时可见性的发布检查表
把编辑和生产可见性彻底分开
发布流程的第一条规则是:可编辑状态不等于可消费状态。Prompt、Skill、AgentSpec 等版本化资源应先在草稿中修改,提交后进入检查或审核阶段,只有经过发布动作并处于可用状态的版本,才允许生产运行时发现或读取。
一条稳妥的主路径可以定义为:创建或 Fork 草稿 → 内容校验 → 提交审核 → Pipeline 自动检查 → 人工确认发布 → 上线可发现 → 下线或重新上线。未启用 Pipeline 时,部分资源的提交动作可能缩短流程甚至直接进入可用状态,因此生产环境不应把“未配置审核”误认为“审核通过”。

为每个门禁定义通过条件
不要只画流程图,还要为每个阶段写出可判断的进入和退出条件。这样平台才能自动阻断错误发布,而不是依赖发布人“记得检查”。
| 阶段 | 必须检查 | 失败后的动作 |
|---|---|---|
| 草稿提交前 | 名称、版本、必填内容、变量或包结构完整 | 留在草稿并提示修复 |
| 自动 Pipeline | 格式、安全扫描、团队自定义规则 | 阻断发布并返回可编辑状态 |
| 人工发布 | 变更说明、Owner、影响范围、回退版本 | 不发布,等待补充或审批 |
| 上线后 | 运行时可发现、标签指向正确、关键调用通过 | 下线新版本并切回已验证版本 |
| 下线 | 无关键消费者继续依赖该版本 | 保持离线,必要时重新上线 |
Prompt 的发布检查应特别关注变量兼容与模板渲染;Skill 需要检查包内容、资源文件和安全风险;MCP Server 则要把端点可达性、工具定义和工具开关纳入上线验收。统一流程只定义门禁,不应抹平资源类型自己的检查项。
配置发布 Pipeline 作为自动门禁
Nacos AI 发布 Pipeline 可以在资源正式发布前插入自动检查节点。下面用 Skill 安全扫描作为一个具体配置示例;<PATH> 替换为部署环境中扫描器的实际路径。
# 开启 AI 发布 Pipeline,并选择检查节点
nacos.plugin.ai-pipeline.enabled=true
nacos.plugin.ai-pipeline.type=skill-scanner
# Skill 扫描器负责发现提示注入、数据泄露和恶意代码等风险
nacos.plugin.ai-pipeline.skill-scanner.enabled=true
nacos.plugin.ai-pipeline.skill-scanner.command=<PATH>/skill-scanner这段配置生效后,提交 Skill 草稿会进入 Pipeline 检查;检查通过后再执行人工发布,检查失败则回到可修改状态。对于 Prompt 或其他资源,可以沿用同一门禁思想接入格式检查、安全规则或团队自定义 Pipeline,而不要把 Skill 扫描器的规则机械套给所有资源。
验证时至少准备一个可发布的测试 Skill:提交后确认它先经过审核检查,检查通过前生产消费者不可把它当作新版本使用;再执行人工发布,确认新版本进入可发现状态。若关闭 Pipeline 后提交动作直接进入可用状态,则说明生产门禁已经被绕开,应恢复 Pipeline 或在外层发布系统增加强制审批。
把强制发布变成受控异常路径
强制发布的意义是处理真正的紧急修复,而不是提高日常发布速度。建议只给极少数平台管理员保留权限,并要求工单号、原因、操作者、时间、被绕过的检查项和后续补审结果全部进入审计记录。
如果 Pipeline 拒绝了版本,默认动作应是修改草稿并重新提交。只有确认自动规则误判,且业务影响高于绕过检查的风险时,才允许强制发布。强制发布后还要补做运行时验证,并设定明确的观察窗口;一旦出现异常,立即下线该版本。
用版本和标签完成可回退发布
回退不应该修改已经发布的内容,而应切换到一个已经验证过的版本。对 Prompt 和 Skill,可先发布新版本,再把 latest、stable 或业务标签指向目标版本;发生问题时,把标签切回旧版本或直接让消费者锁定旧版本。对于 MCP Server,则优先恢复经过验证的服务版本、端点或工具可见性。
上线验收要从“控制面成功”继续走到“运行时成功”。至少验证资源能被目标命名空间中的消费者发现、标签或版本解析正确、关键调用路径可用,并确认非授权用户无法越过可见性边界。只有这些条件同时成立,发布才算完成。
最终应把生产规则固定为:任何修改先形成新草稿或新版本,自动检查负责机械门禁,人工发布负责业务判断,强制发布只处理受审计的异常场景,下线与版本回退负责止损。这样资源变化才能进入可控的发布系统,而不是直接变成一次不可追踪的生产修改。