Un agent combine un modèle qui répond et une couche qui orchestre. Le harness organise ce qui entre dans le contexte, ce que l’agent peut appeler, ce qui est contrôlé et ce qui met fin à la boucle.
À retenir avant de commencer
Le mot harness apparaît dès qu’un agent dépasse la simple réponse textuelle. Il désigne la couche qui fait tourner le modèle, lui fournit le contexte, exécute ses appels d’outils, applique des contrôles et décide quand la boucle doit s’arrêter.
Le terme désigne l’environnement de travail qui transforme une capacité de raisonnement en comportement exploitable, au-delà du modèle et du simple prompt.
Le harness : la couche qui orchestre le modèle
Un modèle produit une sortie à partir d’un contexte. Le monde extérieur lui échappe : réussite réelle d’un appel d’outil, validité d’une permission, risque de doublon, moment où rendre la main : tout cela vit dans la couche qui l’entoure.
Un agent ajoute une intention, des outils et une boucle. Le harness organise cette boucle.
OpenAI décrit le harness de Codex comme la logique centrale qui orchestre les échanges entre l’utilisateur, le modèle et les outils. Quand le modèle demande un appel, le harness exécute l’outil, ajoute son résultat au contexte, puis relance le modèle jusqu’à une réponse finale ou une reprise de contrôle. [12]
interprète et propose à partir de ce qu’il voit.
lit ou agit dans un système avec un contrat défini.
oriente la boucle, contrôle les appels et rend la main.
Les pièces qui rendent la boucle pilotable
Un harness utile reste compact et rend visibles les décisions qui, sinon, resteraient cachées dans une suite d’appels.
Interaction-signature
L’anatomie d’une boucle agentique
Ce qui entre dans la boucle
Instructions, demande, sources et résultats utiles, sélectionnés pour la tâche plutôt que déversés en bloc.
Quelle information a réellement influencé la décision ?
Ouvre chaque couche : un harness fiable rend chaque décision visible.
Le contexte regroupe les instructions, les informations de la tâche, l’historique utile, les résultats d’outils et les règles applicables. Les outils sont les capacités exposées. Les contrôles vérifient les paramètres, les permissions et les conditions d’arrêt. La trace permet enfin de reconstruire le parcours.
Un agent possède au minimum un modèle, des outils et des instructions. OpenAI recommande de leur ajouter des garde-fous, des conditions de sortie et une évaluation qui vérifie le comportement au-delà de la réponse finale. [13]
Une boucle agentique dans le monde réel
Prenons une demande simple : « Prépare la réponse au client Martin à partir de son dossier. » Le harness peut organiser ce parcours :
- Recevoir la demande et vérifier son identité.
- Construire un contexte limité : dossier actif, dernier échange, modèle de réponse et règles de ton.
- Appeler un outil de lecture du CRM avec un identifiant et des champs autorisés.
- Renvoyer le résultat au modèle en distinguant faits, absences et erreurs.
- Préparer un brouillon sans l’envoyer.
- Contrôler la sortie : destinataire, données sensibles, promesse et action demandée.
- Rendre la main pour validation, ou arrêter dès qu’une condition d’arrêt se déclenche.
Une boucle s’arrête sur une condition écrite ; elle continue rarement juste parce que le modèle sait encore produire du texte. OpenAI décrit des conditions de fin comme une sortie finale, l’absence de nouvel appel d’outil, une erreur ou un nombre maximal de tours atteint. [13]
Ce qui doit rester borné
Les tours
Fixe un plafond de tours adapté aux essais de la tâche. Dix tours peuvent servir de point de départ pour un test, sans constituer une règle universelle. Au plafond, rends la main avec un diagnostic.
Le contexte
Charge le signal utile au moment nécessaire. Tout envoyer par défaut noie la décision.
Les outils
Expose une petite liste nommée et testée. Un outil universel est difficile à expliquer et à contrôler.
Les reprises
Vérifie le type d’erreur avant de réessayer. Une création ou un envoi exige un mécanisme contre les doublons pris en charge par l’outil ; si le résultat est incertain, vérifie son statut avant toute reprise.
Anthropic recommande de garder le contexte informatif mais resserré, de limiter les outils redondants et de charger progressivement les informations nécessaires à la tâche. [15]
Ces règles s’ajoutent aux contrôles d’authentification et d’autorisation existants. [13]
Construire le premier harness sans usine à gaz
Pour une TPE ou une PME, commence par un seul workflow et une boucle lisible :
- un objectif métier bien défini ;
- trois outils au maximum pour le premier pilote ;
- un contexte documenté et limité ;
- une condition d’arrêt explicite ;
- une validation avant l’action externe ;
- un journal de chaque appel ;
- quelques scénarios d’échec réellement testés.
OpenAI recommande de commencer par un agent unique lorsque cela suffit, puis de répartir le travail seulement lorsque la logique, les outils ou l’évaluation deviennent réellement trop complexes. [13]
Le harness peut être une petite couche de code, un workflow contrôlé ou une combinaison d’outils existants. Ce qui compte, c’est que les limites soient écrites quelque part, exécutables et observables. OpenAI décrit cette discipline comme un investissement dans l’environnement, les boucles de retour et les contrôles qui permettent aux agents de produire un travail fiable. [11]
NIST organise la gestion des risques IA autour de quatre fonctions : gouverner, cartographier, mesurer et gérer. Pour un harness, cela se traduit par des responsabilités nommées, un périmètre explicite, des cas de test et une décision claire lorsque le comportement sort du niveau acceptable. [16]
Le résumé utile
Le modèle est une pièce parmi d’autres : le harness organise l’exécution autour de lui.
Une boucle fiable sélectionne le contexte, contrôle les outils et connaît ses conditions de fin.
Les permissions, les reprises et les traces font partie du produit dès le départ.
Le bon niveau d’autonomie est celui que l’équipe peut tester, expliquer et interrompre.
Un agent limité à une question peut se passer d’un harness complet. Dès qu’il lit plusieurs sources, appelle des outils, réessaie, prépare une action ou enchaîne les étapes, cette couche existe déjà, même si personne ne l’a encore nommée.