Gestion des erreurs et récupération

Comprendre comment interpréter, répondre et signaler les erreurs vous aide à maintenir des sessions de développement productives avec Verdent for VS Code.

Ce que vous allez apprendre

Les types d'erreurs courants et leurs causes
Comment interpréter efficacement les messages d'erreur
Les étapes systématiques de résolution des problèmes
Quand attendre et quand agir
Comment signaler des problèmes à l'équipe Verdent

Une documentation complète sur les erreurs est en cours d'élaboration. Les informations ci-dessous couvrent les catégories d'erreurs les plus fréquemment rencontrées. Pour des scénarios d'erreur spécifiques, contactez support@verdent.ai ou visitez la communauté Discord.

Erreurs de serveur surchargé

Se produit pendant les périodes de trafic élevé
Contraintes de capacité temporaires
Action : attendez 5 à 10 minutes puis réessayez

Erreurs internes du serveur

Problèmes de traitement backend
Perturbations temporaires du service
Action : attendez puis réessayez, cela se résout généralement automatiquement

503 Service indisponible

Aucun serveur en amont opérationnel
Problèmes d'infrastructure temporaires
Action : attendez le rétablissement du service

Erreurs de limitation de débit

Quotas de requêtes dépassés
Protections de limitation de API
Action : attendez la réinitialisation de la limite de débit, réduisez la fréquence des requêtes

Identifiants invalides ou expirés
Problèmes d'expiration de session
Action : réauthentifiez-vous via le centre utilisateur, vérifiez que l'abonnement est actif

Problèmes de connectivité réseau
Pare-feu ou VPN bloquant les connexions
Restrictions du réseau d'entreprise
Action : vérifiez la connexion réseau, essayez un autre réseau

Paramètres ou préférences invalides
Fichiers de configuration corrompus
Action : passez en revue les modifications récentes des paramètres, vérifiez la configuration

Permissions du système de fichiers insuffisantes
Restrictions d'accès à l'espace de travail
Action : vérifiez les permissions des fichiers/dossiers, vérifiez l'accès à l'espace de travail

Interpréter les messages d'erreur

Un guide détaillé d'interprétation des messages d'erreur est en cours de développement. Pour les messages d'erreur spécifiques que vous rencontrez, utilisez le bouton Feedback ou la communauté Discord pour obtenir de l'aide.

Les erreurs côté serveur sont temporaires et se résolvent généralement en attendant. Aucune action n'est requise en dehors de réessayer après quelques minutes.

Recherchez ces mots-clés :

« Overloaded » ou « at capacity »
« Internal server error » ou « backend processing »
« 503 Service Unavailable » ou « no healthy upstream »
« Rate limit » ou « quota »

Que faire :

Attendez 5 à 10 minutes avant de réessayer
Continuez le travail de développement local
Passez en revue les modifications de code effectuées jusqu'à présent
Validez le travail en cours dans Git

Règle générale : si le message d'erreur mentionne l'état du serveur, la capacité ou les limites de débit, il s'agit d'un problème temporaire. Ce sont des problèmes d'infrastructure qui se résolvent automatiquement.

Les erreurs serveur temporaires (502, 503, 504) se résolvent généralement en quelques minutes. Attendez 2 à 3 minutes avant de réessayer.

Quand escalader :

L'erreur persiste au-delà de 15 minutes
Consultez Discord pour des signalements de panne
Recherchez les mises à jour sur la page de statut

Les erreurs côté client nécessitent une action de votre part. Elles ne se résoudront pas en attendant.

Recherchez ces indicateurs :

Messages liés à l'authentification ou aux identifiants
Erreurs de configuration ou de paramètres
Erreurs de permission de fichier
Échecs de connexion réseau

Que faire :

Erreurs d'authentification : réauthentifiez-vous via le centre utilisateur, vérifiez que l'abonnement est actif
Erreurs de configuration : passez en revue les modifications récentes des paramètres, vérifiez les fichiers de configuration
Erreurs de permission : vérifiez les permissions des fichiers/dossiers, vérifiez l'accès à l'espace de travail
Erreurs réseau : testez la connexion internet, essayez un autre réseau, vérifiez le VPN/pare-feu

