Hermes Agent で RunAPI を使う。
Hermes Agent はチャットモデル用の OpenAI 互換カスタムエンドポイントを利用できます。Prompt を Hermes Agent に貼り付け、custom provider の作成を任せます。正確な YAML が必要なときだけ config タブを使ってください。
Configure this Hermes Agent install to use RunAPI.
Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a custom provider named runapi.
- Use base_url "https://runapi.ai/v1".
- Use key_env RUNAPI_API_KEY.
- Use api_mode chat_completions.
- Set model.provider to custom:runapi.
- Set the default model to gpt-5.2.
- Run `hermes doctor` and report any config problems before starting a session.
- If RUNAPI_API_KEY is missing, ask me to set it before starting Hermes Agent.
custom_providers:
- name: runapi
base_url: "https://runapi.ai/v1"
key_env: RUNAPI_API_KEY
api_mode: chat_completions
model:
provider: custom:runapi
default: gpt-5.2
export RUNAPI_API_KEY="runapi_xxx"
hermes model
hermes doctor
hermes
この設定で変わること
Hermes Agent は hermes model によるモデル選択に対応し、名前付きのカスタムエンドポイントも利用できます。最短の方法は、RunAPI のセットアップ Prompt を Hermes Agent に貼り付け、agent に設定更新を任せることです。キーは RUNAPI_API_KEY に置き、base URL は RunAPI の /v1 エンドポイントに設定し、長いセッションを始める前に hermes doctor を実行してください。
Prompt で Hermes Agent に RunAPI を設定する
セットアップ Prompt を貼り付ける
最初のタブの Prompt を Hermes Agent にコピーします。RUNAPI_API_KEY を読み込み、RunAPI を名前付き custom provider として追加するよう Hermes Agent に指示します。
Prompt をコピー
生成された設定を確認する
Hermes Agent は provider を custom:runapi にし、デフォルトを gpt-5.2 に設定し、key_env が RUNAPI_API_KEY を指す必要があります。
provider: custom:runapi
診断を実行する
設定を編集したら hermes doctor を実行し、その後 Hermes Agent を開いて短いテスト Prompt を送ってから大きなタスクに使ってください。
hermes doctor
設定項目
| 項目 | 値 | 目的 |
|---|---|---|
custom_providers.name |
runapi |
Hermes Agent が custom:runapi として選択できる名前付きカスタムエンドポイントを作成します。 |
base_url |
https://runapi.ai/v1 |
Hermes Agent を RunAPI の OpenAI 互換 API に向けます。 |
key_env |
RUNAPI_API_KEY |
RunAPI key をハードコードせず、環境変数から読み込みます。 |
api_mode |
chat_completions |
OpenAI 互換の chat request 形式を使います。 |
Hermes Agent 設定のよくある質問
はい。Hermes Agent はモデル選択とカスタムエンドポイントに対応しています。名前付き custom provider に RunAPI の /v1 base URL を設定し、API key を RUNAPI_API_KEY に置き、gpt-5.2 などの RunAPI モデルを選択します。
ガイド付きの選択を使いたい場合は hermes model を使います。サーバーや共有環境で再現しやすい設定が必要な場合は設定ファイルを編集します。どちらの場合も、最後に hermes doctor で確認してください。
Hermes Agent を起動する同じ shell、service unit、または gateway 環境に RUNAPI_API_KEY を設定します。GUI や daemon からの起動では、対話 shell の環境変数を常に引き継ぐとは限りません。
はい。RunAPI を custom:runapi として追加しても、他の Hermes Agent モデル選択肢は削除されません。設定済みモデルを切り替えるときは hermes model または /model コマンドを使ってください。
Hermes Agent で 1つの RunAPI key を使う。
カタログからモデルを選び、カスタムエンドポイントを設定して、次の agent 実行前に Hermes Agent を確認します。