AI CodeOps

Agent Builder

L'agent Builder décrit, fichier par fichier, les changements de code exacts qu'exige une tâche. Il intervient dans six workflows intégrés, avant que la passe de code écrive le diff réel.

L'agent Builder implémente. À partir d'un plan, il décrit les changements de code exacts à apporter : fichier par fichier, avec le code clé ou du pseudo-code, et leur raison. Il signale aussi tout ce qui demande un suivi.

Où il intervient

WorkflowÉtape
Plan, Build, Review & TestBuild
Security-Sensitive ChangeImplement
UI ImplementationImplement
Incident ResponseMitigation
Performance TuningApply
Quality-Gated ChangeBuild

Entrées

  • La tâche de la session.
  • Un instantané en lecture seule des fichiers pertinents du dépôt du projet, ou rien lorsque le projet part de zéro.
  • Les étapes précédentes. Dans la plupart des workflows, il s'agit d'un plan de l'Architect ou du UI Designer. Dans Security-Sensitive Change, elles comprennent aussi l'analyse des risques du Security Auditor. Dans Quality-Gated Change, le Builder s'exécute en premier et travaille à partir de la seule tâche.

Sorties

L'étape du Builder renvoie du texte : les changements fichier par fichier et le raisonnement qui les motive. C'est une entrée parmi d'autres pour la suite.

Dans chaque workflow où il intervient, l'étape du Builder est la dernière avant l'écriture du code. Juste après, la session exécute une passe de code. Cette passe lit la tâche, le code et le travail de l'équipe jusque-là (description du Builder comprise), et renvoie le nouveau contenu complet de chaque fichier qu'elle modifie. La plateforme écrit ces fichiers dans un clone jetable et en tire un vrai diff git. C'est ce diff que vous relisez, sur lequel les tests du projet s'exécutent, et qui devient une pull request après l'approbation.

Les étapes qui suivent celle du Builder, comme Review et Test, s'exécutent une fois le code écrit et les tests exécutés. Elles reçoivent ce diff et le résultat de test enregistré, et pas seulement la description du Builder.

Exemple d'exécution

Exemple illustratif, pas une session enregistrée. Dans Incident Response, l'Incident Responder a trié un pic d'erreurs 500 sur le paiement, et l'Architect l'a fait remonter à un code de devise nul renvoyé par un prestataire de paiement. L'étape Mitigation du Builder propose une garde dans l'adaptateur de paiement qui se rabat sur la devise de la commande, une ligne de journal lorsque ce repli se déclenche, et une note de suivi pour corriger proprement la correspondance du prestataire. La passe de code en fait un diff de deux fichiers, et les tests du projet s'exécutent dessus. L'étape Verify du Tester lit ensuite le diff et le résultat de test.

Limites

  • Il n'exécute pas de commandes, ne compile pas de code et n'exécute pas de tests. Les tests s'exécutent plus tard, dans un bac à sable, sur le diff.
  • Ce qu'il décrit et ce qu'écrit la passe de code peuvent différer. Relisez le diff, pas la description.
  • La passe de code lit une quantité fixe de ce qu'ont écrit les étapes qui la précèdent. Lorsque ces étapes sont longues, la dernière d'entre elles peut être coupée de ce qu'elle voit.
  • Un changement trop volumineux pour être relu met fin à la session avec ce motif. Il n'est jamais tronqué en silence.
  • Le plafond de dépenses de votre espace de travail s'applique à toute la session. Il n'y a pas de plafond distinct par agent. Consultez maîtrise des coûts.

Questions fréquentes

L'agent Builder modifie-t-il directement mon dépôt ?

Non. Il décrit le changement. Une passe de code distincte écrit des fichiers complets dans une copie jetable du dépôt et produit un diff, qui n'est intégré qu'après la barrière de livraison et l'approbation.

Quel modèle le Builder utilise-t-il ?

Le modèle de la session. Avec le niveau Auto, son étape va d'abord au niveau Economy, et la passe de code qui écrit les fichiers va d'abord au niveau Standard.