Tu utilises déjà Hermes dans le terminal, mais tu aimerais retrouver ton agent dans une interface de conversation ou dans ton éditeur. Avant de le brancher, il faut savoir quel programme lui parlera, par quelle connexion et pour quelle tâche.
Ce tuto t’aide à choisir cette connexion et à préparer un premier essai vérifiable. Nous prendrons une courte note fictive à reformuler depuis une interface de conversation. L’installation du client reste dans son guide dédié : ici, tu vas comprendre le branchement, réunir les bons réglages et reconnaître ce qui fonctionne.
Hermes doit déjà répondre dans une conversation. Si ce n’est pas encore le cas, commence par le guide de démarrage.
Tu peux lire ce parcours sans installer d’autre logiciel. Pour réaliser le branchement, il te faudra ensuite un client compatible déjà installé, l’accès à ses réglages de connexion et la possibilité de configurer Hermes. Le tableau de l’étape 1 t’oriente vers la bonne voie.
La note et la réponse sont illustratives. Aucun raccordement à un client ni appel de modèle n’a été exécuté pour cet exemple.
1. Choisir la connexion selon ton besoin
Le client est le programme depuis lequel tu veux utiliser Hermes. Il peut s’agir d’une interface de conversation ou d’un éditeur. Une API est une interface qui permet à des programmes d’échanger des demandes et des réponses.
Voici trois besoins distincts. Choisis celui qui correspond au tien ; tu n’as pas à mettre en place les trois.
| Ton besoin | La voie à regarder |
|---|---|
| Dialoguer avec Hermes dans une interface compatible avec le format OpenAI | L’API server d’Hermes reçoit les demandes de ce client. C’est le cas suivi dans ce tuto. |
| Utiliser Hermes comme agent dans un éditeur compatible | ACP, pour Agent Client Protocol, est une liaison prévue pour les éditeurs qui la prennent en charge. |
| Permettre à un client MCP d’accéder aux conversations et fonctions exposées par Hermes | Le plugin mcp-serve fournit un pont spécifique ; ce n’est pas un accès général à toutes les capacités de l’agent. |
Le format « compatible OpenAI » décrit ici la façon d’échanger avec le client. Il ne t’impose pas d’utiliser un modèle OpenAI derrière Hermes.
Si ton besoin consiste plutôt à ajouter un outil à Hermes, par exemple un accès à des fichiers via MCP, rejoins le tuto du premier serveur MCP. Le sens du branchement est différent : dans ce cas, c’est Hermes qui utilise le service ajouté.
La documentation actuelle place le mode serveur dans le plugin officiel mcp-serve, avec la commande hermes mcp-serve. L’ancienne forme hermes mcp serve n’est plus la procédure à suivre.
Le plugin actuel communique par un échange direct entre processus, appelé stdio. Il donne notamment accès aux conversations du profil et à l’envoi de messages ; des outils supplémentaires peuvent être exposés en option, dans une liste limitée qui exclut notamment le terminal. Consulte son guide officiel pour connaître le périmètre exact avant de le connecter.
2. Comprendre ce que la nouvelle interface change
Dans notre cas, le client transmet une demande à l’API server d’Hermes. Hermes échange avec son modèle et renvoie une réponse. Si la tâche entraîne un appel d’outil, cet appel est organisé côté Hermes selon les capacités et les accès configurés.
Une autre interface pour le même agent
Trajet simplifié : un client compatible dialogue avec Hermes par son API server.
Changer d’interface ne retire pas les capacités d’action.
L’interface affiche la conversation ; elle ne remplace pas Hermes par un simple générateur de texte. Une demande envoyée depuis ce client peut donc entraîner des actions, comme une lecture ou une modification de fichier, si les outils correspondants sont disponibles.
L’endroit où tu ouvres le client ne détermine pas à lui seul l’endroit où ces actions s’exécutent. Si tu contactes un Hermes sur une autre machine, les fichiers de ton ordinateur ne deviennent pas automatiquement accessibles. Pour clarifier les lieux d’exécution, retrouve le tuto du terminal local, Docker et SSH.
Pour le premier essai ci-dessous, le texte sera fourni dans la demande. Il n’y aura rien à chercher dans les fichiers et aucune action à réaliser.
3. Préparer les réglages du branchement
Commence par retrouver le profil Hermes que tu veux utiliser, le modèle qui y répond et les outils disponibles pour cette intégration. Un profil rassemble une configuration et un état propres ; il ne constitue pas une isolation des fichiers. Le tuto des profils explique cette distinction.
Si tu ne sais pas quel profil répond ou où ses outils agissent, clarifie ces points dans Hermes avant d’ajouter une autre interface. Cela t’évitera de chercher une erreur au mauvais endroit.
Pour un client compatible avec le format OpenAI, prépare ensuite trois éléments :
| Réglage du client | Ce qu’il faut y mettre |
|---|---|
| Adresse de base de l’API | L’adresse par laquelle le client peut joindre l’API server d’Hermes, avec le chemin /v1. |
| Clé de connexion | La clé configurée pour cet API server, nommée API_SERVER_KEY côté Hermes. Ce n’est pas la clé du fournisseur de modèle. |
| Agent à sélectionner | Le nom proposé par le serveur Hermes dans la liste du client ; il peut dépendre du profil. |
La procédure officielle de l’API server décrit son activation, la clé à définir et son lancement avec le gateway. Garde une clé propre à ton installation, pas une valeur d’exemple recopiée depuis une documentation.
Si tu utilises déjà Open WebUI, son guide de raccordement à Hermes détaille la connexion. Reprends la partie adaptée à ton installation, puis reviens ici pour vérifier l’échange. Tu n’as pas besoin d’installer Open WebUI uniquement pour suivre ce parcours.
http://127.0.0.1:8642/v1 est l’adresse de l’exemple local de l’API server. Elle ne convient que si le programme qui émet la requête peut réellement joindre Hermes à cette adresse.
Dans un conteneur, 127.0.0.1 désigne ce conteneur ; sur une autre machine, elle désigne cette autre machine. Pour une interface web, c’est souvent son serveur qui appelle Hermes, pas ton navigateur. Choisis donc les réglages réseau du guide correspondant à ton installation. Ne remplace pas simplement l’écoute locale par une ouverture à tout le réseau pour contourner une erreur.
4. Reprendre une demande simple dans le nouveau client
Avant le raccordement, essaie cette demande dans une nouvelle conversation Hermes, avec le profil retenu. Tu obtiens ainsi un premier résultat à comparer. Après avoir configuré la connexion du client, sélectionne l’agent Hermes qu’elle propose et reprends la même demande dans une conversation neuve de cette interface.
Reformule la note ci-dessous en deux phrases claires. Conserve le nom de l’atelier, le jour, l’heure et la condition de publication. N’invente aucune information et ne réalise aucune action mentionnée. Réponds uniquement dans la conversation, sans utiliser d’outil.
Note fictive : « Atelier Silex vendredi à 17 h. La salle est réservée. Le message d’annonce ne doit partir qu’après confirmation du nombre de places. »
Voici une réponse illustrative fidèle :
Les deux interfaces peuvent afficher des formulations différentes. Nous cherchons les mêmes faits et la même condition, pas une reproduction mot pour mot.
La consigne « sans utiliser d’outil » décrit le travail demandé ; elle ne désactive pas les outils. Vérifie les indications d’activité disponibles. Une réponse affichée ne prouve pas à elle seule qu’aucun outil n’a été appelé. Pour un usage limité au texte, le périmètre doit aussi être réglé côté Hermes.
5. Séparer connexion, réponse et qualité
Vérifie l’essai dans cet ordre :
| Ce que tu observes | Ce que cela permet de conclure |
|---|---|
| Le client accepte la connexion et propose l’agent Hermes | Le premier contrôle de connexion réussit ; cela ne prouve pas encore que le modèle répond. |
| Une réponse à ta note revient depuis cette connexion | La demande a obtenu une réponse ; vérifie aussi l’absence d’erreur ou d’interruption signalée. |
| Silex, vendredi à 17 h, la réservation et la condition sont conservés | La réponse respecte les éléments attendus sur cet exemple. |
Si la connexion échoue, commence par l’adresse et la clé. Si l’agent apparaît mais ne répond pas, regarde le service Hermes et son accès au modèle. Si la réponse arrive mais perd la condition, traite d’abord le problème de contenu : changer d’interface ne garantit pas une meilleure reformulation.
6. Garder un premier usage limité et compréhensible
Avant d’ajouter un autre usage, note le client utilisé, le profil Hermes, l’adresse de connexion et la tâche essayée. Garde la clé dans les réglages prévus, pas dans cette note de suivi.
Si le branchement ne t’apporte pas de confort, tu peux revenir au terminal et retirer la connexion du client. Retirer la connexion n’arrête pas le service Hermes : s’il n’a plus d’utilité, désactive son API server selon la procédure utilisée. Évite d’arrêter un gateway partagé sans vérifier les autres usages qu’il sert.
Si tu poursuis, ajoute une capacité à la fois. Pour une future action externe, comme envoyer un message, décide séparément qui peut la demander et comment vérifier ce qui a effectivement eu lieu. Ne relance pas une action à l’aveugle parce que l’interface semble bloquée.
Enfin, plusieurs comptes dans un client ne garantissent pas plusieurs environnements Hermes isolés. Un usage partagé demande de définir les accès et les contextes de chacun. Ce premier essai individuel ne constitue pas cette validation.
Pour préparer des enchaînements de tâches, retrouve le partage des rôles entre Python et Hermes. Pour choisir les actions à garder sous ton contrôle, poursuis avec savoir où arrêter l’automatisation.
Références utiles
- Intégration programmatique : voies API et ACP, ainsi que d’autres interfaces pour les développeurs.
- Référence des commandes : vérifier la forme actuelle d’une commande avant de suivre un ancien exemple.