Agent Skills
返回列表
🤖

Hermes A2A 互联

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_4c293371/hermes-a2a。

技能介绍

要解决什么问题

WorkBuddy 侧没有内置 A2A(Agent-to-Agent) 客户端,而本机 Hermes 已通过 gateway.platforms.a2a 暴露标准服务端(Google A2A v1.0,默认 127.0.0.1:9900)。若要在同一台机器上让 WorkBuddy 把用户指令当成任务发给 Hermes、并把回复带回对话,就需要一条经过验证的配置路径、端点自检方式,以及不依赖第三方包的 Python 调用实现。

技能如何工作

本技能围绕 WorkBuddy → 本地 Hermes 的单机链路组织工作流:

  • 在 %HERMES_HOME%\config.yaml 的 顶层 gateway.platforms 下启用 A2A(与 agent.platforms 的 Telegram/Discord 流式配置区分开)。
  • 说明如何通过 系统托盘彻底退出再启动 Hermes,让网关守护进程重新加载配置(仅关桌面窗口无效)。
  • 用 Hermes 自带的 venv Python 跑配套客户端:拉取 /.well-known/agent-card.json(--card)、message/send 端到端测试,并用 --context 做 Hermes 侧保留上下文的多轮对话。
  • 客户端兼容 v1.0 的 message.parts[].text 与 artifacts 两种回复,并在 message/send 失败时回退到旧版 SendMessage。

日常等价行为:用户说「给 Hermes 发个任务」时,用其指令作为消息执行客户端,将标准输出中的回复交还给用户。

边界与注意点

  • 范围:仅同机 127.0.0.1;未配置 token 时 Hermes 只监听 localhost,通常无需鉴权。
  • 重启:WorkBuddy 沙箱无法结束宿主上的网关进程,智能体不能代你重启网关,需你手动托盘退出再开;不建议依赖旧版 gateway run --replace。
  • 排错:「A2A 没响应」时先查 9900 是否监听、Agent Card 是否可访问,并区分桌面 backend 与承载 A2A 的网关进程。

使用场景

  • 在 WorkBuddy 里接到「帮我和本机 Hermes 说一下」时,需要先确认 A2A 已启用并能拉到 Agent Card。
  • 用户要把一段具体指令交给 Hermes 执行,而不是只在 WorkBuddy 里闲聊,需要走 JSON-RPC `message/send` 并把回复原文带回。
  • 多轮排查 Hermes 行为时,需要用 `--context` 让上下文留在 Hermes 侧,避免每轮从零开始。
  • 同事反馈「9900 没监听 / A2A 没响应」时,按技能里的网关重启与进程区分步骤做定向排错。

适合人员

  • 本机同时跑 Hermes 与 WorkBuddy、希望用自然语言触发 Hermes 任务而不是手动开 Hermes 界面的工程师
  • 负责维护 `%HERMES_HOME%\config.yaml` 里 `gateway.platforms.a2a`,需要知道为何要托盘退出才能生效的配置维护者
  • 在 Windows 上首次打通 WorkBuddy 与 Hermes A2A、要对照 Agent Card 与端到端发送步骤做验收的集成调试人员
  • 遇到网关只重开窗口仍用旧配置、需要在文档约束下停止依赖 `--replace` 自行重启的操作者