# Sous-agents (/fr/docs/verdent-manager/configuration/subagents)

> 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 [#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                                                                               |

<Note>
  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.
</Note>

***

## Comment utiliser les sous-agents [#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 [#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 [#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 [#format-de-fichier]

Chaque sous-agent est un fichier Markdown avec un frontmatter YAML :

```markdown
---
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 [#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 `.md` prend effet immédiatement—pas besoin de redémarrer Verdent.

***

## Gestion des sous-agents dans les paramètres [#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 [#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 [#cas-dusage]

### Revue de code [#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 [#conception-darchitecture-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 [#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 [#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 [#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.
