Hermes Agent と Muapi の連携
Muapi をカスタム OpenAI 互換エンドポイントとして設定し、Hermes Agentでテキストモデルを利用します。
1. キーを作成してモデルを選ぶ
Muapi ダッシュボードで API キーを作成し、テキストモデルを一覧表示します。
curl -s "https://api.muapi.ai/v1/models?type=text" \
-H "Authorization: Bearer $MUAPI_API_KEY"
capabilities.tools: true のモデルを選びます。Hermes のエージェントワークフローには 64,000 トークン以上のコンテキストウィンドウが必要です。
2. Hermes Agent を設定
モデル設定ウィザードを起動します。
hermes model
Custom endpoint を選び、API base URL https://api.muapi.ai/v1、Muapi API キー、一覧にある正確なモデル ID を入力します。
または ~/.hermes/config.yaml を設定します。
model:
default: YOUR_MODEL_ID
provider: custom
base_url: https://api.muapi.ai/v1
key_env: MUAPI_API_KEY
キーは ~/.hermes/.env に保存します。
MUAPI_API_KEY=your-muapi-api-key
YOUR_MODEL_ID を Muapi の正確なモデル ID に置き換えてください。
3. Hermes Agent を起動
hermes
# または:
hermes --tui
ツールを使う小さな作業を試します。動作したら hermes gateway setup でメッセージングサービスを接続します。
トラブルシューティング
- URL が
/v1で終わること、キーが利用可能なこと、モデル ID が正確なことを確認します。 - ツールを使えない場合は
capabilities.tools: trueのモデルを選びます。 - Hermes には 64K トークン以上のコンテキストが必要です。
- 小さな作業から始めて Muapi ダッシュボードで利用状況を確認してください。
詳細はHermes Agent プロバイダードキュメントと設定ガイドを参照してください。