# Hermes Agent

來源: https://docs.aicentos.com/zh-TW/clients/hermes-agent

Language: zh-TW

> 在 Hermes Agent 中使用 aicentos —— 透過環境變數指定 OpenAI 相容端點

Hermes Agent 透過環境變數讀取模型服務的連線資訊。把 Base URL 指向 aicentos，就能讓 Agent 的所有推理請求走 aicentos 接入的模型。

## 準備工作

先在控制台「API Key」頁面為 Hermes Agent 建立一個專用 Key（建議命名 `hermes-agent`，方便追蹤用量）。

* 控制台：[https://aicentos.com](https://aicentos.com)
* 建立 Key：[https://aicentos.com/keys](https://aicentos.com/keys)
* 錢包儲值：[https://aicentos.com/wallet](https://aicentos.com/wallet)
* 文件站：[https://docs.aicentos.com](https://docs.aicentos.com)

## 需要填寫的設定

| 欄位                | 值                         |
| ----------------- | ------------------------- |
| OPENAI\_BASE\_URL | `https://aicentos.com/v1` |
| OPENAI\_API\_KEY  | 控制台建立的 Key                |
| Model             | 控制台「模型廣場」中的模型名稱           |

## 設定步驟

在執行 Agent 的同一個 shell 中設定：

```bash
export OPENAI_BASE_URL="https://aicentos.com/v1"
export OPENAI_API_KEY="sk-你的Key"
export OPENAI_MODEL="gpt-4o"
```

然後按平時的方式啟動 Hermes Agent。永久生效請把上面的 `export` 寫進 `~/.zshrc` 或 `~/.bashrc`，並重新 `source` 一次。

如果 Hermes Agent 提供了自己的設定檔，也可以在其中指定 base\_url / api\_key / model，效果等價；兩者同時存在時以其自身優先級為準（通常環境變數更高）。

## 測試

啟動後觸發一次最簡單的推理（例如讓它回答一個常識問題），確認能收到回覆。再檢查控制台用量頁面，確認請求確實記在了你給 Hermes Agent 建的那個 Key 上。

## 注意事項

* 環境變數必須在啟動 Agent 的那個 shell 工作階段中可見，寫到別的 shell 裡不會生效。
* 如果你用 Docker 部署，記得把變數透過 `-e` 或 compose 的 `environment` 傳進去，不要只寫在宿主機上。
* Base URL 只填到 `/v1`。
* 部分 Agent 框架會優先讀 `OPENAI_API_BASE`，若上面的變數不生效，補一個同名不同拼寫的變數再試。
* 建議為 Agent 單獨建 Key，便於按專案統計用量。