--- tags: [素材摘要] created: 2026-09-14 updated: 2026-09-14 sources: [raw/notes/2026-09-14-n8n调用hermes-agents工作流架构.md] source_type: notes source_path: raw/notes/2026-09-14-n8n调用hermes-agents工作流架构.md images: 0 image_paths: [] --- # n8n 调用 Hermes Agents 的工作流架构 > Hermes Agent 自带 OpenAI 兼容的 API Server，配合 Profile 多实例，n8n 用 HTTP Request 节点即可调用多个分工不同的专用 Agent，全程无需任何中间件。 ## 基本信息 - **来源类型**：笔记（Claude 对话剪藏，含实战终端记录） - **原文位置**：raw/notes/2026-09-14-n8n调用hermes-agents工作流架构.md - **原始链接**：https://claude.ai/chat/a18d1fa2-7e98-4f86-bac0-1167281eb151 - **素材日期**：2026-04-20 - **消化日期**：2026-09-14 - **依赖版本**：Hermes 特性需 v0.4.0+；`X-Hermes-Session-Id` 需 v0.7.0+ ## 核心观点 1. **不需要写任何胶水代码**。[[Hermes Agent]] 内置 OpenAI 兼容的 [[Hermes API Server]]，默认端口 `8642`；用 `hermes config set API_SERVER_ENABLED true` 与 `API_SERVER_KEY` 开启，再 `hermes gateway install` / `start` 起服务，`GET /v1/health` 返回 `{"status":"ok"}` 即就绪。 2. **Profile 是隔离多个 Agent 的手段**。`hermes profile create ` 为每个角色建独立实例，各自跑在不同端口、持有独立 API key；素材给出的分工示例是 researcher / writer / coder 对应端口 8643 / 8644 / 8645。 3. **n8n 侧零适配**。因为每个 Profile 暴露的都是标准 OpenAI 格式接口，n8n 只需一个 HTTP Request 节点：POST 到 `/v1/chat/completions`，Header 带 `Authorization: Bearer `，Body 的 `model` 字段填 profile 名。 4. **多轮上下文靠 header 传递**。v0.7.0 起 API Server 支持 `X-Hermes-Session-Id`，让 chat-completions 客户端跨请求共享同一 session，把多个节点串成有上下文的多步推理链。 5. **架构极简**。整条链路是 `n8n → 多个端口的 Agent 实例`，中间没有消息队列、网关或适配层。 ## 关键概念 - [[Hermes Agent]] — 提供 Agent 能力的宿主平台 - [[Hermes API Server]] — 把 Agent 暴露为 OpenAI 兼容 HTTP 端点的内置组件 - [[Hermes Profile]] — 多实例隔离机制，多 Agent 分工的基础 - [[n8n]] — 调用方，用 HTTP Request 节点做编排 ## 与其他素材的关联 知识库当前仅此一篇素材，暂无同主题的既有素材可比对。 同一批 nexus 笔记中还存在一份同构素材 [待创建: [[n8n 调用 openclaw agents 的工作流架构]]]，描述同一模式在另一 Agent 平台上的落地。两者消化后可在 [[多 Agent 工作流编排]] 下做横向对比。 ## 原文精彩摘录 > 好消息！**Hermes Agent 内置了 OpenAI 兼容的 API Server**，完全不需要额外写任何代码，直接配置开启就行。 > 你可以用 Profile 的方式为每个用户/角色创建独立的 Hermes 实例，每个 profile 跑在不同端口，配置独立的 API key。 > v0.7.0 起 API Server 支持通过 `X-Hermes-Session-Id` header 来保持会话连续性，让 chat-completions 客户端也能跨请求共享同一个 session。 > 这套方案完全原生支持，不需要任何额外中间件。 ## 相关页面 - [[多 Agent 工作流编排]] - [[Hermes API Server]] - [[Hermes Profile]] - [[n8n]]