A2A 协议：当您的 AI Agent 需要彼此沟通

单一 AI agent 可以自动化一项任务。但真正的业务流程跨越系统、团队和组织。您的销售自动化需要来自市场研究 agent 的资料。您的合规 workflow 需要法律分析 agent 的判定结果。您的客服流程需要调用帐务系统 agent 来处理退款。

Agent-to-Agent (A2A) 协议让这一切成为可能。JieGou 现已双向支援 A2A：从您的 workflow 调用外部 agent，同时也能将您自己的 recipe 和 workflow 发布为其他人可以调用的 agent。

什么是 A2A？

A2A 是一种协议，让 AI agent 能够彼此探索、验证身份并相互调用。它建立在一个简单的概念上：agent 在一个已知的 URL 发布自身能力的描述，其他 agent 则使用该描述来发送任务。

Agent 的能力透过 Agent Card 来描述——一个发布在 /.well-known/agent.json 的 JSON 文件。这张卡片列出了 agent 的技能、输入/输出结构描述、身份验证要求和端点 URL。您可以把它想像成机器可读的 API 规格，但对象是 AI agent 而非 REST 端点。

从 workflow 调用外部 agent

JieGou 新增了一种 workflow 步骤类型：A2A Step。将它加入 workflow 中，指向一个已注册的 agent，将您的 workflow 资料对应到该 agent 的输入结构描述，该步骤就会在执行时调用外部 agent。

执行流程如下：

1. 探索。 透过提供 Agent Card URL 来注册外部 agent。JieGou 会撷取该卡片、验证其内容，并将 agent 的能力储存在登录档中。健康检查会确认 agent 是否可达（10 秒逾时）。

2. 配置。 在 workflow 编辑器中新增 A2A 步骤。选择已注册的 agent、选择一项技能，并将前一步骤的输出对应到 agent 预期的输入栏位。

3. 执行。 当 workflow 运作时，A2A 步骤会向外部 agent 的端点发送任务请求。JieGou 会以可配置的逾时和重试设定轮询结果。

4. 结果处理。 Agent 的输出会储存在 workflow 上下文中，供下游步骤使用，就像任何其他步骤的输出一样。如果 agent 失败，该步骤会遵循您的 workflow 错误处理策略——重试、跳过或中止。

A2A 步骤与 workflow 引擎中的所有其他功能整合：核准闸道、检查点、平行分支、条件逻辑和错误处理都能正常运作。

将您的 recipe 发布为 agent

反向操作同样重要。JieGou 中的任何 recipe 或 workflow 都可以发布为相容 A2A 的 agent。

当您建立一个托管 agent 时，JieGou 会：

1. 产生一组 API 金钥（以明文回传一次，以 SHA-256 杂凑值储存）
2. 发布一张 Agent Card，将您的 recipe 输入/输出结构描述对应到 A2A 技能定义
3. 建立一个接受 A2A 任务请求的端点

外部系统可以透过 Agent Card 探索您的 agent、使用 API 金钥进行身份验证并提交任务。JieGou 会执行底层的 recipe 或 workflow，并以 A2A 格式回传结果。

这意味着您精心调校、测试过、具有版本控制的 recipe 能够成为可调用的服务——无需建构独立的 API、撰写部署脚本或管理基础设施。

信任与身份验证

并非所有 agent 都具有相同的信任等级。JieGou 为每个已注册的 agent 指定一个信任层级：

• Verified — 经 JieGou 核准，已审核其可靠性
• Community — 由其他 JieGou 使用者注册，经同侪验证
• Self-hosted — 您自行运作的 agent
• Unknown — 未经验证的外部 agent

身份验证支援 API 金钥、Bearer Token 和 OAuth2。凭证在静态时加密储存，仅在调用时才解密。

稽核轨迹

每一次 A2A 调用——无论是入站或出站——都会记录以下资讯：

• 方向 — JieGou 是调用了外部 agent，还是接收了一个任务
• Agent 和任务 ID — 用于跨系统关联
• 输入与输出预览 — 为保护隐私而截断，但足以用于除错
• 来源中继资料 — IP 位址、使用者代理程式、呼叫者身份
• 耗时 — 以毫秒为单位的持续时间
• 状态 — 已提交、处理中、已完成、失败或已取消
• Workflow 连结 — 如果该调用是 workflow 的一部分，则提供直接连结到该 workflow 执行记录

稽核日志可依帐户、方向、状态和时间范围进行查询和筛选。当外部 agent 失败时，您可以追踪确切的请求与回应，无需猜测问题所在。

何时使用 A2A

A2A 在以下情境最具价值：

• 您需要自己没有的能力。 您的公司有一个内部的机器学习模型用于诈欺侦测。将它发布为 A2A agent，您的 JieGou workflow 就能原生调用它。

• 您正在建构多 agent 系统。 不同团队负责不同的自动化。A2A 让它们能在不紧密耦合的情况下组合——销售团队的潜在客户评分 agent 可以将结果输入行销团队的行销活动 agent。

• 您希望将自动化作为服务提供。 将您最佳的 recipe 发布为托管 agent。合作伙伴或其他部门无需 JieGou 帐户即可调用它们。

• 您正在与第三方 agent 平台整合。 任何支援 A2A 协议的平台都能与 JieGou 互通——无需自订整合。

可用性

A2A 协议支援——包含入站和出站——适用于企业方案。托管 agent 建立、外部 agent 注册以及完整的稽核轨迹均已包含在内。了解更多企业功能或申请展示。