AI CodeOps

Comment fonctionne AI CodeOps

Mis à jour le

Suivez une session de la tâche à la pull request fusionnée : les agents planifient et développent, vos tests s'exécutent en bac à sable, la revue par IA signale les problèmes, une personne approuve.

Une session mène une tâche d'une phrase à une pull request relue. Cette page suit une session à travers chaque phase, dans l'ordre où AI CodeOps les exécute.

1. Vous décrivez la tâche

Ouvrez Develop → AI Sessions et choisissez New session. Décrivez la tâche, choisissez un Workflow et un Project, puis choisissez Start session. Chaque session appartient à un projet.

Avant toute exécution, AI CodeOps vérifie deux choses :

  • Votre budget. Si l'espace de travail a dépassé son budget ou épuisé son quota, la session ne démarre pas et indique pourquoi. Consultez Maîtrise des coûts.
  • La politique de votre espace de travail. Une règle deny (refus) arrête la session. Une règle ask (demande d'approbation) la retient jusqu'à ce que quelqu'un l'approuve dans Review & Gate → Approvals. Consultez Approbations et politiques.

La session est ensuite mise en file d'attente avec le statut pending jusqu'à ce qu'un worker la prenne en charge.

2. Les agents déroulent le workflow

Un workflow est une liste fixe d'étapes. Chaque étape est exécutée par un agent, et les étapes s'exécutent l'une après l'autre. Le workflow par défaut, Plan, Build, Review & Test, en compte quatre :

  1. Plan, par l'Architect.
  2. Build, par le Builder.
  3. Review, par le Reviewer.
  4. Test, par le Tester.

Les étapes qui vont jusqu'à celle qui implémente le changement (ici, Plan et Build) s'exécutent en premier. Les étapes suivantes vérifient le travail : elles attendent donc que le code soit écrit et que vos tests aient été exécutés dessus (phase 5).

Chaque étape voit la tâche et ce que les étapes précédentes ont écrit. Le budget est vérifié de nouveau avant chaque appel au modèle. Une session qui dépasse le budget en cours de route s'arrête en indiquant le motif. Les autres workflows sont listés dans Workflows.

3. Le changement est écrit

AI CodeOps transforme ensuite le plan en fichiers complets. Il les applique à une copie fraîche de votre dépôt et produit un diff. Un projet sans dépôt reçoit à la place une nouvelle base de code.

Une réponse tronquée en cours de route conserve ce qu'elle a écrit et le reste lui est redemandé : les fichiers qu'elle n'avait pas atteints, et la suite du fichier dans lequel elle s'est arrêtée. Avant toute revue, chaque fichier est vérifié : les marqueurs de diff parasites sont retirés, et un fichier qui ne passe pas l'analyse syntaxique est redemandé une fois. Un fichier qui ne la passe toujours pas est enregistré comme un constat high.

Un diff de plus de 60 KB est refusé en bloc : « Split the task into smaller changes. » Si aucun changement de fichier utilisable ne revient, la session échoue en indiquant le motif.

4. Vos tests s'exécutent

AI CodeOps reconstruit le changement dans un bac à sable isolé. Il installe les dépendances, coupe le bac à sable du réseau et exécute la commande de test de votre projet. Le résultat est enregistré comme l'exécution de tests de la session : tests réussis, échoués, ignorés et couverture.

La commande de test est celle définie sur le projet. À défaut, AI CodeOps cherche un script test dans package.json, puis pytest, puis go test. Si les tests ne peuvent pas s'exécuter du tout (pas de commande, ou des dépendances qui ne s'installent pas), rien n'est enregistré et la page de l'exécution indique que le changement n'a pas été vérifié. La barrière de livraison ne compte pas cela comme une réussite : elle refuse un changement de code sans résultat de test, sauf si Don't run tests for this project est activé pour le projet.

5. Les étapes restantes vérifient le changement écrit

