Hermes Agent Bot Mode : tutoriel version 0.21

Introduction

Hermes Agent Bot Mode transforme les profils de Hermes Desktop en une équipe d’agents nommés, visibles et persistants. Vérifié avec Hermes Agent 0.21.0 et la documentation officielle le 4 septembre 2026, ce guide montre comment créer deux bots spécialisés, régler leurs capacités, utiliser leur Bot Chat, programmer des routines et organiser leur collaboration. L’approche est utile si vous répétez des responsabilités distinctes et voulez retrouver chaque agent au même endroit. Si une tâche est ponctuelle, courte ou ne justifie aucune identité durable, Bot Mode n’est pas le bon choix : une session simple ou une délégation temporaire reste plus légère.

Résumé rapide

1. Créez un Bot dans l’onglet Bots de Desktop : Hermes crée en réalité un profil isolé et son chat canonique.
2. Définissez un rôle étroit, puis activez seulement le modèle, les skills, les outils et les serveurs MCP nécessaires.
3. Testez manuellement le Bot Chat avant d’ajouter une routine, qui sera enregistrée comme un cron job Hermes.
4. Utilisez les mentions, les messages directs ou un groupe pour collaborer ; réservez delegate_task aux sous-tâches temporaires.
5. Choisissez Kanban lorsque le travail doit survivre aux sessions, porter un état durable et être distribué entre plusieurs workers.

Ce que change le Bot Mode dans Hermes 0.21

Un Bot est un profil Hermes présenté dans une interface adaptée au travail en équipe. Il conserve sa configuration, son modèle, sa mémoire, ses skills, ses identifiants et son historique. Bot Mode n’ajoute donc ni daemon dédié, ni stockage parallèle, ni nouvelle couche d’exécution. Le même agent reste accessible depuis Desktop et le terminal.

La parité CLI donne trois contrôles simples :

hermes -p researcher chat
hermes profile list
hermes cron list

Ces commandes sont celles documentées pour Hermes Agent 0.21.0. La première ouvre le profil researcher, la deuxième confirme que les Bots existent comme profils, et la troisième affiche les routines sous forme de jobs préfixés par [bot:<nom>]. Elles permettent de vérifier l’état sans dépendre uniquement de l’interface.

Un chat canonique par Bot

À la création, Desktop ouvre et épingle un Bot Chat canonique. Ce fil est la relation durable avec l’agent : ses messages, ses retours de routine et les notifications de collaboration se retrouvent au même endroit. Dans ce chat précis, /new et /reset sont redirigés vers une compaction du contexte afin de préserver le fil au lieu de créer une branche. Les sessions ordinaires du même profil gardent, elles, leur comportement habituel.

Cette distinction évite un piège courant : un Bot n’est pas « toutes les sessions d’un profil ». Il possède un fil de référence, tandis que des sessions annexes restent possibles. Masquer un Bot ne supprime ni son profil, ni ses groupes, ni ses routines ; c’est seulement un réglage d’affichage.

Une identité qui porte des capacités

Le nom et l’avatar facilitent le repérage, mais le vrai périmètre du Bot vient de son profil : SOUL.md, mémoire, modèle épinglé, skills, toolsets et serveurs MCP autorisés. Deux Bots peuvent donc utiliser des modèles différents et partager une même interface sans partager automatiquement leur contexte. Pour comprendre le cadre général avant de spécialiser des profils, consultez le guide Hermes Agent pour builders IA.

La thèse de ce guide est simple : Bot Mode devient utile quand l’identité durable réduit le coût de coordination. Ajouter des avatars à un processus flou multiplie seulement les endroits à surveiller.

Créer, configurer et faire collaborer vos Bots

1. Créer un premier Bot avec un mandat précis

Dans Hermes Desktop 0.21, ouvrez l’onglet Bots, puis cliquez sur New Agent. Le chemin rapide demande un nom, un titre et une description. Préférez un nom stable et une responsabilité vérifiable : researcher, titre « Veille technique », description « Collecte les sources officielles, date les informations et signale les incertitudes ».

