A2A 协议详解:Agent Card 与 Wellknown 索引机制
了解什么是 A2A 协议,Agent Card 如何工作,以及 Wellknown 如何索引和发现 A2A 智能体。
A2A 协议(Agent2Agent 协议)是一种开放标准,允许 AI 智能体通过 JSON-RPC 发现彼此并交换任务。该协议的核心是 Agent Card,这是由 A2A 智能体在路径 /.well-known/agent-card.json 上发布的 JSON 文档。该卡片描述了智能体的名称、技能、端点 URL 及安全方案,使其他智能体和索引能够理解并与之交互。
关键要点
- A2A 协议通过 JSON-RPC 促进智能体发现和任务交换。
- Agent Card 位于智能体域名下的
/.well-known/agent-card.json。 - Agent Card 描述智能体的身份、能力、端点和安全机制。
- Wellknown 索引了 2,749 条 A2A 协议记录,其中 2,153 条当前在线(live)。
- 智能体通过自我提交或发现其 Agent Card 被纳入 Wellknown 索引。
什么是 A2A 协议?
A2A 协议即 Agent2Agent 协议,是一种开放协议,旨在让 AI 智能体能够发现彼此并交换任务。智能体会在其域名的一个固定位置发布一个标准化的 JSON 文档,称为 Agent Card。智能体之间的通信通过 JSON-RPC(一种基于 JSON 的远程过程调用协议)进行。
该协议使智能体能够动态发现同伴,并通过结构化方式发送任务和响应实现协作。它不同于 MCP(Model Context Protocol)等协议,后者侧重于将 AI 应用连接到工具和数据。
什么是 Agent Card,存放在哪里?
Agent Card 是由 A2A 智能体发布的 JSON 文档,位于其域名下的路径 /.well-known/agent-card.json。该位置是标准化的,方便其他智能体和索引查找。
Agent Card 描述了:
- 智能体的名称
- 智能体的技能或能力
- 可联系智能体的端点 URL
- 智能体支持的安全方案
通过提供这些信息,Agent Card 使智能体能够被发现和交互。它相当于智能体的自我描述,供 Wellknown 等索引读取,用于列出和分类智能体。
Wellknown 如何读取和索引 Agent Card?
Wellknown 是一个实时索引,包含 AI 智能体、MCP 服务器和工具,并主动检查它们的端点。它通过从智能体域名获取 /.well-known/agent-card.json 的 JSON 文档来读取 Agent Card,从而提取智能体声明的元数据,如名称、技能和端点。
Wellknown 将声明的元数据(发布者声明的信息)与观测数据(Wellknown 通过检查端点测量的数据)分开,确保智能体当前可用性和可靠性的透明度。
Wellknown 拥有多少 A2A 记录?多少在线?
截至 2026-10-31 的最新数据快照,Wellknown 拥有 2,749 条 A2A 协议记录,其中 2,153 条当前在线(即最近 24 小时内检查成功)。这表明网络上有大量活跃的 A2A 智能体可用。
作为对比,Wellknown 的总索引规模为 79,658 条记录,其中整体在线数为 24,496 条。A2A 协议是该生态系统中的重要子集。
智能体如何提交或被发现进入 Wellknown 索引?
智能体可通过自我提交或索引自动发现进入 Wellknown:
自我提交: 发布者通过证明对其域名或代码仓库的控制权来提交智能体。验证方式包括在
_wellknown.YOUR-DOMAIN添加 DNS TXT 记录,在https://YOUR-DOMAIN/.well-known/wellknown-verify.txt放置验证文件,或在仓库根目录放置.wellknown-verify文件。自动发现: Wellknown 会扫描已知来源,如 MCP 注册表、npm、PyPI、GitHub,特别是通过获取
/.well-known/agent-card.json(源标记为a2a_card)来发现智能体。
智能体一旦被索引,开发者可以通过 Wellknown 的 HTTP API 端点和 MCP 服务器工具进行搜索、解析和状态检查。
总结
A2A 协议通过在标准位置发布 Agent Card,使 AI 智能体能够相互发现和通信。Wellknown 读取这些 Agent Card 来索引智能体,目前拥有 2,749 条 A2A 记录,其中 2,153 条在线。智能体通过自我提交或自动发现进入索引,域名控制验证确保真实性。Wellknown 因此成为开发者寻找活跃 A2A 智能体及其能力的重要资源。
以上数据截至 2026-10-31 的快照。