> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes Agent 交互向导配置指南

> AceDataCloud Coding Plan 集成指南 - Ace Data Cloud

## 1. 获取 API Key

打开 [Ace Data Cloud 应用列表](https://platform.acedata.cloud/console/applications)，进入可用的应用并复制 API Key。

![获取 Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. 运行向导

```bash theme={null}
hermes model
```

选择 **Custom endpoint**，依次填写：

| 字段             | 值                              |
| -------------- | ------------------------------ |
| Base URL       | `https://api.acedata.cloud/v1` |
| API Key        | 刚刚复制的 API Key                  |
| API mode       | `chat_completions`             |
| Model          | Coding Plan 当前提供的模型 ID         |
| Context length | 留空自动检测，或按模型目录填写                |
| Display name   | `Ace Data Cloud`               |

向导会写入 `~/.hermes/config.yaml` 和本机凭据文件。

## 3. 验证

```bash theme={null}
hermes config check
hermes -z "Reply only OK" --provider custom --model MODEL_ID --ignore-rules
```

如果向导没有保存配置，可运行 `hermes model --reset` 后重试；401 表示 API Key 无效或未被当前用户配置读取。

## 官方参考

* [Hermes 配置](https://hermes-agent.nousresearch.com/docs/user-guide/configuration/)
* [Hermes Providers](https://hermes-agent.nousresearch.com/docs/integrations/providers/)