Aller au contenu principal

Depannage Agents

En bref​

Ce guide couvre les problemes courants d'Agent Studio : erreurs d'outils, reponses incorrectes, timeouts de conversation et problemes de configuration.

Problemes de conversation​

L'agent ne repond pas​

Causes possibles :

  • Le fournisseur LLM est indisponible
  • La cle API du fournisseur est invalide ou expiree
  • Le timeout de reponse est depasse

Solutions :

  1. Verifiez le statut du fournisseur LLM dans Agent Studio > Monitoring.
  2. Verifiez la cle API du fournisseur dans les parametres du workspace.
  3. Reessayez apres quelques instants — les providers LLM peuvent avoir des pics de charge.

L'agent donne des reponses incorrectes​

Causes possibles :

  • Les instructions systeme sont trop vagues
  • L'agent n'a pas acces aux bons outils
  • Le contexte de la base de connaissances est insuffisant

Solutions :

  1. Ameliorez les instructions systeme de l'agent : soyez specifique sur le domaine, le ton et les limites.
  2. Verifiez les outils actives dans Agent Studio > Votre agent > Outils.
  3. Enrichissez la base de connaissances avec des documents plus pertinents.
  4. Testez avec le mode Visualiseur pour voir le raisonnement de l'agent etape par etape.

L'agent repete la meme reponse​

Cause : La temperature du modele est trop basse ou l'historique de conversation est trop court.

Solutions :

  1. Augmentez legerement la temperature dans la configuration de l'agent.
  2. Verifiez la taille de la fenetre de contexte — un historique trop court peut causer des repetitions.

Erreurs d'outils​

"Outil non disponible"​

Causes possibles :

  • L'outil a ete desactive ou supprime
  • L'agent n'a pas les permissions pour utiliser cet outil

Solutions :

  1. Verifiez la liste des outils actifs dans la configuration de l'agent.
  2. Reactivez l'outil si necessaire.
  3. Verifiez les scopes requis pour l'outil.

"Erreur d'execution de l'outil"​

Causes possibles :

  • Les parametres fournis a l'outil sont invalides
  • La source de donnees appelee par l'outil est indisponible
  • L'outil a depasse son timeout

Solutions :

  1. Consultez le detail de l'erreur dans le Visualiseur (boucle OODA).
  2. Verifiez que les sources de donnees utilisees par l'outil sont actives.
  3. Reessayez — l'agent peut corriger automatiquement les parametres lors du prochain essai.

L'agent n'utilise pas les bons outils​

Cause : Les descriptions des outils ne correspondent pas au contexte de la question.

Solutions :

  1. Ameliorez les descriptions des outils pour etre plus explicites sur leur cas d'usage.
  2. Ajoutez des exemples d'utilisation dans les instructions systeme de l'agent.
  3. Verifiez que l'agent a acces a suffisamment d'outils pour couvrir les questions attendues.

Problemes de performance​

Reponse trop lente​

Causes possibles :

  • Le modele LLM est surcharge
  • L'agent execute trop de boucles d'outils
  • La base de connaissances est volumineuse

Solutions :

  1. Utilisez un modele plus rapide pour les questions simples (configuration dans l'agent).
  2. Limitez le nombre d'iterations d'outils dans la configuration.
  3. Optimisez la base de connaissances en segmentant les documents par domaine.

"Conversation expiree"​

Cause : La conversation a depasse la duree maximale autorisee.

Solution : Reformulez votre question de maniere plus precise pour que l'agent puisse repondre en moins d'etapes.

Problemes de configuration​

L'agent ne voit pas les entites de l'ontologie​

Cause : L'outil de recherche ontologique n'est pas active.

Solution : Activez les outils ontologyContext et hybridSearch dans la configuration de l'agent.

L'agent ne trouve pas les documents​

Cause : Les documents n'ont pas ete indexes dans la base de connaissances.

Solutions :

  1. Verifiez que les documents sont importes dans Base de connaissances.
  2. Attendez la fin de l'indexation (visible dans le statut du document).
  3. Activez l'outil searchDocumentation dans la configuration de l'agent.

Voir aussi​

Besoin d'aide ?​

Ecrivez-nous : Support et contact.