- Accueil
- Documentation
- Revues multi-agents
Revues multi-agents
Mis à jour le
Comment AI CodeOps relit un changement avec plusieurs agents : les étapes de revue, une passe des constats sur le diff réel, la gravité et le tri, puis l'approbation humaine qui suit.
Dans AI CodeOps, l'agent qui écrit un changement n'est pas celui qui le vérifie. Des étapes de revue du workflow examinent le travail sous différents angles. Une passe des constats relit ensuite le diff réel et enregistre des constats structurés. Une personne prend la décision finale.
Les étapes de revue du workflow
La plupart des workflows comportent une ou plusieurs étapes de revue, chacune exécutée par son propre agent :
- Plan, Build, Review & Test a une étape Review, par le Reviewer.
- Security-Sensitive Change a une étape Risk analysis avant le changement et une étape Audit diff après, toutes deux par le Security Auditor.
- Parallel Review a trois revues (exactitude par le Reviewer, sécurité par le Security Auditor, couverture de tests par le Tester), puis une étape Merge findings qui les combine.
- Release Readiness ajoute une vérification E2E sanity et un audit des dépendances, puis une étape Go / no-go.
- Architecture Debate fait proposer une approche à chacun de deux architectes, les fait relire par un critique, puis produit une synthèse finale.
Les étapes s'exécutent l'une après l'autre. Chacune voit ce que les étapes précédentes ont écrit : une étape de fusion ou de synthèse travaille donc à partir de toutes les revues qui la précèdent. Rien n'est décidé par vote.
Quand une étape de revue s'exécute
Une étape qui vérifie le travail ne peut vérifier qu'un travail qui existe. Une session s'exécute donc dans cet ordre :
- Les étapes qui vont jusqu'à celle qui implémente le changement s'exécutent en premier. Dans Plan, Build, Review & Test, ce sont Plan et Build ; dans Security-Sensitive Change, ce sont Scope change, Risk analysis et Implement.
- Le changement est écrit, et les tests de votre projet s'exécutent dessus.
- Les étapes qui suivent l'étape d'implémentation s'exécutent : Review et Test, ou Audit diff et Validate. Chacune reçoit le changement tel qu'il a été écrit (le diff, coupé pour tenir, avec la coupe signalée lorsqu'il est long) ainsi que le résultat de test enregistré, et il lui est demandé de citer les fichiers qu'elle a lus.
Si l'une de ces étapes ultérieures échoue ou manque de temps, la session conserve son changement et l'étape est marquée failed sur la page de la session.
Un workflow sans étape d'implémentation, comme Parallel Review, Swarm Inspection ou Release Readiness, exécute toutes ses étapes avant qu'aucun code soit écrit. Ses revues portent sur le code déjà présent dans votre dépôt. Architecture Debate écrit des documents et pas de code.
La passe des constats
Les étapes de revue écrivent des notes sous forme de texte. Ainsi, une fois le changement écrit et testé et ces étapes exécutées, AI CodeOps lance une revue distincte du diff lui-même, qui enregistre les constats conditionnant le passage du changement. Elle reçoit :
- le diff, comme objet de la revue ;
- les notes de chaque étape dont le nom mentionne review, security, audit, risk ou test, comme contexte ;
- pour une session de suivi, ce que les tours précédents ont relevé et ce qu'une personne a décidé pour chaque point.
Il est indiqué à la revue qu'un constat high ou critical doit énoncer l'entrée concrète qui le déclenche et ce qui se passe mal, et qu'un constat qu'elle ne peut pas étayer ainsi est medium au plus.
Elle enregistre jusqu'à 12 problèmes concrets comme constats. Ils sont attribués au Security Auditor si cet agent s'est exécuté dans la session, sinon au Reviewer, sinon au dernier agent qui s'est exécuté.
Chaque constat a un titre, une description, une recommandation et, généralement, un fichier.
Gravité
| Gravité | Bloque le changement tant qu'il n'est pas résolu ? |
|---|---|
| critical | Oui |
| high | Oui |
| medium | Non |
| low | Non |
| info | Non |
Catégorie
Security, quality, performance, accessibility, compliance, dependency, documentation, test coverage, reliability, cost, UX ou other.
Quand la revue ne peut pas se terminer
La passe des constats dispose de deux minutes. Une réponse qui ne peut pas être lue comme des constats est redemandée une fois, et une réponse tronquée en cours de route conserve les constats qu'elle a terminés. Si le modèle échoue ou manque de temps, si le budget s'épuise avant, ou si la réponse reste illisible, la revue compte comme non terminée. Le changement est alors retenu, et la page de la session indique lequel de ces cas s'est produit et quoi faire : relancer la session, ou relever d'abord le budget. Une liste vide, en revanche, est une revue terminée qui n'a rien trouvé.
Trier les constats
Ouvrez la page d'une session et repérez la liste Findings. Définissez le statut de chaque constat depuis sa liste déroulante :
| Statut | Bloque encore (si high ou critical) ? |
|---|---|
| open, acknowledged, in progress | Oui |
| fixed, won't fix, false positive, duplicate | Non |
Choisissez Fix sur un constat pour lancer une session qui le corrige. Il est demandé à cette session d'inclure un test qui reproduit le constat. Les constats de tout l'espace de travail se trouvent sous Build & Test → Quality. Modifier un statut nécessite un rôle doté de la permission de tri ; le rôle Viewer ne l'a pas. Consultez Barrières qualité.
La revue humaine
Lorsque la passe des constats est terminée et que la session a produit un diff, AI CodeOps ouvre une demande de revue dans Review & Gate → Approvals. Une personne lit le diff et les constats, puis approuve ou rejette.
- La personne qui a lancé la session ne peut pas l'approuver tant que quelqu'un d'autre dans l'espace de travail le peut. Un espace de travail d'une seule personne peut approuver son propre changement.
- Un seul rejet met fin à la demande.
- Modifier le changement après l'approbation le renvoie en approbation.
L'approbation ouvre la pull request, si la barrière qualité passe elle aussi. Consultez Approbations et politiques.
Étapes suivantes
Questions fréquentes
La revue porte-t-elle sur le code ou sur le plan ?
Sur le code. Une étape de revue qui suit l'étape d'implémentation du changement s'exécute une fois le code écrit, et reçoit le diff et le résultat des tests. La passe des constats lit ensuite le même diff, avec les notes des étapes de revue comme contexte.
Les agents de revue votent-ils ?
Non. Chaque étape de revue écrit son analyse à son tour, et une étape finale ou la passe des constats les lit toutes. Il n'y a ni vote ni décompte de consensus.
Que se passe-t-il si la revue par IA échoue ?
Le changement est retenu. Ses constats sont inconnus, il ne peut donc pas ouvrir de pull request tant que vous n'avez pas relancé la session.