Dépannage

Ce guide vous aide à diagnostiquer et résoudre les problèmes courants avec les agents IA TeamDay, les outils et les intégrations.

Problèmes courants des agents

Agent ne répond pas

Symptômes

L'agent ne répond pas aux messages
Longs délais dans les réponses
Messages d'erreur dans le chat

Étapes de dépannage

Vérifier le statut de l'agent
- Vérifiez que l'agent est actif (non mis en pause ou désactivé)
- Recherchez les indicateurs d'erreur sur le tableau de bord de l'agent
- Confirmez que l'agent a les permissions nécessaires
Vérifier la connectivité
- Vérifiez la connexion internet
- Actualisez la page du navigateur
- Essayez d'accéder depuis un appareil différent
Examiner les changements récents
- Vérifiez si la configuration de l'agent a été récemment modifiée
- Vérifiez qu'aucun outil ou intégration n'a été désactivé
- Confirmez que la base de connaissances est accessible
Statut du système
- Consultez la page de statut TeamDay pour les pannes
- Vérifiez qu'aucune fenêtre de maintenance n'est active
- Recherchez les notifications de dégradation du service

Résolution

Redémarrez l'agent si le statut affiche des erreurs
Contactez le support avec les messages d'erreur spécifiques
Vérifiez les logs pour des informations d'erreur détaillées

Qualité de réponse médiocre

Symptômes

Réponses inexactes ou non pertinentes
Comportement incohérent de l'agent
Échec à suivre les instructions

Étapes de dépannage

Examiner les prompts
- Vérifiez si les instructions sont claires et spécifiques
- Vérifiez que les exemples sont appropriés
- Assurez-vous que le contexte est suffisant
Problèmes de base de connaissances
- Confirmez que les informations pertinentes sont dans la base de connaissances
- Vérifiez les informations obsolètes ou conflictuelles
- Vérifiez que la base de connaissances est correctement indexée
Examen de la configuration
- Vérifiez les paramètres et options de l'agent
- Vérifiez que les permissions des outils sont correctes
- Confirmez les configurations d'intégration

Résolution

Affinez les prompts avec des instructions plus spécifiques
Mettez à jour la base de connaissances avec les informations actuelles
Ajustez les paramètres de configuration de l'agent
Fournissez plus d'exemples d'entraînement

Problèmes d'outils et d'intégrations

Outils personnalisés ne fonctionnent pas

Symptômes

Les outils n'apparaissent pas dans l'interface agent
Messages d'erreur lors de l'utilisation des outils
Comportement inattendu des outils

Étapes de dépannage

Vérification des permissions
- Vérifiez les permissions des outils dans les paramètres de l'agent
- Confirmez que l'utilisateur a accès aux outils requis
- Vérifiez les restrictions d'outils au niveau de l'organisation
Validation de la configuration
- Examinez les paramètres de configuration des outils
- Testez l'outil indépendamment de l'agent
- Vérifiez les clés API et les credentials
Vérification de compatibilité
- Assurez-vous que l'outil est compatible avec la version actuelle de l'agent
- Vérifiez les mises à jour ou dépréciation d'outils
- Vérifiez que les exigences système sont satisfaites

Résolution

Mettez à jour les configurations d'outils
Ré-authentifiez les connexions API
Contactez le fournisseur d'outil pour les problèmes spécifiques
Implémentez des outils alternatifs si nécessaire

Échecs d'intégration API

Symptômes

Timeouts de connexion
Erreurs d'authentification
Problèmes de synchronisation de données

Étapes de dépannage

Vérification de l'authentification
- Vérifiez que les clés API sont actuelles et valides
- Vérifiez les dates d'expiration des tokens
- Confirmez que la méthode d'authentification est correcte
Diagnostics réseau
- Testez les endpoints API manuellement
- Vérifiez les paramètres de pare-feu et de sécurité
- Vérifiez la connectivité réseau
Limitation de débit
- Vérifiez si les limites de débit API sont dépassées
- Examinez les patterns d'utilisation et la fréquence
- Implémentez des mécanismes de retry appropriés

Résolution

Actualisez les tokens d'authentification
Ajustez les paramètres de limitation de débit
Contactez le fournisseur d'API pour support
Implémentez des méthodes d'intégration de secours

Problèmes de performance

Temps de réponse lents

Symptômes

Longs délais dans les réponses de l'agent
Erreurs de timeout
Mauvaise expérience utilisateur

Étapes de dépannage

Vérification de la charge système
- Surveillez les ressources système et l'utilisation
- Vérifiez les périodes d'utilisation de pointe
- Vérifiez qu'aucun processus en arrière-plan n'interfère
Optimisation de la configuration
- Examinez la configuration de l'agent pour la performance
- Vérifiez la taille et la complexité de la base de connaissances
- Optimisez la longueur et la complexité des prompts
Analyse réseau
- Testez la vitesse de connexion internet
- Vérifiez la congestion réseau
- Vérifiez les temps de réponse du serveur

