Hermes A2A:双向协议、活动会话与能力边界
Hermes A2A:双向协议、活动会话与能力边界
为什么值得用户深挖
知识轴:A2A / harness-runtime / sandbox-security,最高优先。 用户当前运行的正是 Hermes;旧wiki中“未来若接入A2A”的假设已过时。官方文档表明A2A是已有的双向插件,但本机并未启用:2026-09-26 hermes tools list --platform cli 显示a2a disabled,本机配置文本未见 a2a:;不能把代码已合并误作当前对外服务已部署。官方PR #77109 的合并时间为2026-08-02,今天是补库/纠旧认知,不是今日新发布。^[raw/articles/hermes-a2a-official-docs-text-2026-09-26.md]
机制:协议绑定和本机执行的接缝
- 发现不等于调用。 inbound Card 在
/.well-known/agent-card.json(兼容旧路径),技能来自启用的工具集;POST /是v1 JSON-RPC的SendMessage等方法,兼容早期path-style alias;stream经SSE,push用HMAC签名。outbound工具集单独按平台启用,提供discover/call/list/history/orchestrate。已发布文档主张Card解析、SendMessage及stream与官方Python SDK互通;本轮未本机重跑SDK/TCK。^[raw/articles/hermes-a2a-official-docs-text-2026-09-26.md] - 状态和执行并非纯远端转发。 inbound task注入活动gateway会话,沿用该实例的memory/tools,以contextId维持多轮;因此到达的peer文本可能影响具副作用的本地工具。peer不是用户本人,Card skill广告也不是当前请求授权。
a2a_orchestrate的best在合并PR描述里仅以回复长度作粗略启发式,不是结果验证;跨机器优先A2A,同机多agent可选in-process delegation/kanban。^[raw/articles/hermes-a2a-official-docs-text-2026-09-26.md] - 安全须分层验。 官方文档:无token默认仅bind loopback;远程需要显式token及A2A_HOST;可用逐peer token映射身份、trusted-peers/allow-all门、每身份限速、文本过滤、敏感串出站脱敏、审计文件与每context anti-loop。它们不证明Card来源可信、prompt injection不可能、响应脱敏完整、MCP后端权限继承正确、或远端task一定完成。PR提到upstream-auth覆盖allow-list、tenant隔离、forwarded host及SSRF-guarded push;实际部署必须核具体代码版本/最终配置,代理头不能任意信任。^[raw/articles/hermes-a2a-official-docs-text-2026-09-26.md]
与旧概念的关系和可执行小试验
A2A-Agent2Agent-Protocol 的Card hash/绑定协商、MCP-Gateway-Runtime 的入口主体到backend凭据、Harness-Engineering 的TaskHandle及审计要串成同一次试验。若将来选择启用,先在隔离loopback且无生产凭据环境检查:Card实际advertised URL/能力;token缺失及错误token拒绝;已认证peer是否严格限制可调用工具;GetTask跨peer访问拒绝;stream断连后GetTask结果及终态;push目标SSRF负例和认证审计关联。保存 Card hash、配置快照、contextId/taskId、caller身份、实际工具effect与回执;不能仅凭官方PR测试表或文档说本机通过。
失败模式/未决
当前运行CLI禁用a2a,不等于其他平台或其他机器全部禁用;尚未读取本地插件源码/真实服务端口与端到端。A2A_PUBLIC_URL 和反向代理头若不匹配实际路由,Card可读但回调不可达;共享token会丢逐peer身份;把过滤当授权或把活动会话视为天然租户隔离可能造成越权。PR报告的151单测、17集成与SDK E2E是作者回执,不是本轮复现。重要不在新工具发布,而在旧wiki可操作性由“假想集成”变成“已有但未启用的明确验收合同”。
写入记录
- 2026-09-26 09:03 CST:基于Hermes官方A2A文档、合并PR与本机只读工具集检查,纠正未来态假设并制定隔离验收边界。