ai2saveai2save

Hermes Agent 配置チュートリアル

Hermes Agent のモデル、ベンダー、およびカスタムエンドポイントは ~/.hermes/config.yaml に保存されます。API Key などの機密情報は ~/.hermes/.env に保存されます。ai2save は OpenAI Compatible インターフェースを使用し、Base URL は https://ai2save.com/v1 です。

1. API Key を作成する

  1. https://ai2save.com/keys を開きます。
  2. キーを作成し、ターゲットモデルを含むグループを選択します。
  3. 完全な sk-... キーをコピーします。
  4. コンソールに表示される実際のモデルIDを記録します(例: gpt-5.5)。

2. 組み込みウィザードの使用を推奨

ターミナルで実行:

hermes model

指示に従って選択してください:

Custom endpoint (self-hosted / vLLM / etc.)

順に入力してください:

API base URL: https://ai2save.com/v1
API key: sk-あなたのAPIキー
Model name: gpt-5.5

ガイドはこれらの値を ~/.hermes/config.yaml に書き込みます。Base URL を .env に書き込まないでください。Hermes 公式のモデルエンドポイント設定は config.yaml から取得することが規定されています。

3. 手動で設定ファイルを編集する

~/.hermes/config.yaml を編集してください:

model:
  provider: custom
  default: gpt-5.5
  base_url: https://ai2save.com/v1
  key_env: AI2SAVE_API_KEY

フィールドの説明:

  • provider: custom:任意の OpenAI Compatible エンドポイントを使用します。
  • default:デフォルトのモデル ID、コンソールで公開されているモデル ID と完全に一致する必要があります。
  • base_url:/v1 を添付する必要があります。Hermes はこれを基に /chat/completions をリクエストします。
  • key_env:キーを保存する環境変数の名前を指します。

~/.hermes/.env を編集:

AI2SAVE_API_KEY=sk-あなたのAPIキー

.env は機密情報を保存し、config.yaml は非機密のモデル構成を保存します。.env を Git に提出しないでください。

4. 設定コマンドを使用して書き込む

Hermes に付属のコマンドを使用することもでき、YAML のインデントエラーを避けられます:

hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-あなたのAPIキー
hermes config check

AI2SAVE_API_KEY は大文字環境変数名で、Hermes は自動的に ~/.hermes/.env を書き込みます。

5. 再起動と確認

  1. 現在の Hermes セッションまたは Gateway から完全に終了します。
  2. Hermes を再起動します。
  3. 新しいセッションを作成し、短い質問を送信します。
  4. セッション内で /model を入力し、現在のモデルが custom/gpt-5.5 または gpt-5.5 であることを確認します。

一時的に指定モデルを使用する場合:

hermes chat --provider custom --model gpt-5.5

初回の検証では、並列タスクや複雑なツールはオフにし、短いテキストのみを送信することを推奨します。認証とモデル接続が確認できたら、順次 terminal、web、file などのツールを有効にしてください。

6. よくあるエラー

  • 401 / invalid_api_key:AI2SAVE_API_KEY が存在しないか、値が不完全です。hermes config get model.key_env を実行して参照を確認してください。
  • 404 / model not found:model.default はコンソールで公開されている実際のモデルIDではありません。
  • 接続失敗:base_url は https://ai2save.com/v1 であるべきです;https://ai2save.com と書かないでください。
  • 設定が反映されない:旧 OPENAI_BASE_URL は openai-api Provider のみに影響し、自動的に custom には適用されません;config.yaml 内の model.base_url を確認してください。
  • YAML の解析失敗:重複する model: ブロックを作らず、すべてのフィールドを同じブロックにまとめてください。
  • ツール呼び出し例外:まずモデルが tool calling をサポートしていることを確認し、短いテキストでリクエストしてベースラインを作成してからツールセットを有効にしてください。