Évitez les rôles vagues comme « assistant polyvalent ». Un bon mandat indique la sortie attendue, les sources privilégiées et le moment où l’agent doit vous rendre la main. Vérifiez ce périmètre dans son premier message.

Le panneau Advanced permet de partir d’un profil vierge ou de cloner un profil existant avec sa configuration, ses skills, son SOUL.md et sa mémoire. Le clonage accélère les rôles proches, mais peut propager des permissions inutiles. Pour un spécialiste sensible, utilisez Create empty, puis ajoutez chaque capacité explicitement.

2. Régler modèle, instructions et permissions

Épinglez un modèle seulement si le rôle l’exige. Un Bot de tri peut hériter du modèle principal ; un Bot de synthèse complexe peut recevoir un modèle plus robuste. Le pin est local au profil et ne change pas le modèle des autres Bots.

Rédigez ensuite un SOUL.md court : mission, critères de qualité, limites, format de sortie et conditions d’escalade. N’y copiez pas de secret. Les clés et jetons restent dans le mécanisme de credentials prévu par Hermes ; les instructions décrivent leur usage, jamais leur valeur.

Dans Capabilities, activez les skills, toolsets et serveurs MCP nécessaires, pas tout le catalogue. Un chercheur peut accéder au web et aux notes sans disposer d’outils de déploiement. Cette réduction de surface clarifie les choix de l’agent et limite les erreurs opérationnelles.

Après enregistrement, faites trois tests dans le Bot Chat : une demande normale, une demande hors périmètre et une demande qui devrait provoquer une escalade. Corrigez le mandat avant de créer une routine. Edit Profile permet de reprendre à tout moment le titre, la description, le modèle, les capacités, l’avatar et le SOUL.md.

3. Comprendre la persistance avant d’automatiser

Le profil isole configuration, mémoire, skills, credentials et historique. Cette continuité demande de la maintenance : une consigne obsolète ou une mémoire erronée peut influencer les exécutions suivantes. Revoyez régulièrement ses capacités.

Le Bot Chat centralise les résultats et erreurs des routines. Dans un groupe, chaque membre conserve plutôt une session persistante Group: <nom>. Une décision de groupe n’est donc pas automatiquement présente dans toutes les sessions privées : transmettez les éléments importants explicitement.

4. Ajouter une routine après validation manuelle

Le panneau Routines associe une tâche récurrente au Bot responsable. Le sélecteur construit la fréquence et les détails du calendrier ; le champ avancé accepte la chaîne de planification Hermes lorsque vous avez besoin d’un horaire précis. Une routine « préparer la veille chaque matin » devient un cron job portant un nom du type [bot:researcher] ….

Avant de l’activer, définissez l’entrée, la sortie, l’horaire et la conduite en cas d’échec. Puis contrôlez la création côté terminal :

hermes cron list

Le job doit apparaître avec le bon Bot et le bon calendrier. Au premier run, vérifiez résultat, heure d’exécution et logs. Une routine ne remplace pas la supervision : prévoyez une alerte si son absence bloque la production. Pour choisir entre horaire fixe et file, consultez cron ou queue workers pour agents.

5. Choisir le bon canal de collaboration

Bot Mode offre trois niveaux de coordination. Une @mention depuis un chat transmet une demande au Bot ciblé, attend sa réponse puis la rapporte avec attribution. Dans un Bot Chat canonique, l’outil message_agent permet aussi à un Bot d’écrire directement à un coéquipier ; l’envoi est asynchrone, et la réponse revient plus tard comme notification. Cet outil est réservé aux Bot Chats canoniques gérés par Bot Mode, pas aux sessions CLI ordinaires ni aux sessions membres d’un groupe.

