Agent Runtime 创建与管理注册中心及资产

如何通过腾讯云控制台创建注册中心、登记资产,并完成资产查询、信息维护、操作日志查看和删除等日常管理操作。

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

一、前提条件

开始前,请确认:

·已登录腾讯云控制台,并具备注册中心及资产的相应管理权限。

·如果选择从 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 和公共示例地址,不应展示真实账号、内部域名或访问凭据。

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