Foire aux questions
Questions courantes sur Verdent for VS Code
Réponses aux questions fréquemment posées sur les fonctionnalités, les capacités et l'utilisation de Verdent.
Prise en main
Terminez le guide de démarrage rapide avant de vous plonger dans les fonctionnalités avancées, il couvre les concepts essentiels qui reviennent tout au long de la documentation.
Problèmes courants (Top 4)
Pourquoi ne puis-je pas me connecter à Verdent for VS Code ?
Cause la plus fréquente : Problème de configuration du proxy
Solution :
- Ouvrez les paramètres de VS Code (
Cmd+,sur macOS ouCtrl+,sur Windows/Linux) - Recherchez « useProxy » ou « verdent.enableProxy »
- Activez/désactivez le paramètre de proxy (l'opposé de l'état actuel)
- Essayez de vous reconnecter
Explication : Si vous êtes derrière un pare-feu d'entreprise, vous devrez peut-être activer le paramètre de proxy. Si vous êtes sur un réseau domestique, essayez de le désactiver.
Pourquoi n'ai-je pas reçu mes crédits d'essai gratuit ?
Erreur : Les crédits d'essai gratuit n'ont pas été reçus ou l'accès à l'essai gratuit a été refusé
Raison : Une violation des conditions d'utilisation a été détectée lors de l'inscription
Solution : Contactez support@verdent.ai pour obtenir de l'aide concernant votre accès à l'essai gratuit. L'équipe d'assistance examinera votre compte et vous aidera à résoudre le problème.
Pourquoi mon inscription a-t-elle échoué ?
Erreur : L'inscription du compte a été rejetée ou restreinte
Raison : L'inscription enfreignait les conditions d'utilisation de Verdent, ce qui a entraîné une restriction d'accès
Solution : Contactez support@verdent.ai pour obtenir de l'aide. L'équipe d'assistance peut examiner votre inscription et vous fournir des conseils pour résoudre le problème.
Pourquoi ne puis-je pas trouver les modèles Claude, GPT ou Gemini ?
Problème : Impossible de trouver certains modèles d'IA dans le menu de sélection des modèles
Raison : Restrictions géographiques imposées par les fournisseurs de modèles
Explication : Certains fournisseurs de modèles d'IA (Anthropic, OpenAI, Google) appliquent des restrictions régionales qui empêchent certains modèles d'être disponibles dans des zones géographiques spécifiques. Dans ce cas :
- Les modèles restreints n'apparaîtront pas dans votre menu de sélection des 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
Remarque : Les restrictions régionales sont définies par les fournisseurs de modèles d'IA, et non par Verdent. Verdent ne peut pas outrepasser ces restrictions.
Qu'est-ce que Visual Studio Code ?
Visual Studio Code est un éditeur de code gratuit et open source développé par Microsoft. Il s'agit d'un environnement de développement léger mais puissant qui prend en charge plusieurs langages de programmation et propose des fonctionnalités telles que le débogage, la coloration syntaxique, la complétion de code intelligente et le contrôle de version intégré. Verdent s'intègre directement dans Visual Studio Code sous forme d'extension, ajoutant des capacités de codage assistées par IA à votre flux de travail existant.
Qu'est-ce que Verdent for VS Code ?
Verdent est une extension d'assistant de codage IA pour Visual Studio Code qui aide à la génération de code, au refactoring, au débogage et à la navigation dans les projets grâce à des conversations en langage naturel.
Capacités clés :
- Génération et modification de code via des outils de fichiers
- Exploration de la base de code avec des sous-agents spécialisés
- Exécution de commandes via une intégration bash
- Extensibilité personnalisée via des règles et des serveurs MCP
Quelle est la configuration système requise ?
Configuration minimale requise :
- Visual Studio Code 1.90.0 ou supérieur
- Abonnement Verdent actif
- Connexion Internet
Plateformes prises en charge : macOS, Windows, Linux, WSL
Comment commencer à utiliser Verdent après l'installation ?
- Installez l'extension Verdent depuis la marketplace VS Code
- Connectez-vous avec votre compte Verdent lorsque vous y êtes invité
- Ouvrez un fichier de code ou un projet
- Ouvrez la vue de chat et commencez à converser avec Verdent
Suggestion de première tâche : Demandez à Verdent d'expliquer la structure de votre projet ou de passer en revue un fichier spécifique.
Comment vérifier ma version de Visual Studio Code ?
Ouvrez Visual Studio Code et allez dans Aide → À propos (ou Code → À propos de Visual Studio Code sur macOS). Le numéro de version s'affiche dans la boîte de dialogue. Verdent nécessite Visual Studio Code version 1.90.0 ou supérieure.
Vous pouvez également vérifier via la ligne de commande :
code --versionQue sont les crédits ?
Consultez Crédits et offres pour la définition commune des crédits, des niveaux tarifaires et des bases d'utilisation à travers les produits Verdent.
Que se passe-t-il si je suis à court de crédits ?
Consultez Que se passe-t-il si vous êtes à court de crédits pour connaître la politique de compte commune et les options de récupération.
Est-ce que Verdent envoie mes images vers des serveurs externes ?
Les images collées via le presse-papiers ou référencées par chemin de fichier sont traitées au sein de votre session de conversation. Les images ne sont pas stockées de façon permanente et sont effacées lorsque vous démarrez une nouvelle conversation. Les références par chemin de fichier lisent l'image localement sans la téléverser.
Qu'est-ce que Plan Mode ?
Plan Mode est un mode d'exécution en lecture seule dans lequel Verdent analyse le code, effectue des recherches et crée des plans d'implémentation détaillés sans modifier de fichiers ni exécuter de commandes. Après avoir généré un plan, Verdent propose deux options : Modifier (pour demander des modifications et affiner le plan) ou Commencer la construction (pour passer en Agent Mode et commencer l'exécution). L'agent peut poser des questions de clarification pour lever les incertitudes avant l'exécution. Ce mode est idéal pour les tâches complexes où vous souhaitez examiner l'approche avant de vous engager dans des modifications, garantissant l'alignement entre vos attentes et la solution proposée par Verdent.
Est-ce que Plan Mode écrit réellement du code dans mes fichiers ?
Non. Plan Mode est strictement en lecture seule :
- Verdent peut lire des fichiers, rechercher dans le code et analyser votre base de code
- Aucune écriture, modification ou suppression de fichier ne se produit pendant Plan Mode
- Les plans sont affichés uniquement dans la vue de chat
- L'exécution du code ne commence qu'après votre approbation explicite et le passage en Agent Mode
Garantie de sécurité : Plan Mode ne peut pas modifier accidentellement votre code. Il est conçu pour une exploration sûre et l'élaboration de stratégies.
Comment basculer entre Plan Mode et Agent Mode ?
Le basculement est instantané via la zone de saisie :
Pour entrer en Plan Mode :
- Cliquez sur le bouton Changer de mode dans la zone de saisie
- Sélectionnez Plan Mode dans le menu déroulant
- OU dites : « Passer en Plan Mode »
Pour quitter Plan Mode :
- Cliquez sur le bouton Changer de mode dans la zone de saisie
- Sélectionnez Agent Mode dans le menu déroulant
- OU choisissez Commencer la construction après avoir examiné un plan
Persistance du mode :
- Le choix du mode persiste au sein de la session en cours
- Les nouvelles sessions démarrent dans le Agent Mode par défaut
- Vous pouvez changer de mode librement à tout moment
Flux de travail typique : Plan Mode → examen → Agent Mode → exécution → retour à Plan Mode pour la prochaine fonctionnalité complexe.
Comment démarrer une nouvelle conversation avec un contexte propre ?
Cliquez sur le bouton « Nouvelle session » dans la barre supérieure. Cela efface l'historique de conversation en cours et offre à Verdent une nouvelle fenêtre de contexte pour votre prochaine tâche.
Puis-je utiliser Verdent dans plusieurs projets simultanément ?
Oui, chaque fenêtre VS Code fonctionne indépendamment. Vous pouvez avoir Verdent ouvert dans plusieurs projets, chacun conservant son propre contexte de conversation distinct.
Est-ce que Verdent fonctionne avec GitHub, GitLab, Bitbucket et d'autres plateformes Git ?
Oui. Verdent utilise des commandes Git standard, il fonctionne donc avec n'importe quel dépôt Git quelle que soit la plateforme d'hébergement. Pour créer des pull requests, Verdent utilise la CLI gh qui nécessite GitHub, mais toutes les autres opérations Git fonctionnent universellement.
Outils et capacités
Avec quels formats de fichiers Verdent peut-il travailler ?
Pris en charge : Tous les formats de fichiers texte, notamment :
- Code source (JavaScript, Python, TypeScript, Java, Go, etc.)
- Fichiers de configuration (JSON, YAML, TOML, XML, ENV)
- Documentation (Markdown, HTML, LaTeX)
- Fichiers de build (package.json, Makefile, requirements.txt)
Non pris en charge : Fichiers binaires (images, vidéos, PDF, binaires compilés, documents Office)
Contournement : Référencez les fichiers binaires dans le code, mais les modifications nécessitent des outils externes.
Quels langages de programmation Verdent prend-il le mieux en charge ?
Excellente prise en charge :
- JavaScript, TypeScript, Python, React, Vue, Angular
- Node.js, Go, Java/Spring, C#/.NET
- Swift, Kotlin, Flutter
Très bonne prise en charge : Rust, C/C++, Ruby, R
Bonne prise en charge : PHP, Assembleur, Julia
Les langages courants bénéficient d'une prise en charge plus solide en raison de l'important volume de données d'entraînement.
Comment Verdent lit-il et modifie-t-il les fichiers ?
Trois outils d'opération sur les fichiers :
- file_read : Lire des fichiers complets ou des plages de lignes spécifiques
- file_edit : Remplacer des motifs de texte spécifiques (modifications ciblées)
- file_write : Créer de nouveaux fichiers ou réécrire complètement des fichiers
Bonne pratique : Utilisez file_edit pour les modifications, file_write uniquement pour les nouveaux fichiers.
Qu'est-ce que l'exécution de commandes ?
L'exécution de commandes de terminal ou de scripts shell via Verdent, y compris des opérations telles que l'exécution de tests, l'installation de paquets ou l'exécution de commandes de build. L'exécution de commandes nécessite une approbation dans la plupart des modes de permission afin d'éviter des modifications système non souhaitées.
Verdent peut-il exécuter des commandes dans mon terminal ?
Oui, à l'aide de l'outil bash. Verdent peut exécuter des commandes de terminal avec :
- Délai d'expiration maximal : 120 secondes (2 minutes)
- Enchaînement de commandes avec
&& - Prise en charge multiplateforme (bash sous Unix, PowerShell sous Windows)
Sécurité : Les commandes s'exécutent avec vos permissions utilisateur. Utilisez Manual Accept Mode pour les examiner avant exécution.
Combien de temps les commandes bash peuvent-elles s'exécuter ?
Délai d'expiration maximal : 120 secondes (2 minutes)
Les commandes dépassant 2 minutes seront automatiquement interrompues. Pour les opérations plus longues, envisagez :
Alternatives :
- Diviser en commandes plus petites :
bash("task1") && bash("task2") - Diviser en opérations plus petites
- Exécuter en arrière-plan et vérifier les résultats séparément
Qu'est-ce que le cycle multi-passes de génération, test et réparation ?
Un processus de vérification itératif dans lequel le code est généré, testé et réparé jusqu'à ce qu'il réussisse des tests complets. Verdent exécute automatiquement les tests, analyse les échecs, corrige les problèmes et effectue de nouveaux tests en plusieurs passes jusqu'à ce que le code fonctionne correctement. Cela permet de fournir du code prêt pour la production, et non de simples suggestions. Chaque résultat inclut des résumés détaillés et des diffs de code montrant exactement ce qui a changé.
Les cycles de test multi-passes corrigent et retestent automatiquement le code jusqu'à ce qu'il réussisse, c'est ainsi que Verdent garantit la préparation à la production.
Sous-agents et exécution
Que sont les sous-agents et quand dois-je les utiliser ?
Les sous-agents sont des agents IA spécialisés dotés de fenêtres de contexte isolées pour des tâches spécifiques.
Sous-agents intégrés :
- @Explorer : Recherches dans la base de code, questions d'architecture
- @Verifier : Vérifications de validation rapides
- @Code-reviewer : Revues de sécurité et de qualité
Quand les utiliser : Déléguez les tâches de recherche, de validation ou de revue pour économiser le contexte de la conversation principale.
Comment créer des sous-agents personnalisés :
Créez un fichier markdown dans ~/.verdent/subagents/ :
---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]Cas d'usage : Expertise spécifique à un domaine (finance, santé), flux de travail d'équipe, spécialistes technologiques.
Qu'est-ce que la pollution de contexte ?
Lorsque des actions et informations précédentes dans le contexte créent des schémas de comportement non intentionnels qui affectent les tâches futures. Par exemple, si vous mettez à jour du code de manière répétée puis le déployez, l'agent peut commencer à associer toutes les mises à jour de code à un déploiement immédiat, même lorsque vous ne faites qu'expérimenter. Les sous-agents évitent la pollution de contexte en fonctionnant avec des fenêtres de contexte isolées, permettant à chaque tâche spécialisée de démarrer avec un contexte propre et d'éviter la contamination croisée entre différents types de travail.
Comment savoir dans quel mode d'exécution je me trouve actuellement ?
Regardez la zone de saisie en bas du panneau Verdent. Le bouton « Changer de permission » affiche votre mode actuel (par exemple, « Manuel », « Auto », « Plan »). Vous pouvez cliquer dessus pour changer de mode.
Quelle est la différence entre Auto-Run Mode et Manual Accept Mode ?
Auto-Run Mode :
- Les opérations sur les fichiers s'exécutent automatiquement sans approbation
- Les commandes nécessitent toujours une permission
- Flux de travail plus rapide pour les bases de code de confiance
- Idéal pour les projets individuels avec contrôle de version
Manual Accept Mode :
- Examinez et approuvez chaque opération protégée
- Plus sûr pour les bases de code partagées ou de production
- Voyez exactement ce qui sera exécuté avant l'exécution
Changez de mode via les paramètres ou la palette de commandes.
Que sont les opérations sûres ?
Des opérations qui ne font que lire des données sans apporter de modifications : lectures de fichiers et recherches web. Celles-ci sont automatiquement approuvées en Auto-Run Mode, tandis que les modifications de fichiers et l'exécution de commandes nécessitent toujours une approbation pour des raisons de sécurité.
Puis-je utiliser plusieurs modes de permission en même temps ?
Non, les modes de permission s'excluent mutuellement - vous ne pouvez en utiliser qu'UN à la fois :
- Acceptation manuelle - Par défaut, contrôle maximal
- Exécution automatique - Simplifié pour les projets de confiance
- Plan - Mode de planification en lecture seule
- Ignorer les permissions - Autonomie complète
Vous pouvez changer de mode instantanément via le bouton Changer de permission dans la zone de saisie. La plupart des utilisateurs alternent entre les modes selon le contexte de la tâche (par exemple, Plan Mode pour les fonctionnalités complexes, Exécution automatique pour les corrections rapides).
Quand dois-je utiliser l'agent Explorer plutôt que de charger les fichiers directement ?
Utilisez l'agent Explorer pour les tâches de découverte et de recherche sans consommer le contexte principal. Chargez les fichiers directement avec des mentions @ uniquement lorsque vous devez les modifier. Explorer est idéal pour les questions du type « trouve tous les fichiers qui... », tandis que les mentions @ conviennent aux tâches du type « mets à jour ce fichier spécifique ».
Puis-je créer des sous-agents personnalisés pour mon projet ?
Oui ! Créez des sous-agents personnalisés dans ~/.verdent/subagents/ :
---
name: your-subagent
description: Purpose description
---
# System Prompt
[Behavior definition and expertise]Cas d'usage : Expertise spécifique à un domaine (finance, santé), flux de travail d'équipe, spécialistes technologiques.
Puis-je arrêter Verdent au milieu d'une tâche à plusieurs étapes ?
Oui. Vous pouvez interrompre l'exécution à tout moment. Verdent terminera l'étape en cours sur laquelle il travaille, puis s'arrêtera. La progression jusqu'à ce point est préservée. Vous pouvez examiner ce qui a été fait, apporter des ajustements et soit continuer, soit adopter une approche différente.
Comment savoir ce que fait Verdent en ce moment lors d'une tâche longue ?
Observez la liste de tâches. Elle affiche l'état en temps réel avec un élément marqué « en cours » à tout moment. L'élément actif montre exactement sur quoi Verdent travaille actuellement. Les éléments terminés sont marqués comme terminés, et les éléments en attente montrent ce qu'il reste à faire.
Est-ce que Verdent valide automatiquement mes modifications ?
Non. Verdent ne crée des commits que lorsque vous le demandez explicitement. Vous gardez un contrôle total sur le moment où les modifications sont validées. Demandez simplement « Stage toutes les modifications et crée un commit » lorsque vous êtes prêt.
Est-ce que Verdent va pousser vers des dépôts distants sans demander ?
Non. Verdent ne pousse vers des dépôts distants que lorsque vous le demandez explicitement. Toutes les opérations Git (commit, push, merge, rebase) nécessitent votre instruction explicite pour des raisons de sécurité.
Personnalisation et intégration
Comment personnaliser le comportement de Verdent pour mon équipe ?
Trois méthodes de personnalisation :
- VERDENT.md : Préférences globales personnelles (
~/.verdent/VERDENT.md) - AGENTS.md : Standards d'équipe spécifiques au projet (racine du projet, sous contrôle de version)
- plan_rules.md : Format de sortie de Plan Mode (
~/.verdent/plan_rules.md)
AGENTS.md prévaut sur VERDENT.md pour assurer la cohérence de l'équipe.
Quand les modifications de configuration prennent-elles effet ?
La plupart des paramètres de Verdent s'appliquent immédiatement sans nécessiter de redémarrage :
- Modes de permission : Basculement instantané via la zone de saisie
- Préréglages de modèle : S'appliquent à la prochaine requête
- Fichiers de règles : S'appliquent aux nouvelles conversations (l'enregistrement déclenche le rechargement)
- Sous-agents : Disponibles immédiatement après la création
- Raccourcis clavier : S'appliquent après l'enregistrement dans VS Code
Exception : Les paramètres de l'extension VS Code (comme verdent.enableCheckpoints) prennent effet immédiatement, mais peuvent nécessiter de rouvrir les fichiers ou les sessions pour une application complète.
Qu'est-ce que MCP et comment l'utiliser ?
Model Context Protocol (MCP) étend Verdent avec des outils et services externes :
Configuration : ~/.verdent/mcp.json via Paramètres → Serveurs MCP
Capacités :
- Connexions à des bases de données (PostgreSQL, MySQL, MongoDB)
- Services cloud (AWS, Azure, GCP)
- Outils de gestion de projet (Jira, Linear)
- Pipelines CI/CD (Jenkins, GitHub Actions)
Statut : Documentation d'intégration MCP en cours de développement. Contactez support@verdent.ai pour obtenir de l'aide à la configuration.
Bonnes pratiques et performance
Surveillez l'utilisation des crédits dans le centre utilisateur pour suivre les tendances de consommation et optimiser votre flux de travail en termes d'efficacité.
Qu'est-ce qu'un token ?
L'unité de mesure des fenêtres de contexte. Les tokens représentent des fragments de texte (mots, parties de mots ou caractères) que le modèle d'IA traite. Les limites de contexte sont mesurées en tokens plutôt qu'en caractères ou en mots, une conversation typique consommant des milliers de tokens.
Qu'est-ce qui compte dans ma fenêtre de contexte ?
Tout ce qui se trouve dans votre session : tous les messages de la conversation, le contenu des fichiers chargés dans le contexte, les sorties d'outils (résultats de grep/recherche, lectures de fichiers), les prompts système et les instructions, et les définitions de serveurs MCP. Chacun de ces éléments consomme des tokens de votre capacité de contexte totale.
Quelle est la différence entre les fenêtres de contexte de 200K et 1M ?
Les modèles standard (Claude 4.5 Sonnet, Haiku, GPT-5, GPT-5-Codex, MiniMax-M2) disposent d'une fenêtre de contexte de 200K tokens suffisante pour la plupart des tâches. Claude Sonnet 4.5 offre un contexte étendu de 1M tokens (5 fois plus grand) pour les grandes bases de code avec des fichiers 1000+, le refactoring complexe multi-fichiers ou les longues sessions de développement. Le contexte 1M s'active automatiquement lorsque l'entrée dépasse 200K tokens, ou peut être sélectionné explicitement.
Combien de fichiers puis-je charger en toute sécurité dans le contexte ?
Il n'y a pas de limite fixe de fichiers - cela dépend de la taille des fichiers et du nombre total de tokens. Pour les contextes de 200K, évitez de charger 20+ gros fichiers (>1000 lignes chacun). Concentrez-vous sur les fichiers directement pertinents pour votre tâche en cours. Utilisez @-mentions de manière sélective et exploitez la documentation AGENTS.md plutôt que de charger de nombreux fichiers d'exemple. Avec un contexte de 1M, le choix des fichiers devient beaucoup moins critique.
Comment savoir si j'approche des limites de contexte ?
Les signes incluent des temps de réponse plus lents, des sessions qui durent plusieurs heures, ou de nombreux gros fichiers chargés. Surveillez la durée de votre session et le nombre de fichiers. Lorsque vous remarquez une dégradation des performances, terminez votre tâche en cours, validez votre progression, puis démarrez une nouvelle session avec un contexte propre.
Comment éviter l'épuisement de la fenêtre de contexte ?
Stratégies :
- Lecture stratégique des fichiers : Utilisez des plages de lignes pour les gros fichiers
- Déléguer aux sous-agents : Explorer/Verifier pour la recherche en arrière-plan
- Rechercher avant de lire : Utilisez
grep_filepour identifier les fichiers pertinents - Fractionner les opérations : Utilisez
todo_updatepour suivre les tâches à plusieurs étapes
Règle empirique : Les fichiers de plus de 500 lignes devraient utiliser des plages de lignes.
Dois-je réinitialiser manuellement le contexte ou Verdent le fait-il automatiquement ?
Vous devez démarrer manuellement une nouvelle session pour réinitialiser le contexte - Verdent n'efface pas automatiquement le contexte. Bonne pratique : réinitialisez après avoir terminé une unité de travail atomique, effectué les tests et validé dans le contrôle de version. Pour les contextes de 1M tokens, les réinitialisations sont nécessaires beaucoup moins fréquemment.
La réinitialisation du contexte fera-t-elle perdre mon travail ?
Non - la réinitialisation du contexte efface uniquement l'historique de la conversation et les fichiers chargés en mémoire. Vos modifications de code réelles, vos commits et vos modifications de fichiers sont préservés. Validez toujours votre travail dans le contrôle de version avant de réinitialiser le contexte, par sécurité. Réinitialiser → démarrer une nouvelle session → continuer à travailler sur la tâche suivante.
À quel point mes prompts doivent-ils être précis ?
Soyez suffisamment précis pour éliminer toute ambiguïté, mais n'expliquez pas trop les détails évidents. Incluez : les chemins de fichiers exacts, l'approche d'implémentation, les résultats attendus et les contraintes. Mauvais exemple : « Corrige le code » - trop vague. Bon exemple : « Ajoute une validation de saisie au champ email dans ContactForm.js pour rejeter les formats d'email invalides » - portée et objectif clairs. Dans le doute, préférez être plus précis.
Quelle est la différence entre les mentions @ et le chargement automatique de fichiers ?
Verdent charge automatiquement les fichiers mentionnés par leur nom dans les prompts ainsi que les fichiers associés dans le même répertoire. Les @-mentions (@filename.js) garantissent explicitement qu'un fichier est présent dans le contexte, ce qui est essentiel lorsque vous travaillez avec des fichiers étroitement couplés, que vous référencez des motifs d'un fichier pour les appliquer à un autre, ou lorsque la détection automatique pourrait manquer du contexte dans de grandes bases de code. Utilisez toujours @-mentions lorsque vous demandez à Verdent de « suivre le même modèle que... » afin de garantir une référence de code exacte.
Dois-je répéter le contexte du projet dans chaque prompt au cours d'une session ?
Non - Verdent maintient le contexte de la conversation au sein d'une session, vous n'avez donc pas besoin de répéter les détails d'architecture ou les conventions déjà évoqués. Cependant, pour les contraintes critiques ou lorsque les sessions deviennent longues (100+ messages), reformulez le contexte important. Meilleure approche : utilisez des règles de projet (AGENTS.md) pour documenter le contexte persistant comme la stack technique, les standards de code et les modèles - vous n'aurez alors jamais besoin de les répéter.
Que faire si Verdent ne comprend pas ou ne suit pas correctement mon prompt ?
Utilisez un affinement itératif : examinez le résultat, identifiez ce qui ne va pas, puis apportez des corrections dans un prompt de suivi. Exemple : « La logique de validation est bonne, mais utilise la validation de schéma Joi au lieu de vérifications manuelles. Fais correspondre le modèle de validation dans ProductController.js. » Vous pouvez également demander des explications : « Pourquoi as-tu utilisé Redux au lieu de Context API ? » puis affiner en fonction de la compréhension. Ne répétez pas le même prompt - ajustez en fonction de ce qui a échoué.
Quand dois-je utiliser Plan Mode plutôt que le mode normal ?
Utilisez Plan Mode pour : les grands refactorings ou changements architecturaux, les modifications multi-fichiers où vous souhaitez examiner la portée avant l'exécution, les tâches complexes pour lesquelles vous êtes incertain des exigences, ou lorsque vous souhaitez que Verdent vous interroge avec des questions de clarification avant l'implémentation. Évitez Plan Mode pour : les tâches simples et bien définies, les corrections de bugs rapides ou les opérations routinières. Plan Mode ajoute une surcharge mais évite des erreurs coûteuses sur des travaux complexes.
Comment choisir le bon préréglage de modèle pour ma tâche ?
Adaptez le préréglage de modèle à la complexité de la tâche et au budget :
Utilisez Efficiency (3,2 fois plus efficace que Sonnet) :
- Corrections de bugs rapides et génération de code simple
- Opérations routinières et tâches à haute fréquence
- Lorsque la vitesse compte plus que la profondeur
Utilisez Balance (référence 1x) - Par défaut :
- Développement général et codage quotidien
- Implémentation de fonctionnalités et revues de code
- Performance équilibrée pour la plupart des scénarios
Utilisez Performance (efficacité 0,5x, coût 2x) :
- Décisions architecturales complexes
- Grandes bases de code nécessitant un contexte étendu (200k+ tokens)
- Débogage et refactoring sophistiqués
Conseil de pro : La plupart des utilisateurs gardent Balance par défaut et ne passent à Performance que lorsqu'ils atteignent les limites de contexte ou ont besoin d'un raisonnement approfondi.
Dépannage
Comment résoudre les problèmes de pare-feu ou de connexion ?
Si Verdent ne parvient pas à se connecter aux services d'IA, vérifiez ces problèmes courants :
Testez la connectivité de base :
- Vérifiez que vous disposez d'un accès Internet actif
- Essayez d'accéder à d'autres services HTTPS pour confirmer que les connexions sortantes fonctionnent
Environnements d'entreprise :
- Contactez votre administrateur réseau pour mettre en liste blanche les points de terminaison API de Verdent
- Assurez-vous que le trafic HTTPS sortant est autorisé à travers votre pare-feu
- Vérifiez si les serveurs proxy sont correctement configurés pour laisser passer les requêtes API
- L'inspection SSL/TLS peut nécessiter des exceptions pour les points de terminaison Verdent
Symptômes courants :
- L'extension semble se bloquer ou expirer
- Échecs d'authentification malgré des identifiants corrects
Si les problèmes persistent après la configuration du pare-feu, contactez le support Verdent pour obtenir des détails spécifiques sur les points de terminaison à mettre en liste blanche.
Mes règles AGENTS.md ne sont pas appliquées. Pourquoi ?
Vérifiez :
- Emplacement : Fichier dans le répertoire racine du projet
- Syntaxe : Markdown valide
- Spécificité : Les règles sont directives (« Utilise toujours... » et non « Essaie d'utiliser... »)
- Nouveau test : Démarrez une nouvelle conversation pour tester l'application
Priorité : AGENTS.md prévaut sur VERDENT.md pour le comportement spécifique au projet.
Comment corriger les erreurs « file_edit failed to find exact match » ?
Causes :
- Le texte a changé depuis la dernière lecture
- Différences d'espacement (espaces vs tabulations)
- Chaîne non unique dans le fichier
Solutions :
- Relisez le fichier pour obtenir le contenu actuel
- Fournissez une chaîne de contexte plus large pour l'unicité
- Utilisez
replace_all=truepour plusieurs chaînes identiques - Vérifiez que file_path est correct
Pourquoi mon sous-agent personnalisé ne s'invoque-t-il pas automatiquement ?
Vérifiez :
- Emplacement : Fichier dans
~/.verdent/subagents/[name].md - Politique d'invocation : Une politique stricte nécessite une mention @ explicite
- En-tête YAML : Syntaxe valide
- Directives « Quand l'utiliser » : Correspondance avec votre schéma de requête
Test : Utilisez une mention @ explicite pour vérifier que le sous-agent fonctionne : @your-subagent do task