6. Dépannage et support - Logicc Centre d'aide

16. Gestion des erreurs et dépannage

Erreur ou symptôme	Cause probable	Action recommandée
401 avec LiteLLM_VerificationTokenTable ou token_not_found_in_db	Une nouvelle clé Logicc est envoyée vers l'ancien endpoint LiteLLM.	Utilisez https://api.logicc.cloud/v1 et supprimez l'ancienne URL de base api.logicc.io.
401 Authorization failed ou virtual_key_not_found	La clé est absente, non valide, révoquée ou envoyée dans le mauvais en-tête.	Vérifiez la clé complète et l'en-tête Authorization. Demandez une nouvelle clé si celle-ci fonctionnait auparavant.
GET /v1/models fonctionne, mais un modèle requis est absent	La clé est valide, mais le modèle ou la route du fournisseur n'est pas activé pour cette clé.	Envoyez les identifiants des modèles requis au support Logicc. L'endpoint Models fait foi pour chaque clé.
429 ou RESOURCE_EXHAUSTED	Un quota de requêtes, de tokens, de fournisseur ou de compte a été atteint.	Réduisez la concurrence, réessayez avec un backoff exponentiel et consultez l'endpoint de quota avant de contacter le support.
messages.*.tool_use.input must be a valid dictionary	Un appel d'outil contient une chaîne, une liste ou un JSON incorrect au lieu d'un objet.	Vérifiez que chaque entrée d'outil est un objet JSON valide, y compris les entrées vides représentées par {}.
Function tools with reasoning_effort are not supported	Le modèle sélectionné ne prend pas en charge cette combinaison de paramètres avec Chat Completions.	Définissez reasoning_effort sur none pour cette requête ou utilisez un modèle et un endpoint compatibles.
Un client tiers échoue alors que cURL fonctionne	Le client peut remplacer l'URL de base, les en-têtes, l'identifiant du modèle ou le schéma de la requête.	Comparez la requête sortante avec l'exemple cURL et vérifiez que les endpoints personnalisés compatibles OpenAI sont pris en charge.

Pour les charges de production, configurez des délais d'expiration explicites pour la connexion et la réponse, ne réessayez que les erreurs temporaires, limitez le nombre de tentatives et préservez l'idempotence lorsqu'une requête répétée pourrait déclencher une action externe.

17. Liste de contrôle pour la production

Conservez la clé dans un gestionnaire de secrets ou une variable d'environnement protégée.

Vérifiez l'URL de base et les en-têtes d'authentification dans chaque environnement.

Identifiez les modèles activés via GET /v1/models pendant la configuration.

Définissez des délais d'expiration explicites et un nombre limité de nouvelles tentatives pour les réponses 429 et les erreurs 5xx temporaires.

Validez les entrées d'outils comme objets JSON avant l'envoi des requêtes.

Journalisez l'heure de la requête, l'endpoint, l'identifiant du modèle, le code de statut et l'identifiant de la requête sans enregistrer de secrets ni de contenu sensible.

Surveillez l'endpoint de quota et les limites de débit techniques.

Testez les fonctions propres aux modèles, telles que le streaming, les outils, les fichiers, les images et les sorties structurées, avant la mise en production.

Définissez un comportement de secours pour les modèles indisponibles et les interruptions des fournisseurs.

18. Support

Incluez les informations suivantes pour obtenir rapidement une assistance technique :

Entreprise et personne de contact

Environnement et version du client ou du SDK

URL de base et endpoint complet

Identifiant du modèle

Horodatage approximatif et fuseau horaire

Code de statut HTTP et corps complet de l'erreur

Requête minimale reproductible après suppression de tous les secrets

16. Gestion des erreurs et dépannage

Erreur ou symptôme	Cause probable	Action recommandée
401 avec LiteLLM_VerificationTokenTable ou token_not_found_in_db	Une nouvelle clé Logicc est envoyée vers l'ancien endpoint LiteLLM.	Utilisez https://api.logicc.cloud/v1 et supprimez l'ancienne URL de base api.logicc.io.
401 Authorization failed ou virtual_key_not_found	La clé est absente, non valide, révoquée ou envoyée dans le mauvais en-tête.	Vérifiez la clé complète et l'en-tête Authorization. Demandez une nouvelle clé si celle-ci fonctionnait auparavant.
GET /v1/models fonctionne, mais un modèle requis est absent	La clé est valide, mais le modèle ou la route du fournisseur n'est pas activé pour cette clé.	Envoyez les identifiants des modèles requis au support Logicc. L'endpoint Models fait foi pour chaque clé.
429 ou RESOURCE_EXHAUSTED	Un quota de requêtes, de tokens, de fournisseur ou de compte a été atteint.	Réduisez la concurrence, réessayez avec un backoff exponentiel et consultez l'endpoint de quota avant de contacter le support.
messages.*.tool_use.input must be a valid dictionary	Un appel d'outil contient une chaîne, une liste ou un JSON incorrect au lieu d'un objet.	Vérifiez que chaque entrée d'outil est un objet JSON valide, y compris les entrées vides représentées par {}.
Function tools with reasoning_effort are not supported	Le modèle sélectionné ne prend pas en charge cette combinaison de paramètres avec Chat Completions.	Définissez reasoning_effort sur none pour cette requête ou utilisez un modèle et un endpoint compatibles.
Un client tiers échoue alors que cURL fonctionne	Le client peut remplacer l'URL de base, les en-têtes, l'identifiant du modèle ou le schéma de la requête.	Comparez la requête sortante avec l'exemple cURL et vérifiez que les endpoints personnalisés compatibles OpenAI sont pris en charge.