Agent Runtime 管理资产版本

注册中心通过不可变版本、审批状态和版本标签管理资产演进。这里说明如何通过腾讯云控制台创建新版本、处理人工审批、发布稳定版本、使用自定义标签、回退版本及删除不再需要的版本。

相关产品
Agent Runtime 产品页,含版本规格、价格与购买入口。

一、基本原则

·资产内容发生变化时创建新版本,已有版本内容不会被覆盖。

·审批用于确认版本是否可以发布;审批通过不等于自动替换当前稳定版本。

·latest 表示最新审批通过的版本,由系统自动维护。

·stable 表示当前稳定版本,也是未指定版本时默认解析的版本。

·自定义标签可用于标记测试、灰度或特定业务用途的版本。

二、审批方式

控制台默认选择自动审批,也可以在创建注册中心时选择人工审批;审批方式创建后不能修改。

审批方式 新版本行为
自动审批 版本内容校验成功后由系统自动批准。
人工审批 版本内容校验成功后进入待审批状态,需要管理员批准或驳回。

对于 Skill 压缩包,系统需要先完成上传和内容校验。校验完成前,即使使用自动审批,也不能作为可发布版本。

三、创建新版本

1. 进入注册中心,找到目标资产并单击 查看。

2. 在版本列表上方单击 新建版本。

3. 根据需要填写版本别名和变更说明。

4. 按资产类型填写新的协议元数据、来源地址、SKILL.md、压缩包或自定义内容。

5. 确认后创建版本。

6. 在版本列表中检查版本的修订号、来源类型、内容状态和审批状态。

·版本列表会同时展示审批状态以及 latest、stable 等标签:

·版本别名用于展示,系统仍会为每个版本生成独立版本 ID 和单调递增的修订号。即使删除某个历史版本,其修订号也不会被后续版本重复使用。

四、处理人工审批

人工审批模式下,新版本内容校验成功后会显示为待审批。

五、批准版本

1. 在资产详情页选择待审批版本。

2. 发起批准操作,并填写能够说明审批依据的意见。

3. 确认版本状态更新为已通过。

首个通过审批且内容校验成功的版本会自动获得 stable 和 latest 标签。后续版本通过审批后,只会自动获得或移动 latest,不会自动替换已有的 stable。

六、驳回或取消版本

·内容不符合发布要求时,可以驳回版本,并在意见中说明原因。

·不再继续处理的候选版本可以取消。

·已驳回或已取消的版本不能再次批准;修正内容后应创建新版本。

审批、驳回和取消都会记录到操作日志中。

七、理解版本标签

标签 维护方式 说明
stable 首次由系统绑定,之后由用户移动 当前稳定版本;绑定后不能解除。
latest 系统自动维护 指向修订号最大的已审批版本,不能手动修改。
自定义标签 用户维护 可以创建、移动、解绑或删除。

标签只能指向已审批且内容校验成功的版本。一个标签只能指向一个版本,一个版本可以同时拥有多个标签。

自定义标签名称会自动去除首尾空格并转换为小写。名称长度为 1–63 个字符,必须以字母开头,仅支持小写字母、数字、点、下划线和短横线;每项资产最多可以拥有 32 个自定义标签。

八、发布稳定版本

后续版本通过审批后,latest 会自动移动到该版本,但 stable 保持不变。完成验证后,可以将新版本发布为稳定版本:

1. 在资产详情页选择已经审批通过且内容校验成功的目标版本。

2. 打开该版本的更多操作,选择管理标签。

3. 将 stable 移动到当前版本。

4. 确认版本列表和版本详情中的 stable 标签已经更新。

在 管理标签 面板中,可以查看系统维护的 latest、移动 stable,或新增自定义标签:

注意:截图中的“内容就绪”是控制台当前用语,表示版本内容已经完成校验,可以参与审批和标签管理;不表示该版本已经发布或正在运行。

将 stable 移动到新版本只改变后续的默认版本解析,不会修改或删除历史版本。

九、使用自定义标签

自定义标签适合表达除稳定版和最新版以外的发布通道,例如测试环境、灰度验证或特定业务线。

在目标版本的管理标签面板中,可以:

·新建自定义标签并绑定当前版本。

·将已有自定义标签从其他版本移动到当前版本。

·解除自定义标签与版本的绑定,同时保留标签名称。

·删除不再使用的自定义标签。

不要将账号、手机号、项目密钥或其他敏感信息用作标签名称。

十、回退稳定版本

如果新稳定版本出现问题,可以将 stable 移回历史版本:

1. 在版本列表中选择历史上已审批且内容校验成功的版本。

2. 打开管理标签。

3. 将 stable 移动到该历史版本。

4. 确认目标版本带有 stable 标签,并记录回退原因。

回退通过移动标签完成,不会复制版本或生成新的修订号。资产运行环境中的实际部署是否需要回退,应由对应运行系统单独处理。

十一、删除版本

在版本的更多操作中,可以删除符合条件的历史版本。删除前请注意:

·stable 当前指向的版本不能删除。

·资产仅剩的最后一个已审批版本不能删除。

·删除 latest 指向但不是 stable 的版本后,latest 会自动回退到剩余版本中修订号最大的已审批版本。

·指向已删除版本的自定义标签会保留,但会解除版本绑定。

·删除版本不会复用其修订号,也不会清除相关操作日志。

·删除后,当前控制台不提供恢复入口。

十二、推荐发布流程

建议按以下顺序管理版本:

1. 创建新版本,并填写清晰的变更说明。

2. 等待内容校验成功;人工审批模式下完成审批。

3. 检查版本详情,确认资产定义、来源信息和内容状态符合预期。

4. 使用 latest 或自定义标签完成验证。

5. 将 stable 移动到新版本并记录发布原因。

6. 发布后持续观察;出现问题时将 stable 移回已验证的历史版本。

7. 仅在确认无保留价值且满足删除条件时清理历史版本。

十三、注意事项

·审批与发布是两个步骤:后续版本审批通过只会更新 latest,不会自动更新 stable。

·未指定版本时默认使用 stable;不会因为存在更新的 latest 而自动切换。

·latest 不能手动修改,stable 不能解绑。

·版本内容不可覆盖;修改内容必须创建新版本。

·变更说明和审批意见中不得包含访问凭据、内部地址或其他敏感信息。

赞 (0)
上一篇 4天前
下一篇 4天前