AI 资源生命周期
AI 管理中心中的很多资源都需要版本管理。比如 Prompt 需要保留不同模板版本，Skill 需要管理不同包版本，AgentSpec 需要分发不同规范版本。
生命周期文档帮助你理解这些资源从创建到上线的共同规则。具体字段和 API 可能因资源类型不同而略有差异，但核心概念是一致的。
资源和版本
一个 AI 资源由命名空间、资源类型和资源名标识。
namespaceId -> resourceType -> resourceName一个资源可以有多个版本。资源本身保存描述、可见性、业务标签、当前编辑版本等元信息；版本保存具体内容、状态、作者、发布信息和存储位置。
例如：
public -> prompt -> order-summary表示一个 Prompt 资源。1.0.0、1.1.0表示这个 Prompt 的不同版本。latest可以指向当前推荐使用的版本。
状态说明
资源本身有启用和禁用状态。禁用后，即使资源存在，运行时也不应该把它作为可用资源返回。
版本有以下常见状态：
| 状态 | 含义 |
|---|---|
draft | 草稿，可继续编辑 |
reviewing | 已提交审核，等待 Pipeline 或人工流程处理 |
reviewed | 已通过或完成审核，等待发布 |
online | 已上线，可被运行时查询 |
offline | 已下线，默认不再参与运行时路由 |
标准发布流程
推荐流程如下：
创建草稿 -> 修改草稿 -> 提交 -> 审核 -> 发布 -> 上线实际使用时通常有三种路径：
| 场景 | 推荐做法 |
|---|---|
| 日常变更 | 创建草稿，提交审核，通过后发布 |
| 没有启用 Pipeline | 提交后直接发布或进入可发布状态 |
| 紧急修复 | 由管理员强制发布，并记录原因 |
强制发布会跳过 Pipeline 校验。它适合应急，不适合当作日常发布方式。
草稿规则
草稿是编辑中的版本。它用于隔离未发布内容，避免正在修改的资源影响线上应用。
使用草稿时建议遵守这些规则：
- 修改线上版本前，先从线上版本创建草稿。
- 草稿没有完成前，不要把标签指向它。
- 删除草稿只删除编辑中的版本，不应该影响已上线版本。
- 同一个资源尽量只保留一个当前编辑草稿，避免多人并行修改时互相覆盖。
标签和 latest
标签用于把易读名称映射到版本。最常见的标签是 latest。
运行时应用可以按显式版本查询，也可以按标签查询。按标签查询时，Nacos 会在请求时解析标签指向的版本。
标签应只指向可用版本，不应指向 draft 或 reviewing 版本。否则用户可能读到尚未发布或尚未审核的内容。
上线和下线
发布表示版本已经完成发布流程。上线表示这个版本可以被运行时正常查询。
下线不会等同于删除。下线后的版本仍可保留用于审计、回滚或手动查询。是否允许重新上线由具体资源类型和权限规则决定。
可见性和权限
AI 管理中心的查询结果会受到可见性和鉴权影响。一个资源即使处于 online 状态，也可能因为调用者没有权限而不可见。
可见性用于决定资源是否应该出现在详情、列表和搜索结果中；鉴权用于决定当前身份是否能读取或写入目标资源。两者会配合工作，但职责不同。更多说明请参考可见性插件。
平台管理员需要同时关注三件事：
- 资源是否启用。
- 版本是否上线。
- 调用者是否有权限看到这个资源。
给运维和平台团队的建议
- 为生产资源启用发布 Pipeline，用于安全扫描、格式校验或合规检查。启用和扩展方式见 AI 发布 Pipeline 插件。
- 为强制发布建立审批或审计要求。
- 使用命名空间区分环境，不要混用测试和生产资源。
- 定期清理无用草稿和长期下线版本。
- 给关键资源维护清晰的
latest标签，降低应用侧配置复杂度。