一、前提条件
开始前,请确认:
·已登录腾讯云控制台,并具备注册中心及资产的相应管理权限。
·如果选择从 URL 同步,目标服务已提供可访问的标准发现地址。
·如果选择手动定义,已经准备好符合对应协议的元数据、SKILL.md、压缩包或自定义结构化内容。
·待登记内容中不包含密码、访问令牌、密钥、个人身份信息或内部环境地址等敏感信息。
二、创建注册中心
1. 登录腾讯云控制台,进入 Agent Runtime > 注册中心。
2. 单击创建第一个注册中心,在创建注册中心页面填写配置项。
| 配置项 | 是否必填 | 说明 |
| 名称 | 是 | 用于标识注册中心。同一账号、同一地域内不能重名,创建后不能修改。 |
| 描述 | 否 | 建议说明所属团队、管理范围和主要用途,创建后可以修改。 |
| 审批方式 | 否 | 默认为自动审批,也可以选择人工审批;创建后不能修改。注意:控制台默认选择自动审批。如果尚未建立正式审批流程,可以先使用默认配置完成体验;生产环境应根据团队治理要求选择审批方式。审批方式创建后不能修改。 |
| 腾讯云标签 | 否 | 用于资源分类和筛选。当前版本支持创建时配置。腾讯云标签需要满足以下约束:每个注册中心最多设置 10 个标签,标签键不能重复。标签键长度为 1–127 个字符,标签值长度为 1–255 个字符,首尾不能包含空格。标签键和值支持字母、数字、空格及 +、-、=、.、_、:、/、@、(、)。标签键不能以 qcs:、project(不区分大小写)或 项目 开头。 |
以人工审批为例:
3. 单击创建注册中心。
4. 创建完成后,在列表中确认名称、审批方式、资产数量和更新时间等信息。
三、登记资产
进入目标注册中心,单击创建资产。控制台提供从 URL 同步和手动定义两种方式。
四、从 URL 同步
从 URL 同步适用于 MCP Server、A2A Agent 和 AG-UI Agent。对于 MCP Server 和 A2A Agent,系统会读取协议元数据;对于 AG-UI Agent,系统会校验并探测服务地址,根据地址生成连接描述。以上内容用于生成资产的首个版本。AG-UI Agent 当前仅支持首次创建,不支持创建后的更新预览或再次同步。
1. 在创建资产面板中选择 从 URL 同步。
2. 选择资产类型。
3. 填写资产名称。名称用于在注册中心中识别该资产,创建后不能修改。
4. 根据需要填写版本别名和资产描述。
5. 填写资产的发现地址。
6. 检查页面识别出的内容,确认后创建资产。
以下示例展示 MCP Server 的 URL 同步表单。图中的地址和名称仅为示例,请替换为实际服务信息:
请确保发现地址满足以下要求:
·可由注册中心访问,不依赖仅本机可见的地址。
·返回与所选资产类型匹配的标准协议内容。
·URL 中不包含明文凭据或其他敏感查询参数。
创建完成后,系统会同时生成首个版本。自动审批模式下,内容校验成功后版本会自动通过审批;人工审批模式下,版本需要管理员处理后才能发布。
五、手动定义
手动定义适用于全部资产类型。
1. 在创建资产面板中选择手动定义。
2. 选择资产类型。
3. 填写资产名称,并根据需要填写版本别名和描述。
4. 按表选择对应方式并填写内容。
| 资产类型 | 可用方式 |
| MCP Server | 手动填写元数据,或选择 JSON 文件。 |
| A2A Agent | 手动填写 Agent Card,或选择 JSON 文件。 |
| AG-UI Agent | 手动填写协议元数据,或选择 JSON 文件。 |
| Skill | 手动填写 SKILL.md,或上传压缩包。 |
| 自定义资产 | 手动填写结构化内容,或选择 JSON 文件。 |
5. 确认内容符合对应规范后,单击确定。
上传 Skill 压缩包后,系统需要完成上传与内容校验。只有校验成功后,版本才能完成审批和发布。
六、查询和筛选资产
进入注册中心详情页后,可以在资产管理页签中:
·查看资产名称、资产 ID、描述、状态、类型和更新时间。
·按资产类型筛选列表。
·按名称或关键字搜索资产。
·查看资产总数和已发布资产数。
·单击 查看 进入资产详情页,查看基本信息、版本列表和版本内容。
“已发布资产数”统计已经存在稳定版本的资产数量,不等同于全部版本数量。
七、修改注册中心描述
1. 进入注册中心详情页。
2. 在基本信息区域找到描述,单击编辑图标。
3. 修改描述并保存。
注册中心名称和审批方式不能修改。如需使用不同的名称或审批方式,应创建新的注册中心。
八、修改资产描述
1. 在资产列表中找到目标资产。
2. 在描述列单击编辑图标。
3. 修改描述并保存。
资产名称和资产类型不能修改。需要修改协议内容、来源地址或 Skill 内容时,请创建新版本。
九、查看操作日志
进入注册中心详情页,选择 操作日志 页签,可以查看该注册中心及其资产的操作记录,包括:
·操作类型
·变更说明
·关联的资产 ID 和版本 ID
·操作人
·操作时间
资产详情页也提供操作日志入口,可用于查看与单个资产相关的版本和审批记录。
十、删除资产
1. 在资产列表中找到目标资产。
2. 单击删除。
3. 核对资产名称和影响范围,确认后完成删除。
删除资产后,该资产不再出现在正常的管理和发现流程中。历史版本、标签和操作日志仍会保留用于审计,但当前版本不提供从控制台恢复已删除资产的入口。
十一、删除注册中心
1. 返回注册中心列表。
2. 找到目标注册中心,单击删除。
3. 确认该注册中心及其资产已不再使用,再完成删除。
删除注册中心后,其下资产将不再参与正常的管理和发现流程。删除前建议先核对资产清单及使用情况,并保留必要的变更记录。
十二、结果验证
完成创建和管理操作后,建议检查:
·注册中心列表中可以看到新建的注册中心及正确的审批方式。
·资产管理页中可以看到已登记资产及正确的资产类型。
·资产详情页中已经生成首个版本。
·自动审批注册中心的首个校验成功版本显示为已通过,并带有 stable 和 latest 标签。
·人工审批注册中心的首个版本显示为待审批,完成审批前不计入已发布资产数。
·操作日志中可以查到本次创建和后续变更记录。
十三、注意事项
·注册中心名称、审批方式、资产名称和资产类型创建后不能修改。
·当前版本只支持在创建注册中心时配置腾讯云标签,创建后不能在注册中心页面继续编辑标签。
·从 URL 同步会读取远端元数据,但不会替你验证资产的业务功能、调用凭据或网络策略。
·删除前应确认资源不再使用;删除操作不会清除审计历史。
·示例或截图中应使用虚构名称、占位资源 ID 和公共示例地址,不应展示真实账号、内部域名或访问凭据。