Harnais d'agent IA : ce que c'est et de quoi il se compose

Définition

Le harnais d'un agent (agent harness) est l'enveloppe logicielle qui entoure le modèle de langage : tout ce qui n'est pas le modèle lui-même mais qui influe sur la façon dont l'agent travaille. La formule est Agent = Modèle + Harnais. Le modèle sait raisonner et écrire du code ; le harnais décide de ce qu'il voit, des actions qu'il peut accomplir, de l'endroit où s'exécutent les commandes, de ce qui est conservé entre les sessions et de la manière dont l'agent apprend ses erreurs.

Cinq composants du harnais

• Instructions — le prompt système et les fichiers de projet comme CLAUDE.md et AGENTS.md, les documents thématiques et les skills.
• Outils — l'exécution de commandes shell, la modification de fichiers, un navigateur, les connexions par MCP.
• Environnement — un bac à sable ou un conteneur dans lequel l'agent exécute du code sans risque pour la production.
• État — les fichiers de plan et d'avancement, l'historique git : une mémoire qui survit à la fermeture de la session.
• Retour d'information — tests, linters, vérification de types, hooks qui renvoient à l'agent un signal d'erreur.

Le harnais n'est pas un simple fichier de prompt. Un AGENTS.md très long ne sert à rien si l'agent n'a pas accès aux tests ou si l'environnement ne démarre pas. La fiabilité est déterminée par le plus faible des cinq composants.

Exemple

Pour la troisième session d'affilée, l'agent corrige le même bug : après chaque redémarrage, il ne se souvient pas de ce qu'il a déjà tenté. On croit que le modèle est en cause. En réalité, c'est le sous-système d'état qui est défaillant. La solution est un fichier PROGRESS.md dans lequel l'agent consigne, à la fin de chaque session, les hypothèses qui n'ont pas fonctionné et la prochaine étape :

## Bug : double débit lors de la nouvelle tentative d'une requête
Vérifié et écarté :
- timeout du client HTTP — sans effet
- course dans le gestionnaire de webhook — reproduction impossible
Prochaine étape : vérifier la clé d'idempotence dans payments/service.py

Une nouvelle session lit le fichier et reprend immédiatement au bon endroit. Le modèle n'a pas changé : c'est le harnais qui a changé.

Synthèse

Le harnais d'un agent, ce sont les instructions, les outils, l'environnement, l'état et le retour d'information autour du modèle. C'est lui qui détermine si le même agent travaille de façon fiable ou s'il dysfonctionne. La manière de construire chacun de ces composants est traitée en pratique dans le cours sur le harness engineering.