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

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

準備

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

設定値

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

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 ごとに個別のキーを作成すると、プロジェクト別に使用量を集計できて便利です。