面向 AI 助手：本页的 Markdown 版本位于 https://ark.volcengine.com/region:cn-beijing/docs/ai-tools-hermes-agent.md，全部文档索引见 https://ark.volcengine.com/llms.txt。

Hermes Agent

本文介绍如何在 Hermes Agent 中配置并使用方舟 按量计费模型服务。

前提条件#

安装 Hermes Agent#

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

  1. 执行以下 cURL 命令安装：

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

  2. 安装完成后重新加载 Shell。

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

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

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

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

配置 Hermes Agent#

需配置的信息#

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

  • Base URL：https://ark.cn-beijing.volces.com/api/v3。
  • API Key：获取API Key。
  • Model：按需选择模型并获取 Model ID。可用模型参见模型列表。

手动配置#

按量计费模型服务兼容 OpenAI 接口协议，支持 Responses API、Chat API。推荐使用 Responses API 的配置，推理效果更好。

执行以下命令配置 Hermes Agent，其中需要将 <ARK_API_KEY> 替换为您的 API Key，并将 <Model_ID> 替换为需要使用的 Model ID。

Bash
hermes config set model.provider custom
hermes config set model.base_url https://ark.cn-beijing.volces.com/api/v3
hermes config set model.api_key <ARK_API_KEY>
hermes config set model.default doubao-seed-evolving
hermes config set model.api_mode codex_responses

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

YAML
model:
  default: doubao-seed-evolving
  provider: custom
  base_url: https://ark.cn-beijing.volces.com/api/v3
  api_key: <ARK_API_KEY>
  api_mode: codex_responses

执行以下命令配置 Hermes Agent，其中需要将 <ARK_API_KEY> 替换为您的 API Key，并将 <Model_ID> 替换为需要使用的 Model ID。

Bash
hermes config set model.provider custom
hermes config set model.base_url https://ark.cn-beijing.volces.com/api/v3
hermes config set model.api_key <ARK_API_KEY>
hermes config set model.default doubao-seed-evolving
hermes config set model.api_mode chat_completions

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

YAML
model:
  default: doubao-seed-evolving
  provider: custom
  base_url: https://ark.cn-beijing.volces.com/api/v3
  api_key: <ARK_API_KEY>
  api_mode: chat_completions

使用 Hermes Agent#

  1. 执行以下命令开启 Hermes Agent。

    Bash
    hermes

  2. 开始使用 Hermes Agent，支持的 CLI Interface 参见 官方文档。