Agent Runtime 注册中心概述

注册中心负责资产治理与发现，不负责部署或运行资产，也不转发对资产的业务调用。资产能否被实际访问，还取决于其运行环境、网络连通性和访问凭证。

一、能力概述

注册中心提供以下核心能力：

·统一登记：在一个目录中管理不同团队提供的 Agent、MCP Server、Skill 和自定义资产。

·多种录入方式：支持从 URL 同步标准协议元数据，也支持手动填写或上传资产定义。

·版本治理：每次内容更新都会形成新的不可变版本，历史版本不会被覆盖。

·审批发布：支持自动审批和人工审批，通过标签区分稳定版本、最新版本和自定义发布通道。

·查询发现：按名称或资产类型查找当前身份有权查看的资产。

·操作审计：记录注册中心、资产、版本、审批和标签变更等操作。

二、适用场景

注册中心适合以下场景：

·多个团队分别维护 Agent、MCP Server 或 Skill，需要统一展示和复用。

·资产会持续升级，需要保留历史版本，并控制使用方何时切换版本。

·资产发布前需要管理员审核，或者希望由系统自动完成审批。

·需要记录资产由谁创建、何时更新以及版本如何发布，便于问题追溯。

三、支持的资产类型

从 URL 同步适合已经提供标准发现地址的在线资产。手动定义适合 Skill、内部脚本、尚未发布的资产，或暂时无法提供发现地址的资产。

四、注册中心（Registry）

注册中心是组织资产的顶层目录，通常按团队、项目或业务场景创建。创建时默认使用自动审批，也可以选择人工审批；注册中心名称和审批方式创建后不能修改，描述可以修改。

五、资产（Record）

资产表示一项可被发现和复用的能力，例如一个代码评审 Agent、一项天气查询 MCP 服务或一个数据分析 Skill。资产具有稳定的名称和类型，并可以包含多个版本。

资产名称和类型创建后不能修改。需要更改资产内容时，应创建新版本，而不是覆盖已有版本。

六、版本（Version）

版本是资产内容在某个时间点的不可变快照，包含版本别名、变更说明、资产定义、来源信息和审批状态等内容。创建资产时会同时生成第一个版本；后续更新内容会继续增加版本。

七、审批方式

审批方式属于注册中心。同一注册中心中的资产版本沿用该注册中心的审批方式。

八、版本标签

标签是资产内指向某个版本的发布标记：

·stable：当前稳定版本，也是未指定版本时默认使用的版本。

·latest：修订号最大的已审批版本，由系统自动维护。

·自定义标签：由用户创建和维护，可用于标记特定用途或发布通道。

一个标签同一时间只能指向一个版本；一个版本可以同时拥有多个标签。

九、操作日志

操作日志记录注册中心及其资产的创建、编辑、版本创建、审批、标签调整和删除等操作。即使资产或注册中心已删除，相关历史记录仍可用于审计和问题追溯。

十、工作流程

注册中心的典型使用流程如下：

1. 创建注册中心；默认使用自动审批，也可以在创建时选择人工审批。

2. 从 URL 同步或手动定义资产，同时生成首个版本。

3. 系统自动审批版本，或由管理员完成人工审批。

4. 首个审批通过且内容校验成功的版本自动获得 stable 和 latest 标签。

5. 资产内容更新时创建新版本；新版本审批通过后，系统自动移动 latest，但不会自动移动已有的 stable。

6. 完成验证后，将 stable 移动到新版本；如需回退，可重新指向历史上已审批且内容校验成功的版本。

7. 通过操作日志查看资产的版本和发布变化。

十一、使用限制

·注册中心名称和审批方式创建后不能修改。

·资产名称和资产类型创建后不能修改，资产描述可以修改。

·版本内容创建后不能覆盖；内容变化需要创建新版本。

·latest 由系统维护，不能手动修改。

·stable 首次绑定后不能解除，只能移动到另一个已审批且内容校验成功的版本。对于 Skill 压缩包，内容校验成功表示压缩包已经上传并通过系统校验。

·删除注册中心或资产会使其不再出现在正常管理和发现流程中，但审计历史会保留。

·请勿在名称、描述、资产定义、变更说明或上传文件中写入密码、访问令牌、密钥等敏感信息。