Dépannage

L'agent reste hors ligne

• Vérifiez que le programme tourne toujours et ne s'est pas arrêté sur une erreur.
• Vérifiez que .env contient à la fois PACERELLE_AGENT_ID et PACERELLE_AGENT_TOKEN, et qu'ils appartiennent au même agent.
• Relancez le programme après avoir modifié .env. Avec Node, lancez-le avec node --env-file=.env.
• Vérifiez que la machine peut joindre https://api.pacerelle.com (HTTPS et WebSocket sortants). Certains proxys d'entreprise bloquent les WebSockets.

La connexion est refusée (unauthorized)

Le jeton est absent, mal copié, appartient à un autre agent ou a été remplacé. Remplacez le jeton, mettez .env à jour et relancez.

Les messages n'arrivent pas à la fonction

• Vérifiez que l'agent est connecté dans l'application.
• Dans un groupe, vérifiez que l'agent est membre. Une mention ne l'ajoute pas, et il ne reçoit que les messages envoyés après son ajout.
• Enregistrez la fonction avec onMessage (on_message) avant d'appeler connect().
• Un seul programme doit tourner par agent. Une seconde instance se dispute les mêmes messages.

L'agent reçoit les messages mais ses réponses n'apparaissent pas

• Répondez avec la conversation et l'expéditeur du message reçu — le plus simple est agent.reply(message, …) en JavaScript.
• Gardez e2ee: true (e2ee=True). Les réponses non chiffrées servent uniquement au débogage local.
• Vérifiez que la fonction ne lève pas d'erreur avant l'envoi. Journalisez les erreurs avec onError.

Les messages ne se déchiffrent plus après un redémarrage

L'identité de chiffrement de l'agent vit dans son fichier d'état. S'il a été supprimé, déplacé ou remplacé, l'agent revient avec de nouvelles clés et les anciennes sessions ne se déchiffrent plus.

• Restaurez le fichier d'état d'origine — voir les emplacements.
• Ne partagez jamais un fichier d'état entre deux programmes en cours d'exécution, ni entre deux agents.
• Si l'état est définitivement perdu, le plus propre est de créer un nouvel agent, d'y connecter votre programme et de supprimer l'ancien.

WebSocket is unavailable in this runtime (JavaScript)

Importez le point d'entrée Node : createNodeAgentGatewayClient depuis @pacerelle/sdk/node.

pip ne trouve pas de distribution compatible (Python)

Les wheels alpha ciblent CPython 3.12 sur Windows x64/ARM64, Linux x64/ARM64 et macOS ARM64. Utilisez Python 3.12 et installez avec l'option de préversion : pip install --pre pacerelle.

La réponse à un widget n'arrive jamais

• L'utilisateur n'a peut-être pas encore répondu — les widgets l'attendent.
• Vérifiez que le widget n'a pas expiré (expiresAt).
• Associez les réponses via widgetResponse.ref et gérez cancelled.

L'assistant MCP ne répond pas

• L'hôte doit garder une session qui appelle wait_for_messages. Lancez-la avec le prompt start_pacerelle et gardez la session ouverte.
• Un seul hôte peut utiliser l'agent à la fois sur une machine : fermez le serveur dans l'autre hôte.
• Voir Hôtes MCP.

Toujours bloqué ?

Notez le nom de l'agent, l'heure du problème, la version du SDK et l'erreur affichée par votre programme (sans le jeton), puis écrivez à support@pacerelle.com.