Un groupe convient lorsqu’entre deux et six Bots doivent délibérer dans une salle partagée. Sans mention, les membres décident s’ils ont quelque chose à ajouter ; avec @nom, vous limitez le tour aux spécialistes visés. Hermes borne une demande à trois tours sériels et dix messages afin d’éviter une boucle. Un Bot peut passer son tour, et @user signale une décision qui exige votre jugement. Pour concevoir des rôles qui ne se recouvrent pas, appuyez-vous sur les principes d’architectures multi-agents.

Avec plusieurs connexions Desktop, des Bots peuvent vivre sur différentes machines. Leur calcul, leur mémoire, leurs chats et leurs routines restent sur la machine propriétaire. Les handles qualifiés par appareil évitent les collisions. Pour les pairs entre gateways, conservez la clé d’API serveur dans l’environnement Hermes ; ne la placez jamais dans une commande partagée ou une capture.

6. Ne pas confondre Bot Mode, delegate_task et Kanban

Mécanisme	Nature	Persistance	Bon usage
Bot Mode	Interface Desktop sur des profils Hermes	Profil, mémoire et chat canonique durables	Responsabilités récurrentes et équipe visible
delegate_task	Sous-agent synchrone lancé par un agent parent	Contexte isolé mais temporaire	Recherche ou implémentation bornée en quelques minutes
Kanban	File SQLite multi-profils et multi-workers	Tâches, dépendances, commentaires et état durables	Travail distribué qui doit survivre aux sessions

delegate_task ne crée pas un collègue permanent. Le parent attend le résultat du sous-agent ; si le parent est interrompu, la délégation n’est pas un système durable. Utilisez-le pour paralléliser une analyse, pas pour représenter une fonction stable de l’équipe.

Kanban répond à une autre question : comment distribuer, suivre et reprendre du travail avec des dépendances et un état partagé ? Il devient pertinent quand plusieurs workers doivent réclamer des tâches, signaler un blocage et laisser une trace. Bot Mode peut rendre les spécialistes accessibles, mais il ne remplace pas ce tableau de coordination. Plus largement, les choix d’orchestration multi-agents doivent partir du cycle de vie du travail, pas du nombre d’agents affichés.

Mini-checklist de validation

• Le Bot apparaît dans hermes profile list et s’ouvre avec hermes -p <bot> chat.
• Son rôle comporte une sortie, une limite et une règle d’escalade testées.
• Ses capacités sont minimales et aucun secret n’apparaît dans SOUL.md ou le chat.
• Sa routine apparaît dans hermes cron list, puis produit un premier résultat vérifié.
• Chaque collaboration a un canal choisi : mention, message direct, groupe, délégation ou Kanban.
• Un responsable humain sait où consulter les échecs, les logs et les décisions en attente.

Exemple concret

Prenons une petite équipe qui publie une veille hebdomadaire. Créez d’abord researcher, chargé de trouver des sources officielles datées, puis editor, chargé de transformer les notes validées en synthèse. Le premier Bot reçoit les outils web et un skill de recherche ; le second accède au dossier de notes et aux règles éditoriales, mais pas aux outils réseau inutiles.

Testez manuellement le flux. Dans le Bot Chat de researcher, demandez trois nouveautés accompagnées de leur URL, date et niveau de confiance. Rejetez toute entrée sans source primaire. Mentionnez ensuite @editor avec les notes approuvées et exigez une synthèse de 300 mots qui conserve les réserves. Le résultat attendu n’est pas que les deux Bots « discutent beaucoup », mais qu’une transmission attribuée produise un document vérifiable.

Quand deux cycles manuels réussissent, ajoutez au chercheur une routine chaque lundi à 8 h. Contrôlez-la avec hermes cron list, puis vérifiez que le run arrive dans son Bot Chat. Gardez la validation humaine avant l’envoi à l’éditeur pendant deux semaines. Mesurez trois signaux : sources invalides, corrections éditoriales et exécutions manquées.

Si les rôles se chevauchent, réduisez leur mandat. Si une exécution manque, examinez le job et les logs avant d’ajouter un troisième Bot. Si le volume devient une file de dizaines de sujets avec dépendances et reprises, migrez le suivi vers Kanban ; le duo de profils peut rester l’équipe d’exécution. Cet exemple prouve qu’une collaboration fiable vient d’un contrat de passage explicite, pas du nombre d’agents.

