aicentosHermes Agent
在 Hermes Agent 中使用 aicentos —— 透過環境變數指定 OpenAI 相容端點
最後更新於:
Hermes Agent 透過環境變數讀取模型服務的連線資訊。把 Base URL 指向 aicentos，就能讓 Agent 的所有推理請求走 aicentos 接入的模型。
準備工作
先在控制台「API Key」頁面為 Hermes Agent 建立一個專用 Key（建議命名 hermes-agent，方便追蹤用量）。
- 控制台：https://aicentos.com
- 建立 Key：https://aicentos.com/keys
- 錢包儲值：https://aicentos.com/wallet
- 文件站：https://docs.aicentos.com
需要填寫的設定
| 欄位 | 值 |
|---|---|
| OPENAI_BASE_URL | https://aicentos.com/v1 |
| OPENAI_API_KEY | 控制台建立的 Key |
| Model | 控制台「模型廣場」中的模型名稱 |
設定步驟
在執行 Agent 的同一個 shell 中設定：
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，便於按專案統計用量。