---
title: Les cinq agents
description: Le rôle des agents Exploration, Analyse, Conception, Développement et Revue, et la lecture de l'onglet Agents et besoin.
---

# Les cinq agents

Chaque exécution enchaîne cinq agents spécialisés. Chacun reçoit un contexte borné et rend une réponse contrôlée avant que le suivant ne démarre.

**Qui peut le faire** : tout membre du projet consulte l'onglet **Agents et besoin**. Les actions de cet onglet sont réservées à l'Opérateur, au Responsable et à l'Administrateur.

## Le rôle de chaque agent

| Agent | Ce qu'il fait |
| --- | --- |
| **Exploration** | Parcourt l'arborescence du commit de base (1 500 chemins au plus) et choisit les fichiers utiles. Les Dockerfile et fichiers Compose passent en priorité quand l'issue les mentionne. |
| **Analyse** | Comprend le besoin, demande si nécessaire jusqu'à trois compléments de lecture, et pose des questions si le besoin est ambigu. Il propose aussi une sévérité motivée. |
| **Conception** | Décrit la solution retenue et ses risques. |
| **Développement** | Rédige le correctif, limité aux fichiers déjà lus (8 fichiers au plus). |
| **Revue** | Relit le correctif de façon indépendante. Il peut le refuser et confirme ou conteste la sévérité proposée. |

Une revue négative, une réponse mal formée ou un contexte insuffisant arrêtent le parcours. Aucun agent n'a de shell, d'outil ni d'accès au serveur.

## Lire l'onglet Agents et besoin

Tant que l'exécution est **En file** ou **En cours**, la page s'actualise d'elle-même (mention « Actualisation automatique tant que l'exécution est active. »). Votre saisie en cours est conservée. L'onglet s'ouvre par défaut sur le détail d'une exécution. Il présente, de haut en bas :

1. **Besoin au démarrage** : le texte de l'issue tel qu'il a été figé au début de l'exécution. Si l'issue change ensuite sur GitHub, une reprise peut être refusée.
2. **Exécution interrompue** : un encadré qui explique l'arrêt, le cas échéant (voir [États et erreurs](10-etats-et-erreurs.md)).
3. **Questions du rôle Analyse** : les questions posées quand le besoin est ambigu (voir [Répondre aux questions](05-repondre-aux-questions.md)).
4. **Proposition** : le résumé du correctif, suivi de la mention **Tests du dépôt non exécutés.**
5. **Résultat des agents** : une section par agent avec son état, ses horodatages et son résultat.
6. **Fichiers de contexte** : le commit de base et la liste des fichiers lus, avec leur taille en octets.
7. **Actions sur l'exécution** : précision, relance, annulation, archivage.
8. **Rapport PDF client** : les éditions du rapport d'incident.

## Lire le résultat de chaque agent

La carte **Résultat des agents** présente les cinq agents dans l'ordre. Pour chaque étape, elle affiche l'état, l'heure de début et de fin, puis les champs propres à l'agent :

| Agent | Champs affichés |
| --- | --- |
| Tous | **Résumé** |
| **Exploration** | **Fichiers retenus** |
| **Analyse** | **Sévérité de l'incident** (avec sa justification), **Critères d'acceptation**, **Questions** |
| **Conception** | **Plan**, **Risques** |
| **Revue** | **Décision** (**Approuvé** ou **Refusé**), **Constats**, **Avis sur la sévérité** |

Une valeur absente s'affiche *Inconnu* ; une liste vide s'affiche **Aucun**. Un texte qui contient un marqueur de secret ou un terme interne est remplacé par un message de masquage. Le code proposé et le contenu des fichiers lus ne sont jamais affichés ici : utilisez l'onglet **Diff**.

Si l'agent travaille encore, la section indique « Résultat en attente : l'agent travaille. ». Si aucune sortie n'a été conservée, elle indique « Sortie non conservée pour cette étape : résultat inconnu. ».

## États d'une étape

| Affichage | Signification |
| --- | --- |
| **En cours** | L'appel au modèle est parti, la réponse est attendue. |
| **Réussi** | L'étape a rendu une réponse valide. |
| **Refusé** | L'étape a refusé de poursuivre (revue négative, contexte refusé…). |
| **Indéterminé** | L'étape a été interrompue et son usage ne peut pas être attesté. Elle n'est pas relancée automatiquement. |
| **Réutilisée · réponse d'origine** | L'étape reprend le résultat validé d'une tentative précédente, sans nouvel appel ni coût. La réponse d'origine est affichée. |
| **Étape non lancée** | Le parcours s'est arrêté avant cet agent. |
| **Complément 1**, **Complément 2**… | Lectures supplémentaires demandées par l'agent Analyse. |

## La sévérité

L'agent Analyse propose une sévérité (`bloquant`, `majeur` ou `mineur`) avec sa justification, champ **Sévérité de l'incident**. L'agent Revue donne son **Avis sur la sévérité** dans le même appel : **Sévérité confirmée**, **Sévérité contestée** ou **Sévérité non jugée**. Le rapport d'incident ne retient le niveau que si la sévérité est confirmée ; sinon, il laisse le niveau vide et montre les deux avis.

## Le rapport d'incident

La carte **Rapport PDF client**, en bas de l'onglet, produit le rapport d'incident de l'exécution : chronologie, détail des étapes, solution retenue, différentiel en annexe. Les coûts et les jetons n'y figurent jamais. Voir [Rapports PDF](../05-rapports-usage-et-couts/01-rapports-pdf.md).

## Ce qui se passe ensuite

- **Correctif prêt** : le correctif est consultable dans l'onglet **Diff** et peut être publié en PR brouillon si la politique le permet.
- **Précisions requises** : l'exécution attend une réponse.
- **Refusé** ou **Échec** : vous pouvez relancer à partir d'un agent.

## Pour continuer

[Répondre aux questions](05-repondre-aux-questions.md)