Règle générale : si l'erreur mentionne l'authentification, la configuration, les permissions ou les paramètres locaux, vous devez prendre une mesure corrective.

Étapes de résolution :

Lisez l'intégralité du message d'erreur pour obtenir des indications précises
Identifiez quel composant a signalé l'erreur (authentification, configuration, permissions, réseau)
Prenez une action ciblée en fonction du type d'erreur
Vérifiez la correction en réessayant l'opération d'origine

Lire le contexte de l'erreur

Lorsque des erreurs se produisent :

Lisez l'intégralité du message d'erreur - ne négligez pas les détails
Notez les codes d'erreur - des codes spécifiques aident à diagnostiquer les problèmes
Identifiez le composant - quel système a signalé l'erreur (serveur, API, local)
Vérifiez le moment - l'erreur s'est-elle produite immédiatement ou après un délai ?

Résolution systématique des problèmes

Suivez ces étapes progressives lorsque Verdent se comporte de manière inattendue, en commençant par les actions les moins perturbatrices.

Réponse initiale

Attendre et observer

Vérifiez si le comportement est constant ou intermittent. Notez quelle action a déclenché le comportement inattendu. Ne supposez pas immédiatement qu'il y a un problème : de nombreux incidents sont temporaires.

Redémarrage de base

Redémarrez Verdent for VS Code (fermez et rouvrez VS Code). Cela résout souvent les états bloqués ou les problèmes de performance. C'est la première étape de résolution la plus simple.

Résolution progressive

Si le redémarrage de base ne résout pas le problème :

Suivez les étapes systématiques de résolution des problèmes dans l'ordre ; sauter des étapes signifie souvent passer à côté de la cause racine.

Vérifier la connexion réseau

Testez la connexion internet avec d'autres sites web. Essayez sur un autre réseau (partage de connexion mobile) pour écarter les problèmes de pare-feu/VPN. Vérifiez si le réseau d'entreprise bloque les connexions.

Vérifier la configuration

Vérifiez que vous êtes toujours authentifié. Vérifiez que l'abonnement est actif dans le centre utilisateur. Passez en revue les modifications récentes des paramètres susceptibles d'affecter le comportement.

Demander de l'aide

Consultez la communauté Discord pour des signalements similaires : https://discord.com/invite/NGjXEZcbJq. Utilisez le bouton Feedback pour signaler le problème. Incluez une description du comportement inattendu et les étapes pour le reproduire.

Ce qu'il ne faut PAS faire

Évitez ces actions pour des problèmes temporaires :

Ne réinstallez pas immédiatement Verdent
Ne videz pas le cache de VS Code ou les données de l'application
Ne modifiez pas les paramètres système pour des problèmes temporaires
Ne redémarrez pas l'ordinateur sauf si d'autres applications sont également affectées

Dans Manual Accept Mode, n'approuvez jamais des opérations destructives (rm, DROP, DELETE) sans avoir soigneusement vérifié la commande exacte.

Pourquoi ? Ces actions prennent du temps et résolvent rarement les problèmes. La plupart des problèmes se résolvent par un simple redémarrage ou en attendant que les problèmes serveur temporaires se dissipent.

Quand attendre et quand agir

Comprendre s'il faut attendre ou agir permet d'éviter un effort de résolution des problèmes inutile.

Ces erreurs se résolvent automatiquement - aucune action n'est nécessaire en dehors de l'attente et d'une nouvelle tentative.

Erreurs de surcharge ou de capacité du serveur :

Messages « Overloaded » ou « at capacity »
Périodes de trafic élevé
Perturbations temporaires du service

Limitation de débit :

Messages « Rate limit » ou « quota exceeded »
Trop de requêtes en peu de temps
Protection de limitation de API

Problèmes de connexion intermittents :

Requêtes ayant occasionnellement échoué mais réussissant lors d'une nouvelle tentative
Anomalies réseau ponctuelles
Brèves coupures de connectivité

Que faire en attendant :