Les étapes qui suivent l'étape d'implémentation (ici, Review et Test) s'exécutent maintenant. Chacune reçoit le changement tel qu'il a été écrit ainsi que le résultat de test enregistré, et il lui est demandé de citer les fichiers qu'elle a lus. Le résumé de la session provient de la dernière d'entre elles : il est donc écrit après l'exécution des tests.

Si l'une de ces étapes échoue ou manque de temps, la session poursuit avec son changement : le code est écrit et testé, et l'étape est marquée failed sur la page de la session.

6. Le diff est relu

Une passe de revue lit le diff réel, avec les notes des étapes de revue et de sécurité comme contexte. Elle enregistre des constats, chacun avec une gravité, une catégorie et généralement un fichier. Pour une session de suivi, elle est aussi informée de ce que les tours précédents ont relevé et de ce qu'une personne a décidé pour chaque point. Consultez Revues multi-agents.

Si cette revue ne peut pas se terminer, le changement est retenu : ses constats sont inconnus, il ne peut donc pas être considéré comme au vert.

7. Le changement attend une personne

Lorsque la session se termine avec un diff, AI CodeOps :

  • marque la session completed ;
  • fait passer son changement à in review sous Develop → Changes ;
  • ouvre une demande de revue dans Review & Gate → Approvals. Elle expire au bout de 7 jours.

Ouvrez la page de la session pour voir le résumé, les Proposed changes, le panneau Quality gates et les Findings.

8. Une personne approuve

Choisissez Accept changes sur la page de la session, ou Approve sur la page Approvals. 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.

9. La pull request s'ouvre

L'approbation déclenche la pull request. Avant de l'ouvrir, AI CodeOps vérifie, dans l'ordre :

  1. la politique de l'espace de travail ;
  2. l'approbation ;
  3. la barrière qualité : aucun constat high ou critical ouvert, aucun test en échec et une revue terminée.

Si les trois sont validés, AI CodeOps pousse une branche nommée codeops/run-<id> et ouvre une pull request vers la branche par défaut du projet. Il utilise la connexion Git de la personne qui a approuvé : celle-ci a donc besoin d'un compte Git connecté pour cet hébergeur. Si la pull request n'a pas pu s'ouvrir, choisissez Create Pull Request sur la page de la session. Le bouton indique ce qui manque.

10. Fusion et déploiement

Fusionnez la pull request quand vous êtes prêt. Si vous la fusionnez depuis la console, la barrière qualité est d'abord vérifiée de nouveau. Si le projet a une cible de déploiement, AI CodeOps appelle ensuite votre webhook de déploiement et enregistre le déploiement. Consultez Déploiements sous contrôle.

Limites de temps

PhaseLimite
Étapes avant le code4 minutes au total
Écriture du changement8 minutes
Tests6 minutes, plus la commande déjà en cours
Étapes après le code3 minutes au total
Revue du diff2 minutes
Session entièreArrêtée comme bloquée au bout d'environ 30 minutes

Une session qui dépasse le délai ou se bloque se termine en failed, avec le motif sur sa page.

Étapes suivantes

Questions fréquentes

Une session IA fusionne-t-elle du code d'elle-même ?

Non. Une personne approuve chaque changement de code avant l'ouverture de sa pull request, et la fusion est une étape distincte que vous effectuez.

Et si mon projet n'a pas de tests ?

La session s'exécute quand même, et la page de l'exécution indique que la vérification a été ignorée. La barrière de livraison refuse alors le changement, car un changement de code sans résultat de test n'est pas une réussite. Si le projet n'a pas de suite de tests, activez « Don't run tests for this project » dans ses réglages.

Puis-je regarder les agents pendant qu'ils travaillent ?

Oui. La page de la session se met à jour en direct avec chaque étape, son agent, son statut, ainsi que les tokens et le coût à ce stade.

Cette page vous a-t-elle été utile ?