将已发布的内部 Agent 开放给第三方 Agent 调用。
例如,您可以对外提供客户简报 Agent,让第三方 Agent 根据已开放的能力生成客户简报。管理员负责关联 Agent、配置访问认证和启用服务;第三方接入人员根据您提供的接入信息完成授权并验证调用。
开始之前
- 使用能够进入 管理后台 > A2A服务 并管理服务的管理员账号。
- 确认要开放的内部 Agent 已发布,并核对计划对外提供的能力。
- 与接入方确认调用是由用户登录并授权,还是由外部系统使用应用凭证发起。
1. 关联内部 Agent
-
在 管理后台 > A2A服务 中,点击 新建服务。服务列表展示对外 Agent 名称、服务类型、状态和关联 Agent,可按状态筛选,也可按对外 Agent 名称或描述搜索。
-
在 关联内部Agent 中,选择已发布的 Agent,例如 客户简报Agent。系统读取所选 Agent 的名称和描述,并带入配置页。
-
核对 对外Agent名称 和 Agent 描述。名称用于接入方识别 Agent;描述应说明 Agent 能完成的任务。页面还会显示 Agent Card 地址。
-
点击 下一步,进入 访问认证。
2. 配置访问认证
在 允许的认证方式 中,按接入方的调用场景选择认证方式。
| 认证方式 | 适用场景 | 接入方如何完成授权 |
|---|---|---|
| 用户身份授权(PKCE) | 用户在第三方客户端发起任务,需要将操作追溯至具体用户 | 用户登录账号并同意授权;接入客户端配合完成 PKCE(S256)授权流程后发起调用 |
| 应用身份授权(Client Credentials) | 外部系统自动发起任务,无需用户逐次登录 | 外部系统使用平台签发的应用凭证,例如应用 API ID 和对应密钥,完成应用身份授权后发起调用 |
3. 保存配置或启用服务
| 操作 | 服务状态 | 何时使用 |
|---|---|---|
| 保存配置 | 停用 | 先保存并进入详情,核对对外信息和能力,稍后再启用 |
| 启用对外服务 | 启用成功后为 启用 | 配置已核对,希望立即开放服务 |
服务保存后可在 A2A服务 列表中找到。选择 保存配置 后,详情页已经显示地址并可预览能力,但服务仍为 停用,第三方不能调用。准备就绪后,在详情页点击 启用。
4. 预览能力并交付接入信息
-
在服务详情页,核对 服务状态、关联内部Agent 和右侧 Agent 能力说明。
-
点击 预览能力声明。在 Agent Card · 对外名片预览 中,核对对外名称、描述和各项能力的适用场景。例如,客户简报 Agent 可提供交接、高层陪访、见客前和标准版客户简报,具体以当前能力声明为准。
-
确认服务已启用后,复制 Agent Card 地址 和 调用地址,并将服务的认证方式和接入信息提供给第三方接入人员。对接时使用当前服务详情页复制的地址。
| 地址 | 用途 |
|---|---|
| Agent Card 地址 | 获取 Agent 的对外声明,了解其名称、描述和公开能力 |
| 调用地址 | 第三方在完成相应授权后,向此地址发起 A2A 请求 |
5. 验证调用和调整配置
- 在 A2A服务 列表中确认目标服务状态为 启用,且关联的是预期的内部 Agent。
- 请接入方使用对应认证方式,从支持 A2A 的客户端发起一项已声明的任务。例如,调用客户简报 Agent 生成一份标准版客户简报,并确认返回结果符合该能力的用途。
如果接入方能读取能力声明却无法调用,先核对服务是否启用、两种地址是否用在各自的场景,以及接入方是否完成了所选方式的授权。若需要修改启用中的服务,先在列表中点击 停用,再编辑配置。保存后核对变更,再重新启用。