> ## 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. 儲存 Key

在 `~/.hermes/.env` 中寫入：

```dotenv theme={null}
ACEDATACLOUD_API_KEY=你的 API Key
```

## 3. 設定 Provider

在 `~/.hermes/config.yaml` 中加入：

```yaml theme={null}
providers:
  acedatacloud:
    api: https://api.acedata.cloud/v1
    key_env: ACEDATACLOUD_API_KEY
    transport: chat_completions
    default_model: MODEL_ID

model:
  provider: custom:acedatacloud
  default: MODEL_ID
```

前往 [模型目錄](https://platform.acedata.cloud/models) 查看模型名稱（例如 `claude-opus-5`、`gpt-6-sol`），並將所有 `MODEL_ID` 替換為相同名稱；進行精確驗證時，以 `/v1/models` 回應中的 `id` 值為準。該值就是 API `model` 參數所使用的模型名稱，不是服務或 API 的 UUID。不要將真實 Key 寫入 YAML 或提交 `.env`。

## 4. 驗證

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

如果回傳 401，檢查 `~/.hermes/.env`；如果設定未生效，完全結束並重新啟動 Hermes。

## 官方參考

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.