Hermes Agent

本文介绍如何在 Hermes Agent 中配置并使用方舟 Agent Plan 企业版。

前提条件#

需由管理员账号完成以下前置操作后，子账号方可配置并使用 Hermes Agent：
1. 购买方舟 Agent Plan 企业版套餐：一、购买 Agent Plan 企业版。
2. 为子账号分配席位：二、分配席位。
支持在 macOS、Linux 和 Windows 系统中安装 Hermes Agent。

安装 Hermes Agent#

根据操作系统执行以下命令安装 Hermes Agent，安装过程中会检测并安装 uv、Python、Node.js、ripgrep、ffmpeg 等依赖，安装完成后重新加载 Shell 或终端。更多安装说明参见 Hermes Agent 官方文档。

执行以下 cURL 命令安装：

1curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装完成后重新加载 Shell。

1source ~/.bashrc   # or: source ~/.zshrc

在 PowerShell 中执行以下命令安装：

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

安装完成后重新打开 PowerShell 窗口，或执行 . $PROFILE 刷新环境变量。

配置 Hermes Agent#

需配置的信息#

如您对 Hermes Agent 熟悉，或本地已有配置，可获取以下信息直接配置。

Base URL：https://ark.cn-beijing.volces.com/api/plan/v3。
API Key：获取专属 API Key。
Model：配置文本生成模型。可配置 ark-code-latest 或 Model Name，模型信息参见支持模型及 Harness。

方式 1：一键配置（推荐）#

Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。

安装 Ark CLI

环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。

1
2npm install -g @volcengine/ark-cli@latest
arkcli --version

1arkcli auth login

一键配置 Hermes Agent

1arkcli helper

运行 ArkCLI Helper，根据界面提示完成配置。

选择 Profile：agent-plan-team_cn-beijing_team。
选择默认 model：按需选择。
选择 AI Agent：Hermes Agent。
支持配置 Harness 能力，根据界面提示按需选择配置或者跳过。

配置完成后，Hermes Agent 会自动识别配置的模型。启动 Hermes Agent 即可使用。

方式 2：手动配置#

Agent Plan 企业版兼容 OpenAI 接口协议，支持 Responses API、Chat API。推荐使用 Responses API 的配置，推理效果更好。

使用 Responses API，需要配置 api_mode: codex_responses。

执行以下命令配置 Hermes Agent，其中需要将 <ARK_API_KEY> 替换为您自己的专属 API Key，可用的模型参见支持模型及 Harness。

1
2
3
4
5hermes config set model.provider custom
hermes config set model.base_url https://ark.cn-beijing.volces.com/api/plan/v3
hermes config set model.api_key <ARK_API_KEY>
hermes config set model.default ark-code-latest
hermes config set model.api_mode codex_responses

配置完成后，配置文件 ~/.hermes/config.yaml 内容如下。您也可以直接编辑该配置文件。

1
2
3
4
5
6model:
  default: ark-code-latest
  provider: custom
  base_url: https://ark.cn-beijing.volces.com/api/plan/v3
  api_key: <ARK_API_KEY>
  api_mode: codex_responses

使用 Chat API，需要配置 api_mode: chat_completions。

执行以下命令配置 Hermes Agent，其中需要将 <ARK_API_KEY> 替换为您自己的专属 API Key，可用的模型参见支持模型及 Harness。

1
2
3
4
5hermes config set model.provider custom
hermes config set model.base_url https://ark.cn-beijing.volces.com/api/plan/v3
hermes config set model.api_key <ARK_API_KEY>
hermes config set model.default ark-code-latest
hermes config set model.api_mode chat_completions

配置完成后，配置文件 ~/.hermes/config.yaml 内容如下。您也可以直接编辑该配置文件。

1
2
3
4
5
6model:
  default: ark-code-latest
  provider: custom
  base_url: https://ark.cn-beijing.volces.com/api/plan/v3
  api_key: <ARK_API_KEY>
  api_mode: chat_completions

使用 Hermes Agent#

执行以下命令开启 Hermes Agent。
Bash
```
1hermes
```
开始使用 Hermes Agent，支持的 CLI Interface 参见官方文档。

其他操作#

添加图片生成/视频生成能力#

方舟 Agent Plan 企业版 Team Medium 及以上套餐提供图片生成模型配额，Team Large 及以上套餐提供视频生成模型配额。方舟提供 Skill 帮助 AI 工具快速接入并使用。具体配置方法请参见配置视觉模型。

切换模型#

你可以随时根据需求切换文本生成模型。

配置方式	通过控制台	修改配置文件
切换模型操作	1. 参考配置 Hermes Agent，将 `model.default` 配置为 `ark-code-latest`。 2. 在订阅页面，选择我的 - 使用配置，选择要使用的模型，切换后 3-5 分钟即可生效。	1. 参考配置 Hermes Agent，将 `model.default` 配置为需要使用的 Model Name。 2. 重新启动 Hermes Agent 后生效。

接入飞书机器人#

单击链接快速创建飞书机器人。
在终端执行以下命令配置信息平台。
Bash
```
1hermes gateway setup
```
- Select a platform to configure：选择 Feishu / Lark
- How would you like to set up Feishu / Lark：选择 Scan QR code to create a new bot automatically (recommended)，通过飞书客户端扫描二维码后，创建飞书机器人。

* **How should direct messages be authorized**：选择 `Use DM pairing approval` * **How should group chats be handled**：选择`Respond only when @mentioned in groups` * **Home chat ID**：暂不配置 * 选择 **done** 后， **Install the gateway as a launchd service**：选择 `Y` * **Start the service now**：选择 `Y` 3. 在飞书打开刚创建的飞书机器人，发送任意消息获取配对码。

在终端执行以下命令对飞书进行配置，其中<pairing-code>需替换为获取的配对码。
Bash
```
1hermes pairing approve feishu <pairing-code>
```

在飞书中发送/sethome命令将飞书会话设置为主会话，然后即可正常在飞书中使用 Hermes Agent。