编码 Agent 集成

Hermes Agent

Hermes Agent 是什么？

Hermes Agent 是终端原生的自主编码和任务 Agent。当 Hermes 支持 OpenAI 兼容提供方时，可以通过 JoyToken API Key 统一接管模型调用，并获得集中策略、模型路由、钱包检查和用量归因。

Hermes 不同版本的配置键可能不同。本页描述 JoyToken 需要的提供方契约：OpenAI 兼容基础 URL、Bearer API Key，以及 auto 或具体 JoyToken 模型 key。

设置

第 1 步：创建 JoyToken API Key

创建专用 Key，例如 dev-hermes-agent。

设置建议
模型从 auto 开始
预算设置每日或每周开发上限
策略限制允许的 tier 和模型
日志保持开启

第 2 步：设置环境变量

.env
$JOY_TOKEN_API_KEY="jt_xxx"
$JOY_TOKEN_OPENAI_BASE_URL="https://api-dev.joytokens.ai/openai/v1"
$JOY_TOKEN_DEFAULT_MODEL="auto"

第 3 步：配置 Hermes 提供方

如果 Hermes 暴露通用 OpenAI 兼容提供方，使用下面的形态：

hermes.yaml
1model:
2  provider: openai-compatible
3  base_url: ${JOY_TOKEN_OPENAI_BASE_URL}
4  api_key_env: JOY_TOKEN_API_KEY
5  default: ${JOY_TOKEN_DEFAULT_MODEL}

第 4 步：启动 Hermes

用你平时的 CLI 或 TUI 命令启动 Hermes。模型请求应会经过 JoyToken。

手动配置

如果 Hermes 区分主模型和辅助模型，建议把每个由 JoyToken 支持的角色都显式指向 JoyToken 提供方：

hermes.yaml
1providers:
2  joytoken:
3    type: openai-compatible
4    base_url: https://api-dev.joytokens.ai/openai/v1
5    api_key_env: JOY_TOKEN_API_KEY
6
7models:
8  primary:
9    provider: joytoken
10    model: auto
11  planner:
12    provider: joytoken
13    model: auto
14  summarizer:
15    provider: joytoken
16    model: auto

模型格式

值行为
autoJoyToken 路由器在策略允许范围内自动选模型
具体模型 key固定该角色到某个 JoyToken 模型，但仍经过策略和钱包检查
API Key 固定模型Key 策略会限制或覆盖请求模型

推荐起点：

Hermes 角色JoyToken 模型设置说明
主 Agentauto早期评估交给 JoyToken 路由
规划器auto如果规划质量需要一致性，再固定模型
摘要器auto 或较小固定模型让后台成本更可控
评估器独立 Key 或固定模型方便审计质量检查成本

监控用量

如果 Hermes 支持自定义 headers，传 request ID：

headers.yaml
1headers:
2  X-Request-ID: hermes-session-${SESSION_ID}

多步任务包含 role 和 step：

hermes-support-42-planner-step-03
hermes-support-42-summarizer-step-01

首次运行后查看 JoyToken Logs 和 Usage。

为什么用 JoyToken 接入 Hermes Agent？

成本归因

使用 Hermes 专用 Key，或按角色拆 Key，把主 Agent 成本和后台摘要、评估成本分开。

策略控制

在无人值守 Hermes 工作流消耗 Credits 前，先应用模型、tier、IP 和预算策略。

模型路由

评估阶段使用 auto。对质量或成本稳定性要求高的角色，再固定具体模型。

故障排查

现象检查
Hermes 仍调用其他提供方默认模型是否指向 JoyToken 提供方
401 UnauthorizedJOY_TOKEN_API_KEY 是否被 Hermes 进程读取
403 ForbiddenJoyToken 策略是否允许请求模型、tier 和 IP
成本异常将规划器、摘要器、评估器拆 Key 或固定模型
流式响应异常Hermes 是否能处理 OpenAI 兼容 SSE 分块

相关资源