phaseo hermes を実行して、専用のキーとともに Phaseo を Hermes Agent のカスタムエンドポイントに設定するか、同じ 4 つの Hermes の設定と .env の 1 行を自分で設定します。
Phaseo CLI で設定する
sh、bash、curl が必要です。その後、セットアップは次の処理を行います。
- 削除時に元に戻せるよう、
model.provider、model.base_url、model.default、model.key_envの現在の値を保存します。 - 有効期限が 90 日で月額 $100 の利用上限が付いた
Phaseo CLI: Hermes Agent API Keyを作成します。 - キーを
OPENAI_API_KEYとして Hermes の.envファイルに書き込みます。書き込み先は# >>> phaseo managed (do not edit)で始まり# <<< phaseo managedで終わるブロックの中です。その他の行はそのまま残り、キーがコマンドラインに表示されることはありません。 hermes config setを実行して、Hermes を Phaseo に向けます。
model.key_env は、OPENAI_API_KEY をカスタムエンドポイントに送信するよう Hermes に指示します。これがないと、Hermes はこのキーを OpenAI 自身のホストにしか送信せず、リクエストはキーなしで Phaseo に届きます。
Phaseo は Hermes に .env ファイルの場所を問い合わせる(hermes config env-path)ため、プロファイルやその他の上書き設定にも対応します。Hermes が場所を返せない場合、CLI は HERMES_HOME の .env、または ~/.hermes/.env(ネイティブ Windows では %LOCALAPPDATA%\hermes\.env)を使います。Hermes はプロバイダーのキーをこの平文のファイルに保存するため、他のキーファイルと同様に保護してください。
期限切れのキーを置き換えたりモデルを変更したりするには、phaseo hermes を再実行します。初回の実行時に保存された設定は保持されます。
Hermes を手動で設定する
Phaseo の API キーを Hermes の.env ファイルに追加します。
.env
.env ファイルの場所を確認するには、hermes config env-path を実行します。
動作を確認する
実行中の Hermes セッションを再起動して、Phaseo のエンドポイントとキーを使うようにします。hermes config get model.base_url --json を実行して https://api.phaseo.app/v1 が返ることを確認してから、短いプロンプトを送信し、設定 → 利用状況 → ログにリクエストが表示されることを確認します。
Phaseo を削除する
.env から Phaseo のブロックが削除され、~/.config/phaseo/integrations/hermes.json にある CLI の保存状態が削除され、キーが失効します。実行中の Hermes セッションを再起動して、復元された設定を読み込み直してください。
よくある問題を解決する
その他のエージェントや、すべてのエージェントに必要なプロバイダーの値については、コーディングエージェントを参照してください。