
En bref
|
Une alerte se déclenche un mardi matin. Les exportations pour quelques clients dépassent le délai d’attente, et ce uniquement pour les comptes créés avant 2023. Tu remontes jusqu’à une modification de requête déployée il y a plusieurs mois.
git blame pointe vers un commit de fusion provenant d’une branche appelée company/issue-418. La pull request a été ouverte par un agent et approuvée par quelqu’un qui a depuis changé d’équipe. Le message du commit indique : « Optimisation de la requête d’exportation pour les grands comptes. »
C’est un début. Ce que tu dois savoir, c’est pourquoi l’agent a choisi de supprimer l’indice d’indexation, s’il connaissait l’ancien schéma de compte, et si quelqu’un avait signalé le risque à l’époque. Ces réponses se trouvaient dans l’exécution de l’agent, et la possibilité de les retrouver dépend du fait qu’elles aient été enregistrées ou non.
Point clé : Git enregistre le résultat d’une modification. Pour le travail d’un agent, le contexte qui explique ce résultat se trouve dans l’exécution, et il disparaît à moins qu’un système ne le conserve.
Pour le code écrit par des humains, l’historique Git, combiné à quelques questions ici et là, te permet généralement de comprendre la raison d’une modification. Le message de commit te donne un indice, la discussion sur la pull request comble certaines lacunes, et l’auteur se souvient généralement du reste.
Le travail des agents rompt cette chaîne à trois endroits.
Tu peux pallier en partie ce problème avec un peu de discipline, par exemple en collant les plans dans les descriptions des PR ou en les ajoutant dans un répertoire docs. Ça marche jusqu’à ce que la file d’attente s’allonge. Un enregistrement capturé automatiquement, au fur et à mesure de l’exécution, tient mieux la route qu’un enregistrement qui dépend de la mémoire de quelqu’un.
Point clé : chaque invite, diff, validation et événement d’utilisation est consigné en lien avec l’exécution qui l’a généré, et chaque élément répond à une question précise que tu te poseras plus tard.
Upsun Dispatch est la plateforme dédiée à la collaboration pilotée entre les agents IA et les équipes humaines interfonctionnelles. Chaque exécution de processus devient une exécution dans la console Upsun Dispatch, et l’historique est enregistré au fur et à mesure de l’exécution plutôt que d’être reconstitué après coup. Voici ce qu’il contient et où trouver chaque élément.
| Ce qui est enregistré | Où le trouver | La question à laquelle ça répond |
|---|---|---|
| Invites et appels d’outils | Détails de l'exécution, dans le fil d'activité | Qu'est-ce qu'on a dit à l'agent, et qu'est-ce qu'il a regardé ? |
| Le plan : résumé, plan complet, fichiers concernés, complexité, hypothèses et risques | Publié sur le ticket ou le problème d'origine | Quelles étaient les intentions de l'agent et quelles étaient ses hypothèses ? |
| Validations et révisions du plan (Jira fonctionne avec le contrôle de validation du plan activé) | Détails de l'exécution | Qui a validé l'approche, et qu'est-ce qui a changé avant le codage ? |
| Différences, artefacts, PR ouverts et résultats des pushs | Détails de l'exécution et la pull request elle-même | Qu’est-ce qui a changé exactement, et où ça a été intégré ? |
| Conclusions de l'analyse | La description de la pull request et les détails de l'exécution | Quels problèmes ont été signalés avant que quelqu’un ne l’examine ? |
| Étapes, tentatives et chronologie des événements | Détails de l'exécution | Que s'est-il passé, dans quel ordre, et à quel moment y a-t-il eu une nouvelle tentative ou un échec ? |
| Journaux | Courts extraits dans les détails de l'exécution, journaux complets par tâche | Quels ont été les résultats de chaque étape ? |
| Utilisation | Détails de l'exécution, ainsi que des rapports d'utilisation par modèle ou processus | Quelles ressources l'exécution a-t-elle consommées ? |
| État actuel de la PR associée : titre, cycle de vie, décision de révision, dernier commit | La vue de l'entité associée | Qu'est-il advenu de la modification après l'exécution ? |
L'historique est en écriture seule : les entrées ne peuvent être ni modifiées ni supprimées dans le cadre d'une utilisation normale. Relancer une exécution terminée lance un nouveau processus et laisse l'exécution d'origine telle quelle.
Point clé : commence par le code, suis les liens pour revenir à la ticket, puis ouvre l'exécution. Chaque étape répond à une partie différente de la question « pourquoi ».
Revenons aux exportations qui ont expiré. Voici comment tu peux remonter du commit fusionné jusqu’au raisonnement de l’agent.
Au final, tu sais ce qu’on a demandé à l’agent, ce qu’il a supposé, ce qu’il a examiné, ce qui a été signalé et qui a donné son accord. C’est généralement suffisant pour distinguer une mauvaise hypothèse d’une mauvaise révision, et pour corriger ce qu’il faut.
Point clé : l’historique montre ce qui a été fourni à un agent, ce qu’il a prévu, ce qu’il a fait et qui l’a approuvé. Il ne peut pas te dire si la modification était juste, et il ne couvre que le travail qui est passé par Upsun Dispatch.
Le journal fait ses preuves dans quelques situations récurrentes : déboguer une modification longtemps après sa fusion, rédiger un bilan rétrospectif, examiner une pull request en tenant compte du contexte plutôt que d’un simple diff, et expliquer à un coéquipier pourquoi le code se présente ainsi.
Il présente également des limites qu’il vaut mieux connaître avant de s’y fier.
Le moyen le plus rapide de comprendre ce qu’enregistre une exécution est d’en consulter une dans ton propre dépôt. Connecte-toi à GitHub ou GitLab, enregistre une clé de modèle, puis déclenche une révision de code sur une pull request. Chaque nouvelle organisation commence avec un forfait gratuit, sans carte bancaire requise.
CTA : Lance ton premier processus
Qu’est-ce qu’une piste d’audit d’un agent IA ?
Un enregistrement de ce qui a été demandé à un agent, du contexte qu’il a utilisé, de ce qu’il a prévu et fait, et de la personne qui a approuvé son travail. Ça permet à une équipe de retracer l’intention derrière une modification écrite par un agent après coup.
Qu’enregistre Upsun Dispatch à chaque exécution ?
Chaque invite, différence, validation et événement d’utilisation, capturés au fur et à mesure. Les détails de l’exécution dans la console affichent également les étapes, les événements chronologiques, les appels d’outils, les résultats, les artefacts, les journaux et la pull request associée.
Où puis-je consulter le plan d’un agent ?
Pour les exécutions De ticket à code, Upsun Dispatch publie un plan structuré sur le ticket d’origine avant d’écrire le code. Il comprend un résumé, le plan complet, les fichiers concernés, la complexité, les hypothèses et les risques.
Est-ce que l’historique peut être modifié a posteriori ?
Le journal est en mode ajout seul ; les entrées ne peuvent donc pas être modifiées ni supprimées dans le cadre d’une utilisation normale. Relancer une exécution terminée crée une nouvelle exécution et laisse l’originale inchangée.
Le journal indique-t-il le travail effectué par l’agent en dehors d’Upsun Dispatch ?
Non. Il couvre uniquement les exécutions qui passent par les processus d’Upsun Dispatch. Les sessions de l’agent sur la machine d’un développeur ou dans d’autres outils ne sont pas incluses.