模型聚合服务平台

外观

Hermes Agent ​

应用介绍 ​

Hermes Agent 是一款可在终端或 Web 界面中使用的开源智能体，能够进行对话、调用工具并执行多步骤任务。它适合希望自行配置模型和工具、搭建通用 Agent 工作流的用户。Hermes Agent 支持实现 /v1/chat/completions 的 OpenAI 兼容接口，本教程通过 hermes model 添加模型聚合服务平台的自定义端点。

准备信息 ​

text
Base URL：https://ai.example.edu.cn/v1
API Key：你的 API Key
模型 ID：以模型聚合服务平台“模型广场”中显示的模型标识为准

请直接复制纯文本地址，不要把 Markdown 链接、引号或 BASE_URL= 一起填入。

1. 安装 Hermes Agent ​

Linux、macOS 或 WSL：

bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows PowerShell：

powershell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安装后重新打开终端，或者按照安装程序提示重新加载 Shell 配置，再检查命令是否可用：

bash
hermes --help

安装命令以 Hermes Agent 官方仓库 的最新说明为准。

2. 添加自定义端点 ​

在终端中运行：

bash
hermes model

进入交互式配置后：

  1. 选择 Custom endpoint (self-hosted / VLLM / etc.)。
  2. 在 API base URL 中填写 https://ai.example.edu.cn/v1。
  3. 在 API key 中填写你的 API Key。
  4. 在 Model name 中填写模型广场中的完整模型 ID，例如 qwen3.6-27b。
  5. 如果程序询问上下文长度，请按模型广场标注的实际上限填写，不要凭示例值猜测。
Hermes 字段填写内容
ProviderCustom endpoint (self-hosted / VLLM / etc.)
API base URLhttps://ai.example.edu.cn/v1
API key你的 API Key
Model name模型广场中的完整模型 ID
Context length该模型实际支持的上下文长度

保护 API Key

API Key 会保存在本机 Hermes 配置中。不要把真实 Key 写进教程截图、聊天记录、Git 仓库或公开的终端日志。

3. 启动并验证 ​

配置完成后启动 Hermes：

bash
hermes

先发送一个不包含敏感数据、且不会修改文件的任务，例如：

text
请回复“连接成功”，并告诉我你当前使用的模型名称。不要调用工具。

能够正常收到回复，即表示 Base URL、API Key 和模型 ID 均可用。

在已经打开的 Hermes 会话中，可以用 /model 查看或切换已配置的模型。例如：

text
/model custom:qwen3.6-27b

请将示例中的模型 ID 替换为你实际配置的名称。/model 只负责切换已有配置；需要新增或修改提供方时，应退出会话后运行 hermes model。

4. 使用 Web UI 切换模型（可选） ​

如果当前 Hermes 部署启用了 Web UI，打开左侧 Models，在 Main Model 右侧点击 Change。

Hermes Agent 模型页，箭头指向 Change 按钮

在弹出的窗口中，先从左侧选择已经完成认证或已经配置的提供方，再从右侧选择模型，最后点击 Switch。

Hermes Agent 官方模型选择器

Web UI 的选择结果会写入 ~/.hermes/config.yaml，并应用于之后新建的会话；当前正在运行的终端会话可使用 /model 切换。

Web UI 中找不到 Custom

模型选择器只展示已经完成配置的提供方。请先在终端运行 hermes model 添加自定义端点，再刷新 Web UI。

手动配置方式（备用） ​

交互式配置不可用时，可以编辑 ~/.hermes/config.yaml：

yaml
model:
  default: qwen3.6-27b
  provider: custom
  base_url: https://ai.example.edu.cn/v1
  api_key: 你的 API Key

将 default 替换为模型广场中的完整模型 ID。YAML 使用空格缩进，不要使用 Tab；保存后重新启动 Hermes。

通常优先使用 hermes model，因为它可以减少字段名、缩进和保存位置错误。根据官方提供方配置说明，~/.hermes/config.yaml 是 Hermes 当前模型配置的最终来源。

配置过程中遇到账号、API Key、接口地址、模型权限、额度、限流或通用错误时，请查看常见问题（FAQ）。