Bonnes pratiques

• Commencez avec deux Bots. Une équipe plus large augmente les coûts de coordination, les notifications et les zones de responsabilité floues. Le comparatif mono-agent ou multi-agent aide à vérifier que la séparation est justifiée.
• Donnez un propriétaire à chaque sortie. Un groupe peut débattre, mais un seul Bot ou un humain doit être responsable du livrable final.
• Versionnez les consignes métier hors des secrets. Documentez les changements de rôle et revoyez les capacités après un clonage ou une duplication.
• Observez avant d’automatiser. Validez deux exécutions manuelles, puis contrôlez le premier cron run, son heure, son résultat et ses erreurs.
• Bornez les transmissions. Indiquez format, délai, sources et règle d’escalade ; sinon les messages entre Bots deviennent une conversation difficile à auditer.
• Gardez une sortie simple. Si un seul agent et une checklist donnent le même résultat, restez sur cette approche plus simple.

En production, suivez au minimum les routines manquées, les erreurs d’outils, le coût par run et les demandes @user non résolues. Prévoyez aussi la maintenance des modèles épinglés, des skills et des connexions. Bot Mode rend l’équipe lisible ; il ne supprime ni l’observabilité ni la responsabilité humaine.

Créez d’abord deux Bots complémentaires avec une responsabilité claire chacun, puis ajoutez une routine seulement après avoir validé leur collaboration manuelle.

Questions fréquentes

Qu’est-ce que le Bot Mode de Hermes Agent 0.21 ?

Le Bot Mode Hermes 0.21 est une interface de Hermes Desktop qui présente des profils comme des Bots nommés. Chaque Bot conserve son rôle, son modèle, sa mémoire, ses skills, ses credentials et un Bot Chat canonique. Il ne crée pas un nouveau moteur ni un daemon supplémentaire : les mêmes profils restent accessibles avec les commandes CLI Hermes.

Comment créer une équipe d’agents Hermes dans Desktop ?

Ouvrez l’onglet Bots, cliquez sur New Agent, définissez nom, titre et description, puis réglez les capacités avancées. Commencez par deux Hermes Desktop bots aux responsabilités non chevauchantes. Testez leur travail séparément, puis leur passage de relais par mention ou groupe. N’ajoutez une routine qu’après avoir validé le processus manuel.

Quelle différence entre Bot Mode et delegate_task dans Hermes ?

Un Bot est un profil durable avec mémoire, configuration et chat canonique. delegate_task lance au contraire un sous-agent temporaire pour une tâche bornée ; le parent attend son résultat et la délégation ne constitue pas une équipe persistante. Choisissez Bot Mode pour une responsabilité récurrente, et delegate_task pour paralléliser ponctuellement une recherche ou une implémentation.

Où retrouver les routines des Bots Hermes ?

Les routines Hermes bots sont des cron jobs ordinaires, nommés avec un préfixe [bot:<nom>]. Elles sont visibles dans le panneau Routines, dans la page Cron et avec hermes cron list. Leurs exécutions reviennent dans le Bot Chat du profil responsable. Vérifiez toujours le premier run, son calendrier et ses erreurs avant de considérer l’automatisation comme fiable.

Articles liés

Bot Mode est un bon choix quand des responsabilités durables gagnent à être incarnées par des profils spécialisés ; il est superflu pour une tâche ponctuelle ou un processus encore instable. Commencez par deux rôles testés manuellement, puis choisissez routines, délégation ou Kanban selon la durée de vie réelle du travail. Les guides suivants permettent d’approfondir ce choix et de structurer la suite.

• Hermes Agent : guide pour builders IA
• Architectures multi-agents : structurer les rôles
• Orchestration multi-agents : coordonner les agents
• Connecter Hermes Agent à Telegram
• Déployer Hermes Agent avec Docker sur un VPS