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 プロバイダードキュメントと設定ガイドを参照してください。