Passer au contenu principal

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’erreurMessage type (Exemple)Signification & Action
TimeoutTimeout (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.
ConfigurationInvalid 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 / LimiteContextWindowExceededErrorLa 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 Request contient un lien cliquable vers l’objet MLRequest (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 message affiche 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.