> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lighton.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Diagnostics d'Erreurs

> La section Logs > Error responses est un outil de diagnostic technique. Elle répertorie toutes les interactions échouées entre la plateforme Paradigm et les modèles de langage (LLM) sous-jacents.
Cette page est essentielle pour comprendre pourquoi une demande utilisateur a échoué (réponse vide, erreur rouge dans le chat) et pour identifier des problèmes de configuration ou de performance.

### 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 `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.

***

<Info>
  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.
</Info>