Hermes Agent mit Muapi

Verwenden Sie Muapi-Textmodelle mit Hermes Agent, indem Sie Muapi als benutzerdefinierten OpenAI-kompatiblen Endpunkt konfigurieren.

1. Schlüssel erstellen und Modell auswählen

Erstellen Sie im Muapi-Dashboard einen API-Schlüssel und listen Sie die verfügbaren Textmodelle auf:

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

Wählen Sie ein Modell mit capabilities.tools: true. Hermes benötigt für Agenten-Workflows ein Kontextfenster von mindestens 64.000 Tokens. Prüfen Sie daher vor der Auswahl das Kontextlimit des Modells.

2. Hermes Agent konfigurieren

Starten Sie den Modell-Einrichtungsassistenten:

hermes model

Wählen Sie Custom endpoint und geben Sie Folgendes ein:

FeldWert
API-Basis-URLhttps://api.muapi.ai/v1
API-SchlüsselIhr Muapi-API-Schlüssel
ModellnameExakte Modell-ID aus Muapis Textmodellliste

Alternativ können Sie den Endpunkt in ~/.hermes/config.yaml festlegen:

model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: https://api.muapi.ai/v1
  key_env: MUAPI_API_KEY

Speichern Sie den Schlüssel in ~/.hermes/.env:

MUAPI_API_KEY=your-muapi-api-key

Ersetzen Sie YOUR_MODEL_ID durch die exakte Modell-ID aus der Muapi-Modellliste.

3. Hermes Agent starten

Starten Sie die CLI oder Terminal-Oberfläche und testen Sie eine kleine Aufgabe, die ein Tool verwendet:

hermes
# Oder:
hermes --tui

Wenn das Modell funktioniert, verbinden Sie Messaging-Plattformen mit hermes gateway setup.

Fehlerbehebung

  • Kann Hermes keine Verbindung herstellen, prüfen Sie, ob die Basis-URL auf /v1 endet, der Schlüssel verfügbar ist und die Modell-ID exakt stimmt.
  • Verwendet das Modell keine Tools, wählen Sie eines mit capabilities.tools: true.
  • Hermes benötigt ein Kontextfenster von mindestens 64K. Wählen Sie ein Modell, das dieses Minimum erfüllt.
  • Beginnen Sie mit einer kleinen Aufgabe und prüfen Sie die Nutzung im Muapi-Dashboard.

Hinweise zur Einrichtung benutzerdefinierter Endpunkte finden Sie in der Hermes-Agent-Anbieterdokumentation und aktuelle Einstellungen im Konfigurationsleitfaden.