1. Vue d’ensemble (La Liste des Erreurs)
La page principale affiche l’historique chronologique des échecs techniques. Les colonnes clés pour le diagnostic :- Request ID : L’identifiant unique de la requête technique. Il permet de faire le lien avec l’action précise de l’utilisateur.
- Status Code : Le code HTTP indiquant la nature du problème :
400(Bad Request) : Indique généralement une erreur de configuration (ex: nom de modèle incorrect, contexte trop long).504(Gateway Timeout) : Indique que le modèle a mis trop de temps à répondre ou que le serveur est surchargé.
- Error Message : Un extrait du message technique renvoyé par le système. C’est ici que vous trouverez la cause racine (ex: “Invalid model name”, “Timeout”, “ContextWindowExceededError”).
2. Typologie des erreurs fréquentes
En analysant la liste, vous pouvez rapidement identifier des tendances :| Type d’erreur | Message type (Exemple) | Signification & Action |
|---|---|---|
| Timeout | Timeout (Status 504) | Le modèle est trop lent ou indisponible. Aucune action immédiate possible sauf vérifier l’état des serveurs d’inférence. |
| Configuration | Invalid model name passed... | La clé API ou la configuration du modèle dans l’admin pointe vers un modèle qui n’existe pas ou plus. Vérifiez vos paramètres de modèle. |
| Quota / Limite | ContextWindowExceededError | La conversation (prompts + documents) dépasse la capacité mémoire du modèle (ex: 32k tokens). L’utilisateur doit réduire la taille de ses documents ou commencer un nouveau chat. |
3. Analyse détaillée d’une erreur
En cliquant sur l’ID d’une ligne ou sur l’icône d’édition, vous accédez à la fiche complète de l’erreur. Cette vue permet d’approfondir l’investigation :- Lien vers la Requête : Le champ
Requestcontient un lien cliquable vers l’objetMLRequest(ex:MLRequest object (14425142)). Cela vous permet de remonter à la source pour voir exactement ce qui a été envoyé au modèle. - Message complet : Le champ
Error messageaffiche la totalité du log JSON. C’est utile lorsque le message est tronqué dans la vue liste.
4. Maintenance (Nettoyage)
Si vous souhaitez purger l’historique des erreurs (par exemple après avoir résolu un problème de configuration massif) :- Suppression unitaire : Dans la vue détaillée, cliquez sur le bouton rouge “Supprimer error response”.
- Suppression en masse : Dans la vue liste, cochez les cases à gauche des lignes concernées, puis utilisez le menu d’actions pour les supprimer.
Consultez cette page régulièrement. Une augmentation soudaine des erreurs
504 ou 400 est souvent le premier signe d’un problème d’infrastructure ou d’une mauvaise configuration qui impacte l’expérience de vos utilisateurs.