Aller au contenu
FR
Ajouter à Chrome

Connecter un agent Hermes

TutorielNouveau

Pour qui fait tourner un agent Hermes sur un ordinateur à soi et veut lui parler depuis Riff Home. Les agents servent uniquement au chat : Riff n’envoie jamais une réponse ou un post à un agent, car ils contiennent du texte venu du web et un agent peut exécuter des commandes.

Ajoutez l’agent, mettez dans son .env la ligne affichée par la carte, redémarrez le gateway, et il se connecte.

1. Activer le serveur d’API de Hermes

Sur l’ordinateur de l’agent, ajoutez ces lignes à ~/.hermes/.env :

LigneCe qu’elle fait
API_SERVER_ENABLED=trueActive le serveur d’API auquel Riff parle (port 8642)
API_SERVER_KEY= et une longue clé aléatoireLa clé que Riff enverra. Toute personne qui a cette clé et l’adresse peut utiliser votre agent
API_SERVER_CORS_ORIGINS=chrome-extension:// et l’ID de RiffLaisse entrer cette copie de Riff (l’étape 3 montre la ligne exacte)

Ajoutez API_SERVER_HOST=0.0.0.0 seulement si Riff joint l’agent par votre réseau plutôt que par un tunnel.

2. Redémarrer le gateway

Le serveur d’API fait partie du gateway de Hermes. Depuis un terminal sur cet ordinateur, lancez hermes gateway restart (ou démarrez-le avec hermes gateway).

  • Pas hermes serve : il lance le tableau de bord, pas le serveur d’API.
  • Redémarrez-le depuis un terminal ordinaire. Demander à l’agent de redémarrer son propre gateway met fin à la session dans laquelle il tourne.

3. L’ajouter dans Riff

  1. Dans Riff Home › Models (Modèles), cliquez sur Add (Ajouter) dans Add a model app (Ajouter une application de modèles).
  2. Application : Hermes agent (Agent Hermes). Adresse : là où il répond, comme 192.168.1.30:8642 ou l’adresse de votre tunnel, agent.yourdomain.com. Clé d’API : la API_SERVER_KEY de l’étape 1.
  3. Cliquez sur Save and connect (Enregistrer et connecter) et autorisez la demande du navigateur pour cette adresse.
  4. La carte indique Connected (Connecté) et Chat with this agent (Discuter avec cet agent). C’est fait : voir Discuter avec votre agent.

« Un réglage requis » : la ligne de l’ID de l’extension

Hermes laisse toute personne qui a la clé lire sa liste de modèles, mais il n’agit que pour les extensions de navigateur qu’il connaît. La carte peut donc trouver l’agent alors que chaque message du chat est refusé. Riff le vérifie, et la carte indique alors Needs one setting (Un réglage requis) avec la ligne exacte, ID de Riff compris :

API_SERVER_CORS_ORIGINS=chrome-extension:// suivi de l’ID de Riff.

  1. Copiez la ligne de la carte dans ~/.hermes/.env. Si la ligne existe déjà, ajoutez le nouvel ID après une virgule.
  2. Lancez hermes gateway restart.
  3. Cliquez sur Connect (Connecter) dans la carte.

L’ID appartient à cette copie de Riff dans ce navigateur. Riff dans un autre navigateur, ou rechargé comme nouvelle copie, a son propre ID et a besoin de sa propre entrée.

Le joindre de partout : un tunnel

Un tunnel donne à l’agent une adresse https sans ouvrir de port sur votre box. Avec un Cloudflare Tunnel, dirigez un nom d’hôte vers le port de l’agent sur cet ordinateur. Dans ~/.cloudflared/config.yml :

  • hostname: agent.yourdomain.com
  • service: http://localhost:8642

Ajoutez ensuite agent.yourdomain.com dans Riff comme ci-dessus. L’agent peut continuer d’écouter sur localhost : vous n’avez donc pas besoin de API_SERVER_HOST. Avec un tunnel, ce que vous tapez passe par Cloudflare jusqu’à votre ordinateur.

Protéger la clé

Avec un tunnel, la clé est le seul verrou entre internet et un agent qui peut exécuter des commandes sur votre ordinateur.

  • Utilisez une longue clé aléatoire, et changez-la si elle a pu fuiter.
  • Riff la garde à part de vos autres paramètres, là où seules les pages de Riff peuvent la lire. Elle ne figure jamais dans une sauvegarde ni dans Copy agent log (Copier le journal de l’agent).
  • Réduisez la liste des commandes que l’agent peut lancer sans demander. Riff affiche les demandes d’approbation de l’agent Discuter avec votre agent, mais seulement pour ce que l’agent demande.