火山方舟
火山方舟
文档指南
请输入
- 文档首页
火山方舟调用接入 AI 工具Hermes Agent
复制全文
下载 pdfHermes Agent
文档反馈
问问助手本文介绍如何在 Hermes Agent 中配置并使用方舟 按量计费模型服务。
前提条件
- 在配置工具前，需要 开通所需的模型服务。
- 支持在 macOS、Linux 和 Windows 系统中安装 Hermes Agent。
安装 Hermes Agent
根据操作系统执行以下命令安装 Hermes Agent，安装过程中会检测并安装 uv、Python、Node.js、ripgrep、ffmpeg 等依赖，安装完成后重新加载 Shell 或终端。更多安装说明参见 Hermes Agent 官方文档。
- 执行以下 cURL 命令安装：
-
- 安装完成后重新加载 Shell。
-
- 在 PowerShell 中执行以下命令安装：
-
- 安装完成后重新打开 PowerShell 窗口，或执行 . $PROFILE 刷新环境变量。
配置 Hermes Agent
需配置的信息
如您对 Hermes Agent 熟悉，或本地已有配置，可获取以下信息直接配置。
- Base URL：https://ark.cn-beijing.volces.com/api/v3。
- API Key：获取API Key。
- Model：按需选择模型并获取 Model ID。可用模型参见模型列表。
方式 1：一键配置（推荐）
Ark CLI 是火山方舟平台官方命令行工具，支持在本地终端快速完成认证与资源管理，并可将能力安装到常用 AI Agent 中，降低手动配置的时间成本和出错风险。
- 安装 Ark CLI
- 环境要求：Node.js 18 或更新版本。支持 macOS、Linux、Windows。
- 登录 Ark CLI
- 根据界面提示选择登录方式，推荐选择 火山 SSO (浏览器登录)，在浏览器中完成授权即可。
- 一键配置 Hermes Agent
运行 ArkCLI Helper，根据界面提示完成配置。
- 选择 Profile：platform_cn-beijing_accountwide。
- 选择 Endpoint：按需选择要使用的推理接入点。
- 选择 AI Agent：Hermes Agent。
配置完成后，Hermes Agent 会自动识别配置的模型。启动 Hermes Agent 即可使用。
方式 2：手动配置
按量计费模型服务兼容 OpenAI 接口协议，支持 Responses API、Chat API。推荐使用 Responses API 的配置，推理效果更好。
使用 Responses API，需要配置 api_mode: codex_responses。
配置完成后，配置文件 ~/.hermes/config.yaml 内容如下。您也可以直接编辑该配置文件。
使用 Chat API，需要配置 api_mode: chat_completions。
配置完成后，配置文件 ~/.hermes/config.yaml 内容如下。您也可以直接编辑该配置文件。
使用 Hermes Agent
- 执行以下命令开启 Hermes Agent。
-
- 开始使用 Hermes Agent，支持的 CLI Interface 参见 官方文档。
最近更新时间：2026.11.03 21:11:08
这个页面对您有帮助吗？
有用
有用
无用
无用