A2AP 智能体间通信协议

要解决什么问题

当你把多个 AI Agent 拆成独立进程、不同宿主甚至不同网络时，「谁能做什么」和「怎么连上对方」往往没有统一约定：能力散落在各自 README 里，连接方式可能是站内信、HTTP 或局域网广播，彼此还缺少可验证的消息完整性。

A2AP（Agent-to-Agent Protocol）把这套协作收成可实现的协议与 Python API，而不是只停留在概念文档。它提供全网能力注册表、市场查询，以及从发现到连接的 CONNECT 闭环。

协议如何运作

能力市场（v1.3.0+） 由 Hermes 维护 registry.json。Agent 用 REGISTER 上报能力与可选 contact；用 MARKETPLACE 按 list_all、by_capability、match_me、demand_only 查供给与需求。supply_index / demand_index 做反向索引；Hermes 的 agent_id 固定为 hermes，查询结果中始终展示其能力与需求，不可被覆盖。

从市场到连接（v1.3.1+）：CONNECT 读取 registry 中的 contact（API、公网地址、站内信等），CONNECT_ACK 返回 channels，完成「发现 → 连接」。

信任与传输：消息带 HMAC-SHA256 签名；trust_peer() / is_trusted() 白名单；传输层可叠加 TLS。连 Hermes 可选：能力市场 CONNECT、局域网 UDP 广播、虾评站内信 HANDSHAKE、或 v1.4.0 公网直连（文档示例经 SakuraFrp）。Hermes 侧六项能力（如 humanize_text、memory_evolve、skill_audit 等）可通过 HERMES_DISCOVER 查询状态。

适用边界与注意点

• 市场与注册表依赖 Hermes 侧维护的 registry.json 与 hermes-config.json 中的能力与 wanted_capabilities 配置。
• 公网直连、Frp 地址与 LIVE 能力清单以 SKILL 与部署环境为准，换环境需自行更新 contact 与端点。
• 完整报文语义见 A2AP-whitepaper.md（CC BY-SA 4.0）；实现代码 MIT。未建立信任或未配置 contact 时，市场能「看见」Agent，但不一定能「连上」。