Dépannage

« Service is experiencing high traffic. Please try again later! »

C'est l'erreur la plus fréquemment rencontrée par les utilisateurs. Elle indique que le service Verdent est temporairement surchargé.

Quand cela se produit :

• Pendant les périodes de forte utilisation
• Lorsque les services backend sont fortement sollicités
• Dégradation temporaire du service

Étapes de récupération (dans l'ordre) :

Problèmes d'installation et de configuration

Prérequis système :

• Version de VS Code : 1.90.0 ou ultérieure (requise)
• Connexion Internet : connexion active requise
• Abonnement : abonnement Verdent actif

Liste de vérification de diagnostic de base :

1. Vérifiez la version de VS Code : Aide → À propos (doit être 1.90.0 ou supérieure)
2. Vérifiez la connexion Internet : Verdent nécessite une connexion active
3. Vérifiez l'abonnement : assurez-vous que l'abonnement Verdent est actif
4. Redémarrez VS Code : après une installation ou des modifications de configuration
5. Vérifiez le statut de l'extension : Affichage → Extensions → Verdent (doit afficher « Activé »)

Procédure de réinstallation complète :

Vérifier les journaux :

• Ouvrez le panneau de sortie : Affichage → Sortie
• Sélectionnez « Verdent » dans le menu déroulant
• Recherchez les messages d'erreur ou les traces de pile

Impossible de se connecter à Verdent for VS Code

Cause la plus courante : problème de configuration de proxy

Solution :

Crédits d'essai gratuit non reçus

Erreur : les crédits d'essai gratuit n'ont pas été reçus ou l'accès à l'essai gratuit a été refusé

Raison : violation des conditions d'utilisation détectée lors de l'inscription

Résolution : contactez support@verdent.ai pour obtenir de l'aide concernant votre accès à l'essai gratuit. L'équipe du support examinera votre compte et vous aidera à résoudre le problème.

Échec de l'inscription

Erreur : l'inscription du compte a été rejetée ou restreinte

Raison : l'inscription a enfreint les conditions d'utilisation de Verdent, entraînant une restriction d'accès

Résolution : contactez support@verdent.ai pour obtenir de l'aide. L'équipe du support peut examiner votre inscription et vous fournir des conseils pour résoudre le problème.

Modèles manquants (Claude, GPT, Gemini)

Problème : impossible de trouver les modèles Claude, GPT ou Gemini dans la sélection de modèles

Raison : restrictions géographiques imposées par les fournisseurs de modèles

Explication : certains fournisseurs de modèles d'IA appliquent des restrictions régionales qui empêchent certains modèles d'être disponibles dans des zones géographiques spécifiques. Lorsque cela se produit :

• Les modèles restreints n'apparaissent pas dans votre menu de sélection de modèles
• Vous pouvez toujours utiliser tous les autres modèles disponibles sans interruption
• Aucun impact sur votre abonnement ou vos crédits

Vérifier les modèles disponibles : consultez https://www.verdent.ai/regions pour voir quels modèles sont disponibles dans votre région

Problèmes de performance

Symptômes :

• Temps de réponse lents
• Erreurs de fenêtre de contexte pleine
• Délais d'expiration d'exécution des outils

Causes courantes et solutions :

Messages d'erreur liés aux images

Référence rapide des erreurs courantes de traitement d'image :

Échecs de file_edit

Erreur : « Failed to find exact match »

Causes :

• Le texte a changé depuis le dernier file_read
• Différences d'espacement (tabulations ou espaces)
• Chaîne non unique dans le fichier

Solutions :

# 1. Read file again to get current state
file_read("file.js")

# 2. Use larger context string for uniqueness
file_edit("file.js",
  old_string="function foo() {\n  return 42;\n}",
  new_string="...")

# 3. For multiple identical strings, use replace_all
file_edit("file.js", old_string="TODO", new_string="DONE", replace_all=true)

Échecs des commandes bash

Erreur : délai d'expiration ou échec d'exécution de la commande

Délai d'expiration maximal : 120 secondes (2 minutes, limite stricte)

Solution : divisez les commandes longues en opérations plus petites :

# Instead of one long command, break into steps
bash("step1")  # Completes in < 2min
bash("step2")  # Completes in < 2min

Commande introuvable :

• Vérifiez si la commande existe : bash("which command-name")
• Assurez-vous d'avoir le bon chemin ou activez d'abord l'environnement
• Utilisez des chemins complets pour les exécutables

Erreurs de permission :

• Les commandes s'exécutent avec les permissions de l'utilisateur
• N'utilisez sudo que si nécessaire et dans Manual Accept Mode
• Vérifiez les permissions des fichiers/répertoires

La recherche ne renvoie aucun résultat

Problème : grep_file ou glob ne trouve pas les fichiers attendus

Vérifiez la syntaxe du motif :

# Wrong
grep_file("*.ts")  # Missing ** for recursive

# Correct
grep_file("**/*.ts")  # Recursive search

Vérifiez les exclusions :

# Ensure not accidentally excluding target files
glob("**/*.js", exclude=["**/dist/**", "**/node_modules/**"])

Sensibilité à la casse :

# Use case-insensitive search if needed
grep_content("pattern", case_insensitive=true)

Le sous-agent ne s'active pas

Problème : un sous-agent personnalisé ne s'active pas automatiquement

Liste de vérification :

• Emplacement du fichier : ~/.verdent/subagents/[name].md
• Frontmatter YAML valide avec name et description
• La politique d'invocation correspond à l'usage (le mode strict nécessite une mention @)
• Les recommandations « Quand l'utiliser » correspondent au modèle de la demande
• Aucune erreur de syntaxe dans le fichier markdown

Tester manuellement :

@subagent-name perform task

Comportement des sous-agents intégrés

Problème : @Explorer, @Verifier ou @Code-reviewer ne se comporte pas comme prévu

Causes courantes :

• La demande ne correspond pas à la spécialisation du sous-agent
• Contexte du sous-agent plein (rare)
• Le contexte de la conversation principale affecte le routage

Solution :

• Utilisez une mention @ explicite pour forcer un sous-agent spécifique
• Reformulez la demande pour correspondre à l'expertise du sous-agent
• Démarrez une nouvelle conversation si le contexte pose problème

AGENTS.md non appliqué

Problème : les règles du projet n'affectent pas le comportement de Verdent

Diagnostic :

1. Emplacement : le fichier doit se trouver à la racine du répertoire du projet
2. Syntaxe : Markdown valide (vérifiez les erreurs de syntaxe)
3. Spécificité : les règles doivent être directives : « Utilisez toujours X » et non « Essayez d'utiliser X »
4. Test : démarrez une nouvelle conversation pour tester l'application effective

Vérification de la priorité :

# In AGENTS.md (highest priority)
- Use 4-space indentation

# In VERDENT.md (lower priority)
- Use 2-space indentation

# Result: 4-space indentation (AGENTS.md wins)

Échecs de connexion MCP

Erreur : impossible de se connecter au serveur MCP

Étapes de diagnostic :

1. Vérifiez mcp.json : syntaxe JSON valide dans ~/.verdent/mcp.json
2. Serveur en cours d'exécution : assurez-vous que le processus du serveur MCP est actif
3. Réseau : vérifiez la connectivité vers le point de terminaison du serveur
4. Authentification : confirmez que les identifiants sont corrects
5. Journaux : consultez les journaux du serveur MCP pour connaître les détails de l'erreur

Solutions courantes :

• Redémarrez le serveur MCP
• Vérifiez le format de la chaîne de connexion
• Vérifiez que les règles de pare-feu autorisent le trafic MCP
• Validez les clés ou jetons API

Limitations des fichiers binaires

Problème : impossible de modifier des images, des PDF, des binaires compilés

Solution de contournement :

# Use bash to call external tools
bash("convert input.png -resize 50% output.png")
bash("pdftotext document.pdf output.txt")

Gestion des fichiers volumineux

Problème : les fichiers de plus de 10 000 lignes provoquent des problèmes de contexte

Solution de contournement :

# Always use line ranges for large files
file_read("large.log", start_line=1000, max_lines=100)

# Search first to find relevant sections
grep_content("ERROR", glob="large.log")

Différences de commandes entre plateformes

Problème : les commandes bash diffèrent entre Windows et Unix

Solution de contournement :

# Use cross-platform tools when possible
bash("npm run build")  # Works everywhere

# Or conditional execution
bash("if [[ \"$OSTYPE\" == \"linux-gnu\"* ]]; then ...; fi")

Bonne pratique : utilisez des scripts npm pour assurer la compatibilité multiplateforme.