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 :
- 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.
- Exécution interrompue : un encadré qui explique l'arrêt, le cas échéant (voir États et erreurs).
- Questions du rôle Analyse : les questions posées quand le besoin est ambigu (voir Répondre aux questions).
- Proposition : le résumé du correctif, suivi de la mention Tests du dépôt non exécutés.
- Résultat des agents : une section par agent avec son état, ses horodatages et son résultat.
- Fichiers de contexte : le commit de base et la liste des fichiers lus, avec leur taille en octets.
- Actions sur l'exécution : précision, relance, annulation, archivage.
- 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.
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.