Continuez le travail de développement local
Passez en revue les modifications de code effectuées jusqu'à présent
Planifiez les prochaines étapes ou tâches
Validez le travail en cours dans Git

Durée d'attente recommandée :

Attente standard : 5 à 10 minutes
Si l'échec persiste après 10 minutes, passez à la résolution de problèmes
Consultez Discord pour des signalements de problèmes généralisés

Ces erreurs ne se résoudront pas en attendant - vous devez prendre une mesure corrective.

Échecs d'authentification :

Session expirée → réauthentifiez-vous via le centre utilisateur
Identifiants invalides → vérifiez que l'abonnement est actif
Nécessité de se réauthentifier → vérifiez le centre utilisateur

Erreurs persistantes (10 minutes ou plus) :

Même erreur répétée après plusieurs tentatives → commencez la résolution de problèmes
Schéma d'échec constant → vérifiez la configuration
L'erreur persiste après des redémarrages → vérifiez l'environnement

Problèmes de configuration :

Paramètres modifiés récemment → passez en revue et annulez les modifications
Nouvelle installation ou configuration → vérifiez les fichiers de configuration
Environnement réseau modifié → testez la connectivité

Erreurs de permission :

Accès au système de fichiers refusé → vérifiez les permissions des fichiers/dossiers
Restrictions de l'espace de travail → vérifiez l'accès à l'espace de travail
Permissions de dossier → accordez les permissions nécessaires

Problèmes réseau :

Impossibilité totale de se connecter → testez la connexion internet
VPN ou pare-feu bloquant → essayez un autre réseau
Restrictions du réseau d'entreprise → contactez le support informatique

Règle de décision :

Erreurs serveur/débit → attendez
Authentification/configuration/permission/réseau → agissez immédiatement
Pas sûr ? → attendez d'abord 5 à 10 minutes, puis agissez si le problème persiste

Fournir le contexte de l'erreur

Lorsque vous demandez de l'aide ou signalez des problèmes, incluez un contexte complet pour un diagnostic plus rapide.

Informations essentielles

Détails de l'erreur :

Texte exact du message d'erreur (copier-coller, ne pas paraphraser)
Code d'erreur, si fourni
Horodatage de l'apparition de l'erreur
Fréquence (ponctuelle, intermittente, constante)

Environnement :

Version de Verdent for VS Code
Version de VS Code
Système d'exploitation et version
Environnement réseau (domicile, entreprise, VPN)

Étapes de reproduction :

Ce que vous essayiez de faire
Prompts ou commandes exacts utilisés
Fichiers ou contexte concernés
Actions effectuées avant l'erreur

Contexte :

Le mode d'exécution que vous utilisiez
Taille et complexité de l'espace de travail
Modifications de configuration récentes
Opérations similaires ayant précédemment réussi

Exemple de rapport d'erreur

Format efficace d'un rapport d'erreur :

Issue: Getting "Internal server error" when requesting code analysis

Error Message (exact):
"Error: Internal server error occurred during processing. Please try again later."

Environment:
- Verdent for VS Code v1.2.3
- VS Code 1.85.0
- macOS 14.2
- Home network (no VPN)

Steps to Reproduce:
1. Opened large TypeScript project (500+ files)
2. Used Auto-Run Mode
3. Requested: "Analyze authentication flow in auth.ts and suggest improvements"
4. Error occurred immediately after request

Additional Context:
- First time working with this project
- Same request worked fine yesterday in different project
- Other requests (small file edits) work normally

Ce qui rend ce rapport efficace

Texte exact du message d'erreur
Détails complets sur l'environnement
Étapes de reproduction claires
Comparaison avec des scénarios fonctionnels
Contexte supplémentaire sur les schémas observés

Signaler des problèmes

Emplacement : barre supérieure du panneau Verdent

Ce qu'il fait :

Ouvre une fenêtre superposée pour soumettre des problèmes et des suggestions
Canal direct vers l'équipe Verdent
Idéal pour les rapports de bugs et les demandes de fonctionnalités

Quand l'utiliser :

