Harness engineering : comment construire un agent IA fiable
Articles : 8
Le harness engineering est la discipline qui consiste à construire, autour d'un modèle de langage, un environnement dans lequel un agent IA accomplit de façon fiable un travail réel. La formule du sujet : Agent = Modèle + Harnais. Le même modèle se comporte comme un développeur expérimenté dans un projet, mais perd le contexte dans un autre et annonce une fonctionnalité cassée comme prête. La différence tient presque toujours au harnais, et non au modèle.
Ce guide est une carte du sujet. Il rassemble les notions clés et l'ordre dans lequel il est commode de les découvrir. Chaque thème est traité en détail dans un article distinct.
Les cinq sous-systèmes du harnais
- Instructions — fichiers CLAUDE.md et AGENTS.md, documents thématiques et skills : ce que l'agent sait du projet.
- Outils — shell, modification de fichiers, navigateur, serveurs MCP : comment l'agent agit.
- Environnement — bac à sable, conteneur, copie de travail isolée : l'endroit où l'agent exécute ses commandes.
- État — fichiers de plan et d'avancement, historique git : la mémoire entre les sessions.
- Retour d'information — tests, linters, hooks, vérificateur indépendant : comment l'agent apprend ses erreurs.
Les sous-systèmes forment une boucle fermée. Si l'on en retire un, la boucle se rompt : sans vérifications, l'agent ne voit pas ses erreurs ; sans état, chaque session repart de zéro.
Par où commencer
Si le sujet vous est nouveau, commencez par l'article sur ce qu'est le harness engineering et sur sa différence avec le prompt et le context engineering. Une définition courte accompagnée d'un exemple se trouve dans l'article sur le harnais d'un agent.
Passez ensuite à la pratique. Le premier fichier auquel chacun se heurte est celui des instructions du projet : que mettre dans CLAUDE.md et AGENTS.md, ce qu'il ne faut pas y mettre, et pourquoi l'agent ignore une règle pourtant écrite noir sur blanc dans le fichier.
Une fois que l'agent travaille déjà dans le projet, la question de la fiabilité se pose. Un plan pas à pas mène du journal des échecs et des indicateurs MTBF et MTTR, en passant par le retour arrière peu coûteux, les boucles de retour et la mémoire dans des fichiers, jusqu'à la boucle autonome dans laquelle l'agent travaille des heures sans supervision.
Principes fondamentaux
- L'agent n'est pas défectueux, c'est l'environnement qui l'est. Cherchez d'abord la faille dans le harnais, et non un autre modèle.
- Commencez par le retour d'information : une commande de vérification apporte plus qu'une page d'instructions.
- Les instructions sont une carte, non un manuel : un fichier d'entrée court et des détails à la demande.
- Ce qui compte vit dans des fichiers, non dans la fenêtre de contexte.
- Mesurez : un journal des échecs plutôt que des impressions.
Tous les sous-systèmes, ainsi que l'assemblage complet du harnais, sont traités en pratique dans le cours sur le harness engineering.