Guide de Débogage 🔍

Si vous rencontrez des problèmes lors de l'intégration ou de l'utilisation de LLM Bastion, ce guide vous aidera à identifier et résoudre les erreurs les plus courantes.

1. Comprendre les erreurs HTTP

Bastion utilise des codes d'erreur standards pour vous informer des problèmes rencontrés.

• 401 Unauthorized : Votre clé virtuelle est invalide ou a expiré. Vérifiez votre header Authorization.
• 403 Forbidden : Votre clé n'a pas les droits nécessaires pour accéder à ce modèle ou à ce projet.
• 422 Unprocessable Entity : La requête a été bloquée par nos Security Guardrails (ex: détection d'injection ou PII). Consultez le corps de la réponse pour le détail du blocage.
• 429 Too Many Requests : Vous avez atteint votre quota de tokens ou votre limite de requêtes par minute (RPM).
• 503 Service Unavailable : Aucun fournisseur n'a pu répondre à votre requête après toutes nos tentatives de basculement.

Consultez le Catalogue d'Erreurs pour plus de détails.

2. Utiliser le Gateway Pulse

Le Gateway Pulse est votre meilleur allié pour le débogage en temps réel. Il vous permet de :

• Voir les requêtes entrantes et sortantes à la milliseconde près.
• Analyser les headers d'audit (X-Bastion-*).
• Visualiser les transformations de prompt effectuées par nos filtres.

3. Tester dans le Playground

Avant d'intégrer du code, utilisez le Playground pour valider que :

• Votre prompt ne déclenche pas accidentellement les filtres de sécurité.
• Le routage sélectionne bien le modèle attendu.
• La réponse obtenue correspond à vos besoins de qualité.

4. Headers d'Audit

Chaque réponse de Bastion inclut des headers utiles pour comprendre le trajet de votre requête :

• X-Bastion-Trace-Id : Identifiant unique de la requête (utile pour le support).
• X-Bastion-Cache : Indique si la réponse provient du cache (HIT, MISS).
• X-Bastion-Routing-Decision : Explique pourquoi ce modèle/fournisseur a été choisi.