配置 A2A 服务并对外提供 Agent

将已发布的内部 Agent 开放给第三方 Agent 调用。

例如,您可以对外提供客户简报 Agent,让第三方 Agent 根据已开放的能力生成客户简报。管理员负责关联 Agent、配置访问认证和启用服务;第三方接入人员根据您提供的接入信息完成授权并验证调用。

开始之前

  • 使用能够进入 管理后台 > A2A服务 并管理服务的管理员账号。
  • 确认要开放的内部 Agent 已发布,并核对计划对外提供的能力。
  • 与接入方确认调用是由用户登录并授权,还是由外部系统使用应用凭证发起。

1. 关联内部 Agent

  1. 在 管理后台 > A2A服务 中,点击 新建服务。服务列表展示对外 Agent 名称、服务类型、状态和关联 Agent,可按状态筛选,也可按对外 Agent 名称或描述搜索。
    A2A 服务列表与新建服务入口

  2. 在 关联内部Agent 中,选择已发布的 Agent,例如 客户简报Agent。系统读取所选 Agent 的名称和描述,并带入配置页。
    新建服务的关联内部 Agent 页面

  3. 核对 对外Agent名称 和 Agent 描述。名称用于接入方识别 Agent;描述应说明 Agent 能完成的任务。页面还会显示 Agent Card 地址。
    选择客户简报 Agent 后的名称、描述和 Agent Card 地址

  4. 点击 下一步,进入 访问认证。

2. 配置访问认证

在 允许的认证方式 中,按接入方的调用场景选择认证方式。

认证方式 适用场景 接入方如何完成授权
用户身份授权(PKCE) 用户在第三方客户端发起任务,需要将操作追溯至具体用户 用户登录账号并同意授权;接入客户端配合完成 PKCE(S256)授权流程后发起调用
应用身份授权(Client Credentials) 外部系统自动发起任务,无需用户逐次登录 外部系统使用平台签发的应用凭证,例如应用 API ID 和对应密钥,完成应用身份授权后发起调用

访问认证与保存、启用入口

3. 保存配置或启用服务

操作 服务状态 何时使用
保存配置 停用 先保存并进入详情,核对对外信息和能力,稍后再启用
启用对外服务 启用成功后为 启用 配置已核对,希望立即开放服务

服务保存后可在 A2A服务 列表中找到。选择 保存配置 后,详情页已经显示地址并可预览能力,但服务仍为 停用,第三方不能调用。准备就绪后,在详情页点击 启用。

保存配置后处于停用状态的服务详情

4. 预览能力并交付接入信息

  1. 在服务详情页,核对 服务状态、关联内部Agent 和右侧 Agent 能力说明。

  2. 点击 预览能力声明。在 Agent Card · 对外名片预览 中,核对对外名称、描述和各项能力的适用场景。例如,客户简报 Agent 可提供交接、高层陪访、见客前和标准版客户简报,具体以当前能力声明为准。
    Agent Card 对外名片预览与能力说明

  3. 确认服务已启用后,复制 Agent Card 地址 和 调用地址,并将服务的认证方式和接入信息提供给第三方接入人员。对接时使用当前服务详情页复制的地址。

地址 用途
Agent Card 地址 获取 Agent 的对外声明,了解其名称、描述和公开能力
调用地址 第三方在完成相应授权后,向此地址发起 A2A 请求

5. 验证调用和调整配置

  1. 在 A2A服务 列表中确认目标服务状态为 启用,且关联的是预期的内部 Agent。
  2. 请接入方使用对应认证方式,从支持 A2A 的客户端发起一项已声明的任务。例如,调用客户简报 Agent 生成一份标准版客户简报,并确认返回结果符合该能力的用途。

如果接入方能读取能力声明却无法调用,先核对服务是否启用、两种地址是否用在各自的场景,以及接入方是否完成了所选方式的授权。若需要修改启用中的服务,先在列表中点击 停用,再编辑配置。保存后核对变更,再重新启用。

相关主题

2026-11-12
0 0