Hermes Agent

在 Nous Research 的 Hermes Agent 中接入 Fusion Model。

接入参数

使用 FUMO Dashboard 的 Key，适用于线上注册与充值的账号。

参数	值
Base URL	`https://capi.fumolab.ai/api/fusion/v1`
可用模型 ID	`fusion-max-2.0`、`fusion-max-1.0`、`fusion-code-1.0`
API 协议	OpenAI Chat Completions API

关于 Hermes Agent

Hermes Agent↗ 是 Nous Research 开发的开源终端 Agent，可用于编程和通用任务。它支持持久记忆、可复用技能、多种执行后端和消息平台集成。

通过 Hermes 的自定义 OpenAI 兼容接口即可接入 Fusion。

配置步骤

开始前，请按照快速开始中的线上自助步骤（企业账号请见企业接入指南），创建并保存 API Key。已有销售对接的 FUMO 用户，请在注册时填写 Sales Code，或登录后按账号说明绑定。

推荐方式：交互式配置

运行：

hermes model

选择 Custom endpoint (self-hosted / VLLM / etc.)（自定义接口），然后按下列示例填写，将 API key 替换为你的 FUMO API Key：

API base URL: https://capi.fumolab.ai/api/fusion/v1
API key:      your FUMO API key
Model name:   fusion-code-1.0
API mode:     chat_completions

上下文长度可在模型规格中查看；使用销售配置的服务时，请按对应配置填写。如果尚未确认该数值，且 Hermes 支持自动探测，可以留空。

手动配置

如果希望直接编辑配置文件，先将 Key 保存到 ~/.hermes/.env，替换示例中的 your-key：

FUMO_API_KEY=your-key

然后在 ~/.hermes/config.yaml 中添加自定义服务商：

providers:
  fumo:
    api: "https://capi.fumolab.ai/api/fusion/v1"
    key_env: FUMO_API_KEY
    transport: chat_completions

model:
  provider: custom:fumo
  default: fusion-code-1.0

密钥保存在 .env 中，模型、服务商和 Base URL 等设置则保存在 config.yaml 中。

启动 Hermes

以下两条命令分别启动普通 CLI 和 TUI，任选一种即可：

hermes
hermes --tui

Hermes 会将模型请求发送到 Fusion 的 Chat Completions 接口。

模型名称格式

使用上述自定义服务商配置时，默认模型的完整名称为：

custom:fumo:fusion-code-1.0

在会话中，可以通过 /model 切换模型 ID：

/model custom:fumo:fusion-code-1.0
/model custom:fumo:fusion-max-1.0

Hermes 配置要求提供模型名称。公共网关会根据账号权限校验传入的 ID；请求通过后，Fusion 核心只将其作为兼容标签，实际执行由与 Key 关联的服务配置控制。

辅助任务

Hermes 可能使用辅助模型处理上下文压缩、生成会话标题或分析图像等工作。Fusion 支持标准 Chat Completions 图片输入；当 Hermes 发送 image_url 内容时，视觉分析可沿用同一服务商。

如果辅助任务沿用主模型设置，就会使用同一个 Fusion 服务商配置和 Key。开始长时间运行的工作流前，建议先用小任务确认这些调用的行为。

常见问题

找不到服务商

运行 hermes doctor，确认 providers 下的名称为 fumo，而 model.provider 的值为 custom:fumo。

身份验证失败

确认 ~/.hermes/.env 中已设置 FUMO_API_KEY，且 key_env 使用了相同的变量名。

模型无法使用

确认 Hermes 严格使用已开通的模型 ID，且 Base URL 以 /v1 结尾。未知或未授权的 ID 可能在请求进入 Fusion 核心前被网关拒绝。

上下文长度报错

根据模型规格或销售提供的服务配置，核对上下文长度，再通过 hermes model 更新。