Harness engineering / Une explication illustrée
Comment fonctionne un harness d’agents IA
Le harness est l’environnement dans lequel l’agent travaille. Il détermine le contexte que l’agent reçoit, les outils qu’il peut utiliser et les contrôles qui s’appliquent à son travail. Suivez une demande, du brief à la décision humaine.
01 / L’atelier
Du brief à la revue.
Lorsque la réduction des animations est activée, l’atelier reste immobile. Vous pouvez explorer chaque étape et lire l’explication ci-dessous.
02 / Le fonctionnement
Que se passe-t-il à l’intérieur ?
Définir le résultat.
Vous fixez l’objectif, le résultat attendu et les critères de vérification.
Charger le contexte utile à cette étape.
Le harness sélectionne les instructions, documents et éléments de travail nécessaires à la décision suivante.
Le modèle propose l’action suivante.
Il peut répondre ou demander un outil. Le harness encadre l’exécution avec les permissions et limites configurées.
Exécuter, puis examiner le résultat.
Le harness vérifie la demande d’outil. Le résultat revient au modèle, même si l’action réussit, pour éclairer la suite.
Examiner l’échec, corriger ou passer le relais.
Continuer si la correction est justifiée et le budget le permet. Si le travail n’avance plus, qu’une décision manque ou qu’une limite est atteinte, transmettre les éléments utiles.
Vérifier la nouvelle version, puis la relire.
Les résultats de V1 ne valident pas V2. Les contrôles concernés sont relancés et réussissent dans cet exemple. Le résultat doit encore être relu avant de décider de la suite.
Vous gardez la main.
Vous fixez l’objectif, les limites et les décisions à prendre. Le harness prépare un résultat vérifiable. La livraison et la satisfaction du besoin restent à confirmer.
Une métaphore pédagogique, avec des limites.
Les Crew représentent des rôles : un harnais peut fonctionner avec un seul agent. Les mini-Crew représentent des tâches déléguées. Le tuyau renvoie les observations ; il ne réentraîne pas le modèle. Les outils, les contrôles et les approbations humaines dépendent du système.
Si l’exécution est bloquée, la transmission comprend les tentatives précédentes, le blocage et la décision nécessaire. Un test qui n’a pas été exécuté a un résultat inconnu. La réussite des contrôles ne prouve à elle seule ni la livraison ni que le besoin de l’utilisateur a été satisfait.
03 / En pratique
La démonstration suit un formulaire dont l’envoi échoue. Le contrôle vérifie que le texte reste en place pour que l’utilisateur puisse réessayer.
Ma méthode · Un exemple concret
Exemple : un échec d’envoi efface le message.
Suivez une exigence en quatre étapes : si l’envoi échoue, le visiteur doit pouvoir réessayer sans retaper son message. Cet exemple est illustratif.
Florian et votre équipe
Conserver le message du visiteur.
Nous convenons d’une exigence concrète : si l’envoi du formulaire échoue, le visiteur doit pouvoir réessayer sans réécrire son message.
Le résultat de cette étapeUn brief avec un critère d’acceptation vérifiable.
01 / Le brief convenu
Formulaire de contact / critères d’acceptation
- Le nom, l’email et le message ont des libellés visibles.
- Une saisie invalide reçoit une explication précise.
- Un échec d’envoi conserve tout le texte saisi.
- Seul un envoi réussi efface le formulaire.
Nous suivons ici le cas d’un échec d’envoi.
Agents front-end et back-end
Deux contributions, un formulaire fonctionnel.
Je donne à chaque agent une tâche délimitée et le contrat partagé. L’agent front-end construit les états du formulaire ; l’agent back-end gère la validation et les réponses.
Le résultat de cette étapeUne proposition de modification, prête à être vérifiée.
02 / La modification proposée
Un contrat de réponse partagé
Champs, messages d’erreur et état de nouvelle tentative.
Valider la saisie et renvoyer un succès ou un échec.
Cette version reste une proposition. Elle doit encore être vérifiée.
Contrôles automatisés et revue humaine
La première version perd le message.
Un test d’échec d’envoi révèle le problème. L’agent modifie le formulaire pour qu’il ne s’efface qu’après une réponse réussie, puis relance le même contrôle.
Le résultat de cette étapeUne correction et un contrôle reproductible, pas seulement l’affirmation que cela fonctionne.
03 / Les résultats de l’exemple
Même test. Résultat différent.
Saisissez « Bonjour, j’aimerais discuter d’un projet. », puis simulez un échec d’envoi.
Champ du message : vide
Le visiteur doit tout recommencer.
« Bonjour, j’aimerais discuter d’un projet. »
« L’envoi a échoué. Votre message est conservé ici. Réessayez. »
Résultats illustratifs pour cet exemple.
Florian et votre équipe
Nous vérifions la correction avant de l’accepter.
Les agents remettent le code modifié et le test avant/après. Avec votre équipe, je relis le changement et reproduis l’échec d’envoi. Nous acceptons la modification ou demandons une correction.
Le résultat de cette étapeDécision : accepter la modification ou demander une correction.
04 / Vérifier la correction
Le même test d’échec d’envoi, avant et après
Le visiteur doit tout retaper.
Le visiteur peut réessayer avec le même message.
Changement à relireVider les champs uniquement après un envoi réussi.
Avant la mise en ligneCe test vérifie uniquement la conservation du message. Il reste à vérifier la réception réelle des emails, la protection antispam et les réglages de production.
Étape 1 sur 4 · Définir la demande
Voir l’organisation des agents et sous-agents
L’organisation du travail
Dans un harness d’agents.
C’est une organisation possible, adaptée à l’équipe, au repository et à la tâche.
Choisir l’objectif, fixer les limites et examiner le résultat.
Harness · environnement de travail partagé
Contexte · exécution · contrôles- Connaissances et mémoireSources sélectionnées, documentation et décisions conservées.
- Instructions et skillsConsignes, méthodes réutilisables et conventions de travail.
- Outils et permissionsAccès délimité au code, aux commandes et aux systèmes connectés.
↓ Accessibles selon la tâche et les permissions
Agent front-end
Construire l’interface et intégrer les contributions.
Niveau 2 / Tâches déléguées
Chaque sous-agent reçoit une tâche et son contexte.
- Sous-agent UI designer
Préparer les états visuels
Mises en page, variantes et états vides.
- Sous-agent front-end
Construire les composants
Composants et interactions au périmètre défini.
- Sous-agent rédaction technique
Documenter l’utilisation
Notes d’utilisation et limites connues.
Les résultats reviennent à l’agent chargé de la mission. Il vérifie et assemble les contributions.
Un parcours utilisateur complet, prêt pour la revue.
Agent back-end
Préparer les données et vérifier les échanges.
Niveau 2 / Tâches déléguées
Chaque sous-agent reçoit une tâche et son contexte.
- Sous-agent back-end
Adapter un endpoint
Contrat et données attendues.
- Sous-agent débogage
Reproduire un défaut
Un cas reproductible et un diagnostic.
- Sous-agent sécurité
Vérifier les règles d’accès
Cas autorisés et refusés, avec les constats.
Les résultats reviennent à l’agent chargé de la mission. Il vérifie et assemble les contributions.
Une API intégrée, avec ses résultats de vérification.
Exécuter les contrôles configurés. Les résultats de la mission reviennent à Florian et à votre équipe pour examen et décision de livraison.
↶ Les constats et les corrections alimentent l’étape suivante. Les décisions utiles peuvent être conservées selon les règles de mémoire de l’équipe.
Un même ticket, trois façons de travailler
Dans cet exemple, un formulaire efface le message quand l’envoi échoue. Le même ticket sert à choisir un premier essai, à former l’équipe ou à intégrer un contrôle dans le repo.
Audit IA & roadmap
- Cadrer
On suit le signalement du support jusqu’au correctif dans un seul repo.
- Cartographier
On retrouve le signalement, les conditions pour reproduire l’échec et les contrôles qui existent déjà.
- Vérifier
On simule un envoi refusé. Le champ se vide et les contrôles actuels ne signalent pas la perte du texte.
- Prioriser
On décide de tester la conservation du message en premier, pour éviter à l’utilisateur de tout ressaisir.
- Restituer
La direction reçoit la priorité et sa justification. L’équipe reçoit les étapes pour reproduire le défaut.
Brain d’audit · Quand il est prévu, les sources et les constats y sont organisés au fil de l’audit.
Formation et coaching IA
- Fixer l’objectif
L’équipe veut savoir confier une correction à un agent et démontrer que le message reste disponible.
- Choisir un cas
Les participants rejouent le ticket sur un repo d’exercice avec un message fictif.
- Configurer
Ils donnent à l’agent le ticket, les fichiers utiles et le résultat attendu en cas d’échec.
- Tester et corriger
Ils font échouer l’envoi, vérifient que le test détecte la perte du texte, puis contrôlent la correction proposée.
- Refaire et transmettre
Un collègue reprend l’exercice avec un autre cas, comme une coupure réseau, et explique ce que le test vérifie.
Intégration d’agents IA
- Délimiter le pilote
On délimite le pilote à un repo et mesure le temps de correction et de revue sur un ticket comparable.
- Configurer
On donne à l’agent le ticket et les outils de test. Ses accès restent limités au périmètre du pilote.
- Mettre à l’épreuve
On simule un envoi refusé et on vérifie que le test échoue si le formulaire efface le message.
- Rejouer le test
On rejoue le test après le correctif. L’équipe vérifie aussi que le formulaire se vide après un envoi réussi.
- Passer le relais
L’équipe reprend la configuration et le scénario de test. Elle décide d’étendre, d’ajuster ou d’arrêter le pilote.
04 / Pour approfondir
Passer de la boucle à la pratique.
Quatre lectures pour approfondir les décisions illustrées dans cet atelier, de la boucle agentique au résultat utilisé.
Du code au merge
Relier la mise en œuvre, les contrôles et la revue humaine dans un même workflow.
ArticleLa boucle de l’agent
Comprendre ce qui se passe entre la réponse du modèle et le résultat d’un outil.
ArticleCe qu’un contrôle établit
Distinguer un contrôle réussi d’une décision de merge ou de mise en production.
ArticleSuivre le travail jusqu’à son utilisation
Suivre le travail au-delà du code généré, jusqu’au résultat utilisable.
Illustration générée à partir de la référence du brandbook. Animation adaptée de l’étude d’atelier V9.
Votre équipe, vos contraintes