Les journaux de l’agent d’Hermès sont principalement pour ~/.hermes/logs/ et hermes logs. Après que la version v0.8.0 a centralisé les journaux, le dépannage courant n’a pas besoin d’être retourné partout : en général, regardez d’abord les errors.log, puis les agent.log, et enfin les journaux liés à la passerelle s’il s’agit d’un problème de plateforme de messagerie.
Comment utiliser les trois entrées de journal
| Entrée | Qu’est-ce qui convient pour le dépannage |
|---|---|
hermes logs | Quick tail, filtre le statut récent en cours |
errors.log | Défaillance de démarrage, erreur d’outil et erreur de configuration |
agent.log | Appels de modèles, exécutions d’outils et flux de session |
| Journal de passerelle | Problèmes d’envoi et de réception de Telegram, Discord, Slack et Webhook |
Ordre recommandé pour le dépannage
- Reproduisez d’abord le problème, ne changez pas la configuration uniquement sur la base des impressions.
- Faites
hermes logspour voir les erreurs récentes. - Si cela tombe en panne au stade de démarrage,
hermes config checklancez en premier. - Si la passerelle ne répond pas au message, consultez le jeton de plateforme, la liste des permis, les permissions du canal et les journaux de la passerelle.
- Si le modèle est lent ou en panne, voir fournisseur, nom du modèle, 429/402/erreur d’authentification.
Ne publiez aucun journal
Bien qu’Hermes Agent fasse la caviardage des secrets, vous devriez tout de même vérifier avant de l’envoyer à la communauté ou à des collègues, en particulier la requête URL, les en-têtes, le token de plateforme, le chemin du fichier privé et l’identifiant utilisateur. Si vous pouvez publier le type d’erreur et les quelques dizaines de lignes restantes, ne publiez pas tout le journal.
Un conseil : enregistrez le fragment du journal d’erreur avant de changer la configuration, puis comparez si la même tâche est plus courte et s’il y a moins d’erreurs similaires. Cela facilite la recherche de la vraie raison plutôt que de « réinstaller ».
Adresse officielle open source : https://github.com/NousResearch/hermes-agent ; Document officiel : https://hermes-agent.nousresearch.com/.
