# Hermes Agent

出典: https://docs.aicentos.com/ja/clients/hermes-agent

Language: ja

> Hermes Agent で aicentos を使う —— 環境変数で OpenAI 互換エンドポイントを指定

Hermes Agent は環境変数からモデルサービスの接続情報を読み取ります。Base URL を aicentos に向ければ、Agent のすべての推論リクエストを aicentos が接続しているモデルで処理できます。

## 準備

まずコンソールの「API Key」ページで Hermes Agent 専用のキーを作成します（名前は `hermes-agent` のようにすると使用量の追跡に便利です）。

* コンソール：[https://aicentos.com](https://aicentos.com)
* キーの作成：[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  | コンソールで作成したキー              |
| Model             | コンソール「モデル広場」のモデル名         |

## 設定手順

Agent を実行するのと同じ shell で設定します：

```bash
export OPENAI_BASE_URL="https://aicentos.com/v1"
export OPENAI_API_KEY="sk-あなたのキー"
export OPENAI_MODEL="gpt-4o"
```

その後、普段どおりの方法で Hermes Agent を起動します。永続化するには、上記の `export` を `~/.zshrc` または `~/.bashrc` に書き込み、再度 `source` してください。

Hermes Agent が独自の設定ファイルを提供している場合は、そこに base\_url / api\_key / model を指定しても同じ効果が得られます。両方が同時に存在する場合は、そのツール自体の優先順位に従います（通常は環境変数の方が高くなります）。

## テスト

起動後、最も簡単な推論を 1 回実行し（たとえば常識の質問に答えさせる）、返信が届くことを確認します。そのうえで、コンソールの使用量ページを見て、リクエストが確かに Hermes Agent 用に作成したキーに記録されているか確認してください。

## 注意事項

* 環境変数は Agent を起動する shell セッションから見える必要があります。別の shell に書いても有効になりません。
* Docker でデプロイする場合は、`-e` または compose の `environment` で変数をコンテナに渡してください。ホスト側に書くだけでは効果がありません。
* Base URL は `/v1` まで入力します。
* 一部の Agent フレームワークは `OPENAI_API_BASE` を優先して読みます。上記の変数が効かない場合は、別の綴りの同名変数を追加して再試行してください。
* Agent ごとに個別のキーを作成すると、プロジェクト別に使用量を集計できて便利です。