Support

Dépannage

Pannes fréquentes — clés, connecteurs, CSP du widget, récupération vide — et comment isoler la cause avant de contacter le support.

dépannageerreursdébogage

La plupart des incidents tournent autour des identifiants, du périmètre et du contenu obsolète. Cette page propose un ordre de triage rapide ; joignez journaux et horodatages à l’ouverture de tickets.

Reproduisez dans le chat de test du tableau de bord pour savoir si le problème est spécifique à un canal ou touche tout l’agent.

Erreurs de clés API et de modèle

401/403 indiquent généralement une clé incorrecte, une mauvaise organisation ou un identifiant BYOK expiré. Vérifiez que l’environnement (prod vs staging) correspond à la clé configurée.

Après rotation, redémarrez ou rafraîchissez les services dépendants qui mettent en cache les en-têtes.

Réponses faibles ou vides

Confirmez que l’agent utilise la base de connaissances attendue. Relancez les tâches de sync ou crawl si le contenu a changé récemment.

Vérifiez si les instructions sont trop restrictives — le modèle peut refuser même si la récupération est correcte.

Le widget ne charge pas

Vérifiez CSP, bloqueurs de publicité et placement du script. Cherchez des erreurs console mentionnant des hôtes connect-src bloqués.

Confirmez que la clé d’embed correspond à l’agent et aux listes de domaines autorisés si activées.

Erreurs de quota à l’import ou au crawl (402 / « limite atteinte »)

Si les imports de connaissances échouent avec une erreur type quota ou paiement après de nombreuses images ou fichiers média, vous avez peut-être épuisé les limites mensuelles hébergées de reconnaissance d’image Gemini ou transcription média.

Atténuation : ajoutez une clé API Google Gemini dans Paramètres → Clés API LLM pour que ces opérations utilisent votre projet Google, demandez à un administrateur d’augmenter les limites du forfait, ou importez temporairement des formats avec texte natif et désactivez le traitement média dans les crawls.

  • Les crawls qui activent image ou média requièrent une configuration Gemini résolvable (hébergée ou org) ; sinon, l’API refuse le démarrage du crawl avec un message Gemini manquant.
  • Le texte OCR seul depuis les images peut encore apparaître lorsque la vision est ignorée ; ne supposez pas que le fichier a totalement échoué — consultez le corps stocké du document.

Construisez sur votre stack

Prêt à déployer des assistants fondés sur vos données ?

Démarrez un essai ou parlez-nous de vos besoins de déploiement, gouvernance et exigences entreprise.