:::note 本功能仅私有化版本支持，公有云版本暂不提供。 :::
A2A（Agent-to-Agent）用于在生态服务管理模块中统一接入和管理外部智能体。管理员可以在这里新增外部智能体，也可以通过 A2A 目录同步批量发现并注册已接入的智能体。
进入方式
管理员进入生态服务管理模块，打开“A2A”页面即可进行配置。
支持接入的智能体
当前支持接入按 A2A 协议对外提供智能体服务的平台。接入外部智能体时，需要填写该智能体的 A2A 协议访问地址，并按实际能力勾选能力标签。
可以配置什么
页面支持管理以下内容：
- 外部智能体的接入信息
- 能力标签
- A2A 目录同步
- 统一调度规则
- 协同执行开关
- 协议校验面板
- 调度日志
1. 新增外部智能体
在新增页面中，先选择平台类型，再填写外部智能体的 A2A 协议访问地址。
可以勾选的能力标签包括：
- 问答
- 检索
- 工具调用
- 工作流
保存后，系统会对访问地址和基础信息进行校验。建议你根据外部智能体的实际能力填写标签，避免后续调度不准确。
2. 目录同步
如果外部智能体已经接入 A2A 目录，可以使用目录同步功能自动发现并注册。
目录同步适合以下场景：
- 批量新增已接入的外部智能体
- 更新已有智能体的基础信息
- 同步智能体的版本变化
同步后，系统会展示可纳管的智能体信息，管理员确认后即可完成注册或更新。
3. 统一调度
你可以为已纳管的外部智能体配置统一调度规则，让系统把任务分配给更合适的智能体。
常见的调度方式包括：
- 按能力类型分配
- 按负载状态分配
- 按优先级分配
如果开启协同执行，外部智能体可以与本地智能体一起参与混合编排；关闭后，系统按当前纳管规则单独调度外部智能体。
4. 协议校验与确认
页面提供协议校验面板，可用于检查外部智能体是否能够正常接入。
你可以重点确认以下内容：
- A2A 访问地址是否可用
- 能力标签是否与实际能力一致
- 同步后的基础信息是否正确
如果校验结果异常，建议先检查地址、授权信息和外部智能体的能力声明。
5. 连通性测试与日志
你可以一键测试外部智能体的连通性，并查看调用链路和执行结果。
调度日志适合用于：
- 查看任务分配给了哪个外部智能体
- 确认任务是否成功执行
- 排查超时、失败或返回异常的问题
使用建议
- 先准备好外部智能体的 A2A 访问地址，再进行纳管。
- 目录同步适合批量更新，手动新增适合单个接入。
- 先完成能力标签配置，再设置调度规则。
- 如果看不到某个外部智能体，先检查是否已经完成纳管或同步。