Hermes Agent

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

一、前提条件#

需由管理员账号完成以下操作后，子账号方可配置并使用 AI 工具：
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#

配置语言模型#

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

执行以下命令配置 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

执行以下命令配置 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配置模型名称为`ark-code-latest`。 2. 在订阅页面，选择我的 - 使用配置，选择要使用的模型，切换后3-5分钟即可生效。	参考三、配置 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
在飞书打开刚创建的飞书机器人，发送任意消息获取配对码。
在终端执行以下命令对飞书进行配置，其中<pairing-code>需替换为获取的配对码。
Bash
```
1hermes pairing approve feishu <pairing-code>
```
在飞书中发送/sethome命令将飞书会话设置为主会话，然后即可正常在飞书中使用 Hermes Agent。