文档中心

AgentKit

A2A 智能体

注册智能体

A2A 智能体是遵循 A2A 协议、可被其他智能体发现和调用的服务，您可以将其注册至智能体空间供其他智能体调用，并实现对 A2A 智能体的统一管控。本文主要介绍注册 A2A 智能体前需要准备的内容及注册方式。

背景信息

在单智能体应用中，智能体通常只需要调用工具、知识库或模型即可完成任务。但在实际业务场景中，很多任务天然跨系统、跨角色、跨团队，例如“读取销售数据、生成分析报告、提交审批并通知群成员”。如果所有能力都写进一个智能体，会导致职责过重、维护困难，也不利于团队复用。

A2A 的目标是让不同智能体像服务一样协作。每个智能体可以专注一个稳定能力，例如数据分析、表格处理、文档生成、审批提交或消息通知。注册 A2A 智能体后，其他智能体可以通过 A2A 中心发现它，并根据 AgentCard 中声明的能力、地址和交互方式发起调用。

核心概念

概念	说明
A2A 智能体	可通过 A2A 协议被其他智能体发现和调用的智能体服务。
AgentCard	智能体对外暴露的能力说明文件，用于描述智能体名称、能力、服务地址、认证方式、输入输出等信息。
JSON 文件	以 JSON 形式维护的智能体描述文件，可作为注册智能体时的配置来源。
AgentCard 地址	可访问 AgentCard 的 URL，平台可通过该地址获取或更新智能体描述。

前提条件

注意

若您未主动创建智能体空间，智能体将注册至默认的Default空间。

智能体运行时：创建遵循 A2A 协议的智能体运行时。例如：通过 AgentKit CLI 预置的 a2a 协议模板，快速创建 Agent 项目，并将其部署为智能体运行时。了解更多

注意

JSON 文件示例参见 A2A 智能体 JSON 文件示例，文件中各字段的具体定义、取值范围及校验规则等规范要求，参见 A2A 协议官网文档。

操作步骤

智能体运行时

自定义

当您已在 AgentKit 中创建 A2A 智能体运行时，可以快速将其注册到智能体空间。

参数	说明
智能体运行时	选择目标 A2A 智能体运行时。
服务地址	选择智能体运行时后，自动匹配智能体运行时的服务地址，支持根据业务需求选择公网或私网地址。私网：适用于通过私有网络内部互访，私网连通不收取费用。公网：适用于通过互联网访问云资源。
AgentCard	智能体注册成功后，平台将自动展示该智能体对应的 AgentCard 详情，包含 ID、名称、协议版本、通信模式等核心属性，关联所属 A2A 智能体空间。

参数	说明
导入方式	选择导入智能体信息的方式。支持： JSON 文件：通过符合 A2A 标准的 JSON 信息导入智能体。请将 JSON 信息粘贴至 AgentCard 区域。 AgentCard 地址：通过 A2A 智能体的 AgentCard 地址导入智能体信息。
AgentCard 地址	选择通过 AgentCard 地址时，请在此填写目标 A2A 智能体的 AgentCard 地址，并单击“解析”按钮。
AgentCard	A2A 智能体对应的 AgentCard 详情。说明您可以按需在线修改智能体配置信息，并单击“解析 JSON”按钮可视化查看其版本、能力及技能等信息。