Résolution des problèmes

L'agent ne répond pas

Que vérifier lorsqu’un agent ou un chatbot reste silencieux, affiche un message d’erreur ou donne une réponse générique.

Open in ChatGPT Open in Claude

Un agent peut ne pas répondre dans le chat de test du builder, dans un chatbot sur votre site ou via l’API. La cause est presque toujours l’un des points de contrôle ci-dessous. Parcourez la liste dans l’ordre, car les premiers sont les plus fréquents et les plus rapides à écarter.

Symptômes#

  • Vous envoyez un message et rien ne revient.
  • Le chat affiche une erreur au lieu d’une réponse.
  • Un visiteur du chatbot voit « Oops! Something went wrong. Please contact website owner! »

Causes probables, dans l’ordre#

1. L’espace de travail n’a plus de crédits#

Les agents ne peuvent pas fonctionner sans crédits. Recherchez la notification Read-only mode et vérifiez le nombre de crédits en bas de la barre latérale. Les appelants de l’API reçoivent « Insufficient credits to perform this action. Please recharge your credits. » Les visiteurs du chatbot voient « Sorry, you’ve reached your payment limit. » Voir crédits épuisés.

2. L’abonnement a pris fin ou l’espace de travail est en lecture seule#

Si le forfait a été annulé, l’espace de travail est inactif et les exécutions sont refusées avec « This workspace is inactive because its subscription ended. » Seul le propriétaire peut choisir à nouveau un forfait.

3. Une application dont l’agent a besoin n’est pas connectée#

Si un outil nécessite un compte que vous n’avez pas connecté, vous voyez un avertissement tel que « Slack integration is required, but was not found » ou « Component is not integrated », et une exécution qui atteint cet outil échoue avec « is not configured. Please set up the integration first. » Ouvrez Integrations et connectez-le. Voir intégration déconnectée.

4. La mémoire est activée sans catégorie#

Dans le builder d’agent, Memory nécessite une catégorie. Le builder avertit « Pick a category, or turn Memory off. The agent refuses to run while Memory is on with none picked. » Choisissez une catégorie sous Advanced, ou désactivez la mémoire. Voir mémoire et historique de chat.

5. Vos modifications sont enregistrées mais pas publiées#

Les modifications sont enregistrées en tant que brouillon. Les personnes qui utilisent l’agent en direct, y compris un chatbot sur votre site, voient la dernière version publiée jusqu’à ce que vous cliquiez sur Publish changes. Un déclencheur affiche « Publish to activate » tant que ce n’est pas fait. Voir partager et publier.

6. Le chatbot est désactivé ou limité en débit#

Dans Chatbots, ouvrez le chatbot et vérifiez que Chatbot enabled est activé. Les visiteurs qui envoient trop de messages voient « Too many requests. Please try again later or sign in to continue. » Les limites se trouvent sous Rate Limiting dans les paramètres du chatbot.

7. Une étape ou un outil a échoué#

Un outil ou une étape de l’agent peut échouer même lorsque le modèle lui-même fonctionne. Ouvrez History, trouvez la session, activez le filtre Error messages et lisez l’événement en échec. Voir une exécution a échoué.

Corriger le problème#

  1. Envoyez un court message de test dans le chat du builder et notez le texte exact de toute erreur.
  2. Faites correspondre ce texte à la liste ci-dessus et appliquez la correction.
  3. Publiez si vous avez apporté une modification, puis testez à nouveau depuis l’endroit où l’échec s’est produit, par exemple votre site.

Testez là où l'échec s'est produit

Reproduisez le problème au même endroit que celui où vos utilisateurs le rencontrent, qu’il s’agisse du chat de test, d’un chatbot sur votre site ou d’un appel API. Chacun a ses propres paramètres, et un chatbot a également ses propres limites de débit.