Die Protokolle des Hermes-Agenten sind hauptsächlich für ~/.hermes/logs/ und hermes logs. Nachdem v0.8.0 die Logs zentralisiert hat, muss die übliche Fehlersuche nicht mehr überall umgedreht werden: Schau dir in der Regel zuerst die errors.log an, dann die agent.log und dann die gateway-bezogenen Logs, falls es ein Problem mit der Messaging-Plattform ist.
Wie man die drei Logbucheinträge verwendet
| Eingang | Was eignet sich für die Fehlersuche |
|---|---|
hermes logs | Quick Tail, filtere den aktuellen laufenden Status |
errors.log | Startfehler, Werkzeugfehler und Konfigurationsfehler |
agent.log | Modellaufrufe, Werkzeugausführungen und Sitzungsflüsse |
| Gateway-Log | Probleme beim Senden und Empfangen von Telegram, Discord, Slack und Webhook |
Empfohlene Fehlerbehebungsreihenfolge
- Reproduziere zuerst das Problem, ändere die Konfiguration nicht nur aufgrund von Impressionen.
- Führe
hermes logsdurch, um aktuelle Fehler zu sehen. - Wenn es in der Startphase scheitert, starten Sie
hermes config checkzuerst. - Wenn das Gateway nicht auf die Nachricht antwortet, sehen Sie sich das Plattform-Token, die Allowlist, die Kanalberechtigungen und die Gateway-Protokolle an.
- Wenn das Modell langsam oder fehlerhaft ist, siehe Anbieter, Modellname, 429/402/Authentifizierungsfehler.
Poste keine Protokolle
Obwohl Hermes Agent Geheimnisse schwärzt, solltest du es trotzdem überprüfen, bevor du es an die Community oder Kollegen schickst, insbesondere die URL-Abfrage, Header, Plattformtoken, privaten Dateipfad und Benutzer-ID. Wenn du den Fehlertyp und die letzten paar Dutzend Zeilen posten kannst, poste nicht das gesamte Protokoll.
Ein Tipp: Speichere das Fehlerprotokollfragment, bevor du die Konfiguration änderst, und vergleiche dann, ob dieselbe Aufgabe kürzer ist und ob es weniger ähnliche Fehler gibt. Das macht es einfacher, den wahren Grund zu finden, als "neu zu installieren".
Offizielle Open-Source-Adresse: https://github.com/NousResearch/hermes-agent; Offizieller Dokumenteneintrag: https://hermes-agent.nousresearch.com/.