Architecture Hermes Agent

Architecture Hermes Agent

Cette page répond à l'intention de recherche: comprendre architecture interne. Elle sert à relier les points d'entrée, le cœur agent, les providers, les outils et le stockage. Le contenu reste en français, s'appuie sur la documentation officielle Hermes Agent, et garde les commandes ou noms propres uniquement quand ils aident vraiment à agir.

À retenir

  • Repérer les entrées: CLI, gateway, ACP, API, batch et bibliothèque Python.
  • Comprendre la boucle agent: prompt builder, provider resolution et tool dispatch.
  • Situer le stockage: sessions, état SQLite, mémoire, skills et logs.
  • Relier les backends d'outils: terminal, navigateur, web, MCP, fichiers, médias et cron.

Ce que cette page permet de décider

Relier les points d'entrée, le cœur agent, les providers, les outils et le stockage. La bonne lecture consiste à partir du besoin réel, choisir la page ou la commande utile, puis vérifier le résultat avant d'ajouter une couche supplémentaire.

Parcours recommandé

  1. Repérer les entrées: CLI, gateway, ACP, API, batch et bibliothèque Python.
  2. Comprendre la boucle agent: prompt builder, provider resolution et tool dispatch.
  3. Situer le stockage: sessions, état SQLite, mémoire, skills et logs.
  4. Relier les backends d'outils: terminal, navigateur, web, MCP, fichiers, médias et cron.

Exemples concrets

  • Un problème de réponse modèle appartient à la couche provider.
  • Un problème d'outil appartient au registre ou au backend d'outil.
  • Un problème de reprise de contexte appartient au stockage de session.

Erreurs fréquentes

  • Lire cette page comme une promesse générale au lieu d'un point de décision précis.
  • Ajouter une couche avancée alors que le chat simple ou le provider n'est pas encore validé.
  • Oublier que la source officielle reste la référence pour les commandes exactes et les détails de version.

Comment vérifier que vous êtes sur la bonne page

La bonne page est celle qui réduit l'incertitude immédiatement. Si vous cherchez une commande, il faut une référence de commande. Si vous cherchez un démarrage, il faut un guide. Si vous cherchez une cause de panne, il faut revenir au niveau le plus simple qui fonctionne encore. Cette page doit donc vous aider à décider: continuer ici, ouvrir une page liée, ou retourner au socle d'installation et de configuration.

Limites à garder en tête

Le contenu ne remplace pas la documentation officielle. Il sert à la rendre lisible en français et à replacer chaque point dans un parcours d'utilisation. Les commandes, options, noms de modèle, providers et comportements internes peuvent évoluer. Pour une action critique, vérifiez toujours la source officielle en bas de page, puis testez dans un contexte limité avant de généraliser.

Quand ne pas aller plus loin

Ne continuez pas vers les fonctions avancées si le premier chat ne répond pas, si le provider n'est pas identifié, si le profil actif n'est pas clair, ou si les secrets ne sont pas rangés correctement. Dans ces cas, revenir à une vérification minimale fait gagner plus de temps que lire une page supplémentaire.

Critères de qualité avant de passer à la suite

Une page est utile si elle vous fait gagner une décision concrète: quelle commande lancer, quelle section ouvrir, quel prérequis vérifier, ou quel risque éviter. Si vous terminez la lecture sans savoir quoi tester, le sujet doit être repris depuis le guide parent. Pour Hermes Agent, les bons critères sont simples: un provider clair, une commande comprise, une sortie vérifiable, un contexte de session connu, et aucune information sensible exposée. Ce cadre évite de transformer une lecture technique en accumulation de réglages inutiles.

Cas pratique de lecture

Prenez toujours le chemin le plus court. Si le besoin est de démarrer, ne lisez pas les pages d'architecture. Si le besoin est de comprendre une commande, ne partez pas dans les cas d'usage. Si le besoin est de sécuriser un bot ou un serveur, ne restez pas sur la page d'accueil. Cette logique garde le site utile: chaque page doit envoyer vers la prochaine action, pas vers un labyrinthe.

Suite logique

Après la carte globale, ouvrez CLI commands, tools reference, mémoire et skills ou sécurité selon la couche à diagnostiquer.