Aperçu moduleModule previewVista previa del módulo
Aperçu limité, 3 premières étapesLimited overview, first 3 stepsVisibilidad limitada, 3 primeras etapas

Le harnais intégréThe integrated harnessEl harness integrado

Parcours : Construire un agent de code, le harnais · OpérationnelCourse: Building a Coding Agent: the Harness · PractitionerCurso: Construir un agente de código: el harness · Operativo

Le harnais intégré
1/7
ÉtapeStepEtapa 1 / 7

≈ 9 min

Le problème

Le problème : des mécanismes testés un à un ne font pas encore un programme ; réunis, ils se gênent si l’ordre, l’accès au modèle, le départ des tours et la sortie ne sont pas réglés.

Au programme de ce moduleIn this moduleEn el programa de este módulo

  1. 01Le problème≈ 9 min
  2. 02L’intuition≈ 8 min
  3. 03Le mécanisme≈ 9 min
  4. 04Le code, pas à pas≈ 10 min
  5. 05Pièges & pratiques≈ 10 min
  6. 06Exercice≈ 6 min
  7. 07Quiz≈ 5 min
Durée totaleTotal durationDuración total≈ 57 min
voix de synthèse

Objectifs d’apprentissage

À la fin de ce module, vous saurez faire de vos mécanismes un seul programme, qui tient une journée de travail sans se bloquer ni perdre le fil. Voici les acquis visés.

  • Situer chaque mécanisme des modules précédents dans un tour, et justifier leur ordre ;
  • Faire passer tous les appels au modèle par une seule porte, qui traite les erreurs passagères, le contexte trop long et les appels d’outil coupés ;
  • Démarrer un tour sans demande quand un résultat ou un message arrive, un seul tour à la fois, sans jamais questionner l’utilisateur depuis un fil ;
  • Quitter proprement : plus de nouveau tour, des coéquipiers arrêtés, et rien qui disparaisse en silence.

Sources

Curriculum open-source shareAI-lab/learn-claude-code, chapitre s15 (Integrated Harness), publié sous licence MIT, © shareAI-lab, adaptation Getul. La notice de licence est reproduite sur la page Sources et références. Documentation publique de Claude Code (Anthropic) sur son fonctionnement et ses erreurs, et documentation de l’API et du SDK Python d’Anthropic, citées pour comparer avec un outil en production. Le motif présenté est indépendant du fournisseur : il vaut pour toute API offrant l’appel d’outils.

Tout marche, séparément

Depuis le module 1, chaque mécanisme a été ajouté et testé à part : permissions, hooks, plan, sous-agents, compétences, compaction, mémoire, tâches, arrière-plan, planification, équipes, MCP. Chacun a son code, son test, sa place. Lancés ensemble pendant une journée de travail, ils posent des questions qu’aucun module ne tranchait seul :

  • un appel au modèle reçoit une erreur 529, l’API est surchargée : le programme entier s’arrête-t-il ?
  • la réponse est coupée au milieu d’un appel d’outil : que faire d’un appel incomplet ?
  • une commande en arrière-plan se termine pendant que vous lisez : qui la traite, et quand ?
  • un tour planifié échoue : la planification s’arrête-t-elle pour de bon ?
  • vous quittez : que deviennent les coéquipiers et les commandes en cours ?

Pour comprendre : ce que fait Claude Code

La documentation de Claude Code décrit sa boucle en trois phases qui s’enchaînent : rassembler le contexte, agir, vérifier le résultat. Elle précise que Claude Code est la couche qui entoure le modèle, lui fournit ses outils et gère le contexte qu’il voit, et que c’est cette couche que désigne le terme de harnais agentique. C’est ce que vous construisez depuis le module 1.

Vérifiez votre compréhensionCheck your understandingVerifique su comprensión

Pourquoi un module entier pour réunir des mécanismes déjà testés ?

À retenir

Des mécanismes testés un à un ne font pas encore un programme : il faut un ordre dans le tour, une seule porte vers le modèle, un seul tour à la fois quelle que soit sa source, et une sortie propre.