Skip to main content
集成 Agent

A2A 协议接入

通过 A2A（Agent2Agent）协议，可以让支持 A2A 的客户端或其他 Agent 调用 Forward Template。Forward 支持 0.3 和 1.0 两个协议版本，使用 JSON-RPC，流式响应使用 SSE。

1. 启用 Template 的 A2A 接入

通过更新 Template接口，将 a2a.enabled 设置为 true，并配置 Agent Card 中展示的描述和能力： POST /api/v1/forward/templates/{template_id} 
{
  "a2a": {
    "enabled": true,
    "description": "总结文本并提取行动项",
    "skills": [
      {
        "id": "summary",
        "name": "文本总结",
        "description": "总结调用方提供的文本",
        "tags": ["summary"],
        "examples": ["总结这段会议记录"]
      }
    ]
  }
}
A2A 默认关闭。skills 用于描述 Agent Card 中展示的任务能力。字段说明见创建 Template — A2A。 也可以在控制台的 Template「集成 → A2A」中开启 A2A，配置描述和能力，然后保存。

2. 获取 Agent Card URL

Agent Card URL 使用固定格式，可根据 API 基础地址、Template ID 和认证方式直接构造。 使用 PAT 时，在 URL 中指定运行 Identity： 
<API_BASE_URL>/api/v1/forward/templates/{template_id}/a2a/agent-card.json?identity_id={identity_id}
使用 SAT 时，Agent Card URL 为： 
<API_BASE_URL>/api/v1/forward/templates/{template_id}/a2a/agent-card.json
将 {template_id}、{identity_id} 替换为实际 ID；identity_id 查询参数需进行 URL 编码。客户端从返回的 Agent Card 读取调用地址。 也可以在控制台的 Template「集成 → A2A」中复制 Agent Card URL，或使用「检查 Agent Card」确认 Card 可访问。

3. 配置客户端

配置项说明
Agent Card URL按上述格式构造或从控制台复制的地址，获取 Card 时需携带认证凭据。
认证Authorization: Bearer <PAT 或 SAT>；获取 Card 和后续调用都需要携带。
协议版本通过 A2A-Version: 0.3 或 A2A-Version: 1.0 选择；不传时默认使用 0.3。客户端应使用匹配版本的协议格式。
运行 Identity使用 PAT 时，通过 Card URL 的 identity_id 指定；返回的调用地址会保留该参数。
调用方需具有目标 Workspace、Template 和运行 Identity 的访问权限。令牌获取及使用要求见认证。

接入说明

  • 关闭 Template A2A 会保留 Card 配置，拒绝新调用，但不会自动取消已受理任务。
  • 网络断开或请求超时不代表任务被取消。客户端应保存 Task ID，查询任务或重新订阅；A2A 订阅返回任务当前快照和后续更新，不支持通过 Last-Event-ID 回放历史事件。
  • 支持消息发送、流式输出、任务查询、取消和订阅；任务列表仅支持 1.0。不支持 Push Notifications 和 Extended Agent Card。

官方协议文档