# Gestion des erreurs et récupération (/fr/docs/verdent-for-vscode/error-handling/recovery)
> Interpréter les erreurs et s'en remettre
***
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 [#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
***
## Types d'erreurs courants [#types-derreurs-courants]
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](mailto: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 [#interpréter-les-messages-derreur]
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 :**
1. Lisez l'intégralité du message d'erreur pour obtenir des indications précises
2. Identifiez quel composant a signalé l'erreur (authentification, configuration, permissions, réseau)
3. Prenez une action ciblée en fonction du type d'erreur
4. Vérifiez la correction en réessayant l'opération d'origine
### Lire le contexte de l'erreur [#lire-le-contexte-de-lerreur]
Lorsque des erreurs se produisent :
1. **Lisez l'intégralité du message d'erreur** - ne négligez pas les détails
2. **Notez les codes d'erreur** - des codes spécifiques aident à diagnostiquer les problèmes
3. **Identifiez le composant** - quel système a signalé l'erreur (serveur, API, local)
4. **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 [#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 [#réponse-initiale]
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é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 [#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.
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é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.
Consultez la communauté Discord pour des signalements similaires : [https://discord.com/invite/NGjXEZcbJq](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 [#ce-quil-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 [#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 [#fournir-le-contexte-de-lerreur]
Lorsque vous demandez de l'aide ou signalez des problèmes, incluez un contexte complet pour un diagnostic plus rapide.
### Informations essentielles [#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 :**
1. Ce que vous essayiez de faire
2. Prompts ou commandes exacts utilisés
3. Fichiers ou contexte concernés
4. 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 [#exemple-de-rapport-derreur]
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 [#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 [#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](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 [#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 [#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 [#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 [#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
***
## Voir aussi [#voir-aussi]
Rédigez des prompts efficaces pour réduire les erreurs
Optimisez le contexte pour prévenir les problèmes de performance
Choisissez le mode approprié pour minimiser les risques