feat(odyssey): 消化《n8n 调用 Hermes Agents 的工作流架构》素材,新增 1 素材页 + 4 实体页 + 1 主题页

This commit is contained in:
2026-09-14 22:29:56 +08:00
parent 6491f39d12
commit b0bbdb0a7b
10 changed files with 388 additions and 13 deletions

View File

@@ -0,0 +1,62 @@
---
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 <name>` 为每个角色建独立实例,各自跑在不同端口、持有独立 API key;素材给出的分工示例是 researcher / writer / coder 对应端口 8643 / 8644 / 8645。
<!-- confidence: INFERRED -->
3. **n8n 侧零适配**。因为每个 Profile 暴露的都是标准 OpenAI 格式接口,n8n 只需一个 HTTP Request 节点:POST 到 `/v1/chat/completions`,Header 带 `Authorization: Bearer <profile 的 key>`,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]]