Aller au contenu principal

Gestion des Erreurs

Chatbotaurus implemente une gestion des erreurs a plusieurs niveaux pour garantir la fiabilite du service.

Niveaux d'Erreurs

Transport MCP

Erreurs liees au protocole Streamable HTTP :

CodeDescriptionAction
-32700JSON invalideRetourner erreur parse
-32600Requete invalideRetourner erreur validation
-32601Methode inconnueRetourner erreur methode
-32602Parametres invalidesRetourner erreur params
-32603Erreur interneLog + retourner erreur generique

Connecteurs

Erreurs liees aux services externes :

  • Timeout : Retry avec backoff exponentiel (max 3 tentatives)
  • Authentification : Rafraichir les credentials depuis Vault
  • Service indisponible : Marquer le connecteur comme degrade

Inference IA

Erreurs liees aux modeles :

  • Hallucination detectee : Validation multi-couches (MultiLayerValidator)
  • Timeout modele : Fallback vers modele plus leger (nanbeige4.1:3b)
  • OOM : Reduire num_ctx, degradation gracieuse

Degradation Gracieuse

Chatbotaurus implemente 5 niveaux de degradation :

  1. FULL : Toutes les techniques actives (ToT, MCTS, CoV, Self-Consistency)
  2. NO_MCTS : Si latence > 10s
  3. NO_TOT : Si RAM > 22 Go
  4. NO_SELF_CONSISTENCY : Si CPU > 80%
  5. TEMPLATE_ONLY : Fallback ultime, reponses basees sur templates

Observabilite

Chaque erreur est tracee avec :

  • Timestamp
  • Niveau de severite (DEBUG, INFO, WARN, ERROR, CRITICAL)
  • Contexte (session MCP, connecteur, outil)
  • Metriques de performance (resolveMs, credentialsMs, executeMs)
  • Stack trace (en mode developpement uniquement)

Les metriques sont collectees par VictoriaMetrics et les logs par VictoriaLogs.