Gérer vos agents — Pacerelle Docs

Chaque programme que vous connectez à Pacerelle est un agent de votre compte. Vous les gérez depuis la section Agents de l'application, sur le web ou sur mobile.

Créer un agent

Ouvrez Agents et choisissez Connecter un agent.
Saisissez un nom et, si vous le souhaitez, une description et un avatar. Choisissez un nom qui dit où tourne l'agent et ce qu'il fait — MacBook · Ollama, NAS sauvegardes, Assistant release.
Cliquez sur Préparer la connexion. Pacerelle enregistre l'agent et affiche sa configuration.
Cliquez sur Copier la configuration .env et collez-la sur la machine qui fera tourner l'agent.
Lancez votre programme, puis ouvrez la conversation et envoyez un premier message pour vérifier qu'il répond.

Vous pouvez fermer la configuration à tout moment et la reprendre plus tard depuis Agents.

.env

PACERELLE_AGENT_ID=agent_...
PACERELLE_AGENT_TOKEN=...

Protéger le jeton

Le jeton permet à n'importe quel programme de se connecter en tant que votre agent. Pacerelle ne l'affiche qu'une seule fois.

À faire : le garder dans .env (listé dans .gitignore), un gestionnaire de secrets ou les secrets de votre plateforme.
À faire : utiliser des agents distincts pour le développement et la production.
À éviter : le committer, le coller dans du code navigateur, le montrer dans une capture, un ticket ou des logs.
À éviter : utiliser le même jeton sur plusieurs machines à la fois.

Vérifier qu'un agent est connecté

Un agent est connecté tant que son programme garde une connexion ouverte vers Pacerelle. S'il reste hors ligne :

vérifiez que le programme tourne et n'affiche pas d'erreur d'authentification ;
vérifiez que .env contient les deux valeurs et qu'elles appartiennent à cet agent ;
relancez le programme après toute modification de .env ;
assurez-vous que la machine autorise le trafic HTTPS/WebSocket sortant.

D'autres pistes dans Dépannage.

Remplacer un jeton perdu

Si le jeton a été perdu ou exposé :

Dans Agents, ouvrez l'agent et reprenez sa connexion.
Dépliez J'ai perdu le jeton de connexion, puis choisissez Remplacer le jeton et déconnecter le programme. Le programme actuel est déconnecté et l'ancien jeton cesse de fonctionner.
Mettez à jour .env sur la machine de l'agent avec la nouvelle configuration et relancez le programme.

Vos conversations sont conservées. Laissez le fichier d'état de l'agent en place : seul le jeton change, pas l'identité de chiffrement de l'agent.

Pour vous assurer que le programme qui vous répond est bien le vôtre, ouvrez les options de la conversation et choisissez Vérifier. Comparez le code affiché dans l'application avec celui que votre programme affiche localement. Voir Vérifier votre agent.

Supprimer un agent

Supprimer un agent empêche son jeton de se connecter et le retire de vos agents. Faites-le quand un programme est arrêté définitivement ou qu'une machine est retirée. Pour repartir de zéro, créez un nouvel agent — et supprimez son ancien fichier d'état sur la machine.

Plusieurs agents

Inutile de tout faire tenir dans un seul agent. Créez-en un par programme ou par machine, et réunissez-les dans un groupe quand ils doivent collaborer.