Bugs confirmés avec des étapes de reproduction claires
Demandes de fonctionnalités avec des cas d'usage spécifiques
Besoin d'une communication directe avec l'équipe
Problèmes non urgents nécessitant une investigation

Ce qu'il faut inclure :

Description claire du problème
Messages d'erreur (texte exact)
Étapes de reproduction
Comportement attendu par rapport au comportement réel
Version de Verdent et plateforme
Moment où le problème a commencé

Lien : https://discord.com/invite/NGjXEZcbJq

Ce qu'elle apporte :

Une communauté active d'utilisateurs et de membres de l'équipe Verdent
Une assistance de résolution de problèmes en temps réel
La possibilité de partager des problèmes avec des captures d'écran
De l'aide d'utilisateurs expérimentés
Des discussions communautaires et des solutions de contournement

Quand l'utiliser :

Problèmes urgents nécessitant une discussion immédiate
Résolution de problèmes complexes nécessitant des échanges
Avis de la communauté sur les meilleures pratiques
Questions rapides avant de déposer un rapport formel
Partage de solutions de contournement avec la communauté

Type de problème	Utiliser le bouton Feedback	Utiliser Discord
Bug confirmé avec étapes de reproduction	✓
Demande de fonctionnalité	✓
Résolution urgente nécessaire		✓
Problème complexe nécessitant une discussion		✓
Question rapide		✓
Souhait d'avis de la communauté		✓
Rapport de bug formel	✓
Aide générale		✓

Ce qu'il NE FAUT PAS signaler :

Erreurs serveur temporaires (moins de 10 minutes)
Périodes de trafic élevé
Problèmes déjà documentés
Comportement attendu

À la place : attendez que les problèmes temporaires se résolvent, consultez Discord pour des signalements récents, consultez la documentation.

Bonnes pratiques de prévention

Des pratiques proactives réduisent la fréquence des erreurs et améliorent la récupération lorsqu'elles se produisent.

Utilisez un langage précis dans vos prompts et incluez le contexte de fichier pertinent pour prévenir de nombreuses erreurs courantes avant qu'elles ne surviennent.

Avant de commencer le travail

1. Vérifier la configuration

Vérifiez le statut d'authentification dans le centre utilisateur
Confirmez que l'abonnement est actif
Assurez-vous d'avoir une connexion réseau stable
Passez en revue les modifications de configuration récentes

2. Initialiser Git

Ayez toujours un contrôle de version avant d'utiliser des modes permissifs
Validez le travail en cours pour obtenir un point de départ propre
Fournit une option de retour en arrière en cas de problème

3. Vérifier le solde de crédits

Vérifiez que vous disposez de crédits suffisants pour le travail prévu
Rechargez si nécessaire avant de commencer des tâches complexes
Évitez les interruptions en cours de tâche dues à l'épuisement des crédits

Pendant le développement

1. Utiliser les modes d'exécution appropriés

Acceptation manuelle pour du code peu familier
Plan Mode pour des modifications complexes
Exécution automatique uniquement avec le filet de sécurité Git
Adaptez le mode au niveau de risque

2. Surveiller la performance

Surveillez toute dégradation de la qualité des réponses
Notez les temps de réponse plus lents
Démarrez de nouvelles sessions lorsque la performance décline
Suivez manuellement l'utilisation du contexte

3. Prompts clairs et précis

Réduisent les erreurs liées à des demandes mal comprises
Incluez le contexte et les contraintes pertinents
Référencez les schémas existants
Précisez clairement la portée

Après des erreurs

1. Tirer des enseignements des schémas observés

Notez ce qui a déclenché les erreurs
Identifiez les conditions reproductibles
Ajustez votre flux de travail pour éviter les déclencheurs
Partagez vos constats avec la communauté

2. Documenter les solutions de contournement

Conservez des notes sur les solutions efficaces
Partagez-les avec les membres de l'équipe
Contribuez à la connaissance de la communauté
Signalez à l'équipe Verdent pour des corrections

3. Mettre à jour la configuration

Ajustez les paramètres en fonction de l'expérience
Optimisez pour votre flux de travail
Configurez des règles pour prévenir les problèmes
Maintenez la documentation AGENTS.md