69 lines
2.3 KiB
Markdown
69 lines
2.3 KiB
Markdown
---
|
||
tags: [实体]
|
||
created: 2026-09-14
|
||
updated: 2026-09-15
|
||
sources: [raw/notes/2026-09-14-n8n调用hermes-agents工作流架构.md]
|
||
---
|
||
|
||
# Hermes API Server
|
||
|
||
> [[Hermes Agent]] 的内置组件，把 Agent 暴露成 OpenAI 兼容的 HTTP 端点，默认端口 8642。
|
||
|
||
## 简介
|
||
|
||
Hermes API Server 是 [[Hermes Agent]] 自带的 HTTP 服务层，遵循 OpenAI 的 `chat/completions` 协议。任何能调用 OpenAI 接口的客户端——[[n8n]]、脚本、其他 Agent——都能不加改造地调用它。这是 Hermes 接入外部编排系统的关键，也是「不需要中间件」这个结论的来源。
|
||
|
||
## 关键信息
|
||
|
||
- **类型**：概念 / 组件
|
||
- **领域**：AI Agent 服务化
|
||
- **相关概念**：[[Hermes Agent]]、[[Hermes Profile]]、[[n8n]]、[[OpenAI 兼容 API]]
|
||
- **默认端口**：`8642`
|
||
- **协议**：OpenAI 兼容（`/v1/chat/completions`、`/v1/health`）
|
||
|
||
## 详细内容
|
||
|
||
### 开启与配置
|
||
|
||
```bash
|
||
hermes config set API_SERVER_ENABLED true
|
||
hermes config set API_SERVER_KEY <your-secret-key>
|
||
hermes gateway restart
|
||
```
|
||
|
||
`API_SERVER_KEY` 是必填项，客户端通过 `Authorization: Bearer <key>` 携带。若要跨机器访问，还需把 `API_SERVER_HOST` 设为 `0.0.0.0`（默认只监听本机）。
|
||
|
||
### 调用格式
|
||
|
||
```json
|
||
{
|
||
"model": "hermes-agent",
|
||
"messages": [{ "role": "user", "content": "Hello!" }]
|
||
}
|
||
```
|
||
|
||
`model` 字段填实例 / profile 名，返回体是标准 OpenAI 响应结构，带 `usage` 的 token 统计。
|
||
|
||
### 多轮会话连续性
|
||
|
||
v0.7.0 起支持 `X-Hermes-Session-Id` 请求头：
|
||
|
||
```
|
||
X-Hermes-Session-Id: my-workflow-session-001
|
||
```
|
||
|
||
同一个 id 的多次请求共享同一个 session，因此 chat-completions 客户端也能跨请求保留上下文。这让 [[n8n]] 里用多个 HTTP Request 节点串起来的流程可以具备记忆，适合多步推理任务链。
|
||
<!-- confidence: EXTRACTED -->
|
||
|
||
## 不同素材中的观点
|
||
|
||
- [[wiki/sources/2026-09-14-n8n调用hermes-agents工作流架构]]：API Server 是「完全原生支持」的核心，架构中位于 n8n 与各 Agent 实例之间。
|
||
|
||
## 相关页面
|
||
|
||
- [[Hermes Agent]]
|
||
- [[Hermes Profile]]
|
||
- [[n8n]]
|
||
- [[多 Agent 工作流编排]]
|
||
- [[OpenAI 兼容 API]] — 本端点是该协议在「供给侧」的一种实现，另一条素材里的 Codex 则是「消费侧」
|