Sous-agents
Agents experts spécialisés que l'agent principal peut solliciter à la demande
Un sous-agent est un « expert » spécialisé que l'agent principal (Worker) peut solliciter à tout moment pendant l'exécution d'une tâche. Chaque sous-agent possède son propre domaine d'expertise, un prompt dédié, et peut même s'exécuter sur un modèle différent. Dans le chat, il suffit de saisir @SubagentName pour qu'il se joigne à l'aide, comme lorsqu'on identifie un collègue dans une conversation de groupe.
Sous-agents intégrés
Verdent est livré avec 6 sous-agents prêts à l'emploi, couvrant les besoins les plus courants en développement logiciel :
| Nom | Modèle par défaut | Points forts |
|---|---|---|
| General | Suit l'agent principal | Un agent de recherche généraliste pour les problèmes complexes, la recherche de code et les tâches à plusieurs étapes—capable d'aider sur presque tout |
| Fast Context | Gemini 3 Flash | Localise rapidement le code et rassemble des preuves contextuelles ; spécialisé dans l'indexation de base de code et extrêmement rapide |
| Verifier | Sonnet 4.6 | Revue de code rapide—après vos modifications, identifiez-le pour repérer les problèmes évidents |
| Verdent Helper | Haiku 4.5 | Un assistant d'utilisation de Verdent ; posez-lui toutes vos questions sur le fonctionnement de Verdent |
| Multi-Model Planner | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Génère des plans à l'aide de plusieurs modèles (Claude, GPT, Gemini) et fusionne leurs résultats |
| Reviewer | Gemini 3.1 Pro; Opus 4.6; GPT-5.4 | Revue de code complète : erreurs de logique, cas limites, risques cachés |
Deux sous-agents sont particuliers : Multi-Model Planner et Reviewer exécutent 2 à 3 modèles en parallèle. Chaque modèle réfléchit indépendamment, produit son propre résultat, puis les résultats sont combinés. Tous les autres sous-agents utilisent un seul modèle.
Comment utiliser les sous-agents
Dans n'importe quelle conversation, saisissez @ pour ouvrir le menu de sélection des sous-agents (recherche floue prise en charge). Sélectionnez le sous-agent souhaité et il prendra le relais du contexte en cours.
Exemples :
- Après avoir écrit une logique d'authentification complexe :
@Reviewer please review this→ Reviewer la vérifie du point de vue sécurité, logique et cas limites. - Pour une décision d'architecture délicate :
@Multi-Model Planner→ plusieurs modèles proposent des solutions et vous choisissez la meilleure. - Après avoir codé, lancez rapidement
@Verifier→ plus rapide que l'exécution de suites de tests complètes pour une validation de base.
Sous-agents personnalisés
Les sous-agents intégrés couvrent la plupart des besoins, mais parfois vous souhaitez un spécialiste adapté à votre projet. Vous pouvez créer le vôtre.
Emplacement de stockage
Les sous-agents personnalisés sont stockés sous forme de fichiers Markdown dans :
~/.verdent/subagents/Jusqu'à 5 niveaux de sous-répertoires sont pris en charge pour l'organisation.
Format de fichier
Chaque sous-agent est un fichier Markdown avec un frontmatter YAML :
---
name: SQL-Expert
description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies
color: blue
model: claude-sonnet-4-6
---
You are a senior database expert focused on PostgreSQL performance optimization.
When users provide SQL queries, you should:
1. Analyze the query execution plan
2. Identify performance bottlenecks (full table scans, missing indexes, etc.)
3. Provide concrete optimization suggestions and rewritten SQL
...Détails importants
- Nom : doit contenir uniquement des lettres, des chiffres et des traits d'union (par exemple
SQL-Expert,MyAgent123). Aucun espace ni caractère non-ASCII. - Couleur : l'une des valeurs
dark-green,light-green,red-orange,amber,cyan,blue,pink,purple,verdent—pour faciliter la reconnaissance visuelle. - Rechargement à chaud : l'enregistrement du fichier
.mdprend effet immédiatement—pas besoin de redémarrer Verdent.
Gestion des sous-agents dans les paramètres
Toute la gestion des sous-agents se fait dans Paramètres → Sous-agents.
| Action | Description |
|---|---|
| Voir la liste | Tous les sous-agents s'affichent sous forme de cartes. Les sous-agents intégrés portent la mention « Intégré » ; ceux basés sur des plugins affichent le nom du plugin. |
| Activer / Désactiver | Activez ou désactivez chaque sous-agent sans affecter les autres. |
| Créer | Sélectionnez Add Subagent et renseignez Identifier (nom unique), Model, Description et Prompt. |
| Modifier | Survolez une carte pour la modifier. Pour les sous-agents intégrés, seuls Model et Description peuvent être modifiés. |
| Dupliquer | Copiez n'importe quel sous-agent personnalisé (les doublons sont désactivés par défaut jusqu'à activation). |
| Supprimer | Les sous-agents personnalisés peuvent être supprimés (avec confirmation). Les sous-agents intégrés ne peuvent pas être supprimés. |
Différences de sélection du modèle
- Multi-Model Planner et Reviewer permettent une sélection multi-modèle (2 à 3 modèles à la fois).
- Les autres sous-agents utilisent une sélection à un seul modèle.
- General dispose d'une option spéciale : il peut suivre automatiquement le modèle de l'agent principal, évitant ainsi une configuration séparée à maintenir.
Cas d'usage
Revue de code
Après avoir implémenté une logique complexe, identifiez @Reviewer. Il vérifie l'exactitude, les cas limites et les bugs potentiels—vous évitant une inspection manuelle ligne par ligne.
Conception d'architecture multi-perspectives
Pour les décisions majeures (par exemple, adoption de microservices, choix de base de données), utilisez @Multi-Model Planner pour obtenir des propositions indépendantes de plusieurs modèles de premier plan et réduire le risque de décision.
Validation rapide
Après des modifications de code, @Verifier vérifie rapidement la syntaxe, les types et les problèmes de base—plus rapide qu'une suite de tests complète, plus fiable qu'une absence de vérification.
Experts de domaine personnalisés
Créez des sous-agents adaptés à votre projet :
- Expert en optimisation SQL connaissant votre schéma et vos schémas de requêtes
- Gardien des standards de code frontend appliquant vos règles ESLint et de système de design
- Assistant de documentation qui adapte le contenu technique en une rédaction claire et accessible au lecteur
Remarques
- Les sous-agents personnalisés doivent être configurés avec un modèle valide pour être activés. Si vous utilisez BYOK et que la clé expire ou que le modèle est retiré, le sous-agent sera désactivé automatiquement.
- Les modèles des sous-agents intégrés peuvent être modifiés, mais les valeurs par défaut sont optimisées—les modifier peut réduire les performances.
- La description compte : elle est injectée dans le contexte de l'agent principal et influence le moment où les sous-agents sont appelés. De meilleures descriptions conduisent à un routage plus intelligent.
- Les sous-agents ne peuvent pas s'appeler entre eux. Ils ne peuvent être invoqués que par l'agent principal (Worker)—aucune imbrication plus profonde n'est autorisée.