A2AP 智能体互通协议

要解决什么问题

多 Agent 协作时，进程或实例之间往往各写一套消息格式、鉴权与路由逻辑，联调成本高，也难以在团队外复用。A2AP（Agent-to-Agent Protocol）把 Agent 间通信 收成一套可实现的开放协议：强调「不是白皮书，是代码」，在统一语义下提供可落地的 Python API 与规范文档。

协议如何工作

整体采用 四层架构（具体分层见仓库内规范与实现），消息在发送侧按协议封装，接收侧按同一套规则解析与校验。

信任与完整性方面，每条消息带 HMAC-SHA256 签名，降低篡改风险；通过 trust_peer() / is_trusted() 维护 信任白名单，未信任对端可按策略拒绝或降级处理。传输层可叠加 TLS，在需要时补足链路加密。

完整协议说明见 A2AP-whitepaper.md（CC BY-SA 4.0）；实现代码为 MIT 许可，便于嵌入自有 Agent 运行时或网关。

适用边界与注意点

• 适合需要 标准化 Agent 对 Agent 消息、并要在代码里直接集成的场景；不是通用 RPC 框架的替代品，也不替代你现有的业务编排层。
• 白名单与签名是协议侧能力，身份发放、密钥轮换、跨租户策略 仍需在上层系统自行设计。
• 与其它 Agent 框架对接时，以白皮书与当前 Python API 的行为为准，版本演进请对照仓库变更。