Résolution

Optimisez les configurations d'agent
Implémentez des mécanismes de mise en cache
Augmentez les ressources système si nécessaire
Contactez le support pour l'optimisation de performance

Problèmes de mémoire et de ressources

Symptômes

Erreurs de mémoire insuffisante
Plantages ou gels du système
Performance dégradée au fil du temps

Étapes de dépannage

Surveillance des ressources
- Vérifiez les patterns d'utilisation de la mémoire
- Surveillez l'utilisation CPU et disque
- Identifiez les opérations gourmandes en ressources
Examen de la configuration
- Optimisez les paramètres liés à la mémoire
- Examinez les limites d'historique de conversation
- Vérifiez les restrictions de taille de téléchargement de fichiers
Nettoyage système
- Effacez les fichiers temporaires et caches
- Archivez les anciennes conversations
- Supprimez les outils et intégrations inutilisés

Résolution

Ajustez les paramètres d'allocation mémoire
Implémentez des processus de nettoyage automatique
Augmentez les ressources matérielles
Optimisez les opérations gourmandes en ressources

Problèmes de communication et de chat

Problèmes de livraison des messages

Symptômes

Messages ne s'envoyant pas
Historique de messages manquant
Problèmes de synchronisation

Étapes de dépannage

Vérification de la connexion
- Vérifiez la connectivité réseau
- Vérifiez la compatibilité du navigateur
- Testez avec différents appareils
Cache et stockage
- Effacez le cache et les cookies du navigateur
- Vérifiez la disponibilité du stockage local
- Vérifiez qu'aucun bloqueur de publicités n'interfère
Statut du compte
- Confirmez que le compte est actif
- Vérifiez le statut de l'abonnement
- Vérifiez qu'il n'y a pas de restrictions de compte

Résolution

Actualisez le navigateur et réessayez
Utilisez un navigateur ou appareil différent
Contactez le support pour les problèmes de compte
Mettez à jour le navigateur vers la dernière version

Échecs de téléchargement de fichiers

Symptômes

Fichiers ne se téléchargeant pas
Progression de téléchargement s'arrête
Erreurs de format de fichier

Étapes de dépannage

Validation de fichier
- Vérifiez les limites de taille de fichier
- Vérifiez les formats de fichiers pris en charge
- Assurez-vous que le fichier n'est pas corrompu
Paramètres du navigateur
- Activez JavaScript et les cookies
- Vérifiez les paramètres de sécurité du navigateur
- Désactivez les extensions qui pourraient interférer
Conditions réseau
- Testez avec des fichiers plus petits
- Vérifiez la bande passante de téléchargement
- Vérifiez une connexion internet stable

Résolution

Réduisez la taille du fichier ou divisez les gros fichiers
Essayez différents formats de fichiers
Utilisez des méthodes de téléchargement alternatives
Contactez le support pour les problèmes spécifiques aux formats

Problèmes de compte et d'accès

Problèmes de connexion

Symptômes

Impossible d'accéder au compte
Échecs d'authentification
Problèmes de réinitialisation de mot de passe

Étapes de dépannage

Vérification des credentials
- Revérifiez le nom d'utilisateur et le mot de passe
- Vérifiez que le verrouillage majuscules est désactivé
- Essayez le processus de réinitialisation de mot de passe
Statut du compte
- Vérifiez si le compte est suspendu
- Vérifiez que l'abonnement est actif
- Confirmez qu'il n'y a pas de restrictions de sécurité
Problèmes de navigateur
- Effacez les cookies et le cache
- Désactivez les extensions du navigateur
- Essayez le mode incognito/privé

Résolution

Réinitialisez le mot de passe en utilisant le processus officiel
Contactez le support pour la vérification du compte
Mettez à jour le navigateur ou essayez-en un différent
Vérifiez l'e-mail pour les notifications de compte

Erreurs de permission et d'accès

Symptômes

Messages "Accès refusé"
Fonctionnalités ou outils manquants
Fonctionnalité restreinte

Étapes de dépannage

Vérification du rôle
- Vérifiez le rôle utilisateur assigné
- Vérifiez l'appartenance à l'organisation
- Confirmez la disponibilité des fonctionnalités dans le plan
Paramètres de permissions
- Examinez les permissions individuelles
- Vérifiez les affectations de groupe ou d'équipe
- Vérifiez que l'admin a accordé l'accès
Limitations du plan
- Vérifiez les fonctionnalités du plan d'abonnement
- Vérifiez que les limites d'utilisation ne sont pas dépassées
- Confirmez que le statut de facturation est à jour