Measured Academy Measured Academy
English Pilote Progression 0

Module 4 · Leçon 1 sur 4

La boucle, dessinée une fois

  1. Ce qui s’est passéSix questions sont passées par un même agent à deux outils et ont demandé des nombres différents d’appels au modèle, d’un seul appel à plusieurs, sans aucun changement au code entre elles.
  2. Pourquoi ça a changéDans un agent, le modèle demande un outil, votre code l’exécute et renvoie le résultat ; le nombre d’allers-retours est donc décidé par la question à l’exécution, pas par le fichier source.
  3. Comment on le mesureChaque appel au modèle compte comme une étape, et la raison d’arrêt ainsi que le nom et l’entrée de chaque demande d’outil sont journalisés à chaque étape.
  4. Comment l’améliorerParcourir chaque bloc de contenu, renvoyer le tour de l’assistant sans le modifier, garder la liste des messages, et afficher la trace avant d’en avoir besoin.
Pas à pas

Une question, étape par étape

Essayez. Choisissez l’une des six questions et appuyez sur « Étape suivante » pour suivre la boucle un appel au modèle à la fois.

D’où viennent ces données · claude-opus-4-6, 2026-08-28; claude-opus-5, 2026-11-20

Lu dans les enregistrements du livre. Rien ici n’est simulé. Les requêtes, les billets, les réponses des modèles et les messages d’erreur restent en anglais, tels qu’ils ont été envoyés et reçus.

  • BOOK.md Measured findings
  • chapters/chapter-04-your-first-agent.md "How you verify"
  • scripts/ch03_trace.py
  • runs/ch4-course-agent-2026-11-20-run3.jsonl

Les nombres d’étapes et les demandes d’outil proviennent du tableau de résultats du chapitre. La sortie de l’exécution n’a pas été conservée ; chaque résultat affiché est donc recalculé en exécutant le code de l’outil lui-même, tiré de scripts/ch03_trace.py, sur l’entrée enregistrée.

Ce qui s’est passé

On a donné à un petit agent deux outils, une recherche dans le stock et une calculatrice, et six questions sur un inventaire de quatre articles. Le même code a traité les six. Le nombre d’appels au modèle a différé presque à chaque fois.

Dans l’ordre, les six questions ont demandé 2, 2, 3, 2, 4, 1 étapes dans l’exécution du livre (BOOK.md, constats mesurés, claude-opus-4-6, 2026-08-28), et 2, 1, 3, 2, 3, 1 dans l’exécution réussie du cours sur un modèle actuel (runs/ch4-course-check-2026-11-20-run3.txt, claude-opus-5, 2026-11-20).

Question Exécution du livre, claude-opus-4-6 Étapes Exécution du cours, claude-opus-5
Combien de casques d’écoute sont en stock ? une recherche la première de chaque liste ci-dessus une recherche
Combien font douze fois quarante-cinq ? la calculatrice 2 dans l’exécution du livre aucun outil : réponse en une étape
Que valent les webcams en stock ? une recherche, puis la calculatrice 3 dans les deux une recherche, puis la calculatrice
Plus de claviers ou de casques ? deux recherches dans une seule réponse 2 dans les deux deux recherches dans une seule réponse
Combien coûterait de ramener les souris à dix unités ? une recherche ratée, une deuxième recherche, la calculatrice 4 dans l’exécution du livre une recherche de « mouse », puis la calculatrice
Une bonne politique de réapprovisionnement pour les articles lents ? aucun 1 dans les deux aucun

Les deux exécutions divergent sur deux questions, et le code était le même. Utilisez la bascule « Exécution enregistrée » du visuel pas à pas ci-dessus pour parcourir l’une ou l’autre ; dans l’exécution du cours, les réponses sont les mots du modèle lui-même, lus dans le fichier d’exécution.

Une chose à savoir sur la colonne du livre : la sortie de cette exécution n’a pas été conservée. Ses chiffres survivent sous forme de lignes dans BOOK.md. Le fichier de l’exécution du cours contient chaque demande, chaque résultat et chaque réponse. La leçon 4 revient sur ce qui soutient chacun.

Pourquoi ça a changé

Au module 2, vous avez tracé la ligne entre une chaîne et un agent : dans une chaîne, c’est vous qui écrivez l’ordre des appels ; dans un agent, c’est le modèle qui choisit l’étape suivante. Voici à quoi ça ressemble dans le code.

Un appel qui utilise des outils comporte quatre gestes :

  1. Vous déclarez les outils. Chacun a un nom, une description et un schéma pour son entrée.
  2. Le modèle demande. Quand il veut un outil, la raison d’arrêt de la réponse est tool_use et son contenu comporte un ou plusieurs blocs de demande, chacun avec un identifiant, un nom d’outil et une entrée déjà analysée.
  3. Votre code décide. Le modèle n’exécute rien. Il émet une demande, et votre code choisit s’il l’exécute et comment.
  4. Le résultat revient. Vous ajoutez le tour du modèle à la liste des messages sans le modifier, puis un tour utilisateur qui contient un résultat pour chaque demande, apparié par identifiant.

Puis vous appelez de nouveau. La boucle se termine quand revient une réponse qui n’est pas une demande d’outil.

Chaîne (module 2) Agent (ce module)
Qui choisit l’appel suivant vous, dans le code source le modèle, dans sa réponse
Nombre d’appels fixe, lisible dans le fichier varie selon la question
Où la séquence est écrite dans le code seulement dans la liste des messages d’une exécution

Cette dernière ligne est la conséquence pratique. Vous ne pouvez pas lire dans le fichier ce que l’agent a fait. Parcourez une question dans la visionneuse ci-dessus et regardez la liste des messages s’allonger : cette liste est le seul enregistrement de l’ordre dans lequel les choses se sont passées.

Comment on le mesure

  • Une étape, c’est un appel au modèle. Comptez chaque appel au modèle, y compris le dernier, celui qui renvoie la réponse. Une question à laquelle le modèle répond directement compte pour une étape.
  • La raison d’arrêt, à chaque étape. C’est la variable de contrôle de la boucle : tool_use veut dire refaire un tour, end_turn veut dire que le modèle se considère comme ayant terminé.
  • Le nom de l’outil et l’entrée complète, à chaque demande. Le nom vous dit quel outil. L’entrée vous dit ce qui a été demandé, et la leçon 3 montre une nouvelle tentative qu’on ne voit que dans les entrées.
  • Quel genre de preuve c’est. Une exécution de six requêtes sur chacun de deux modèles. Les mécanismes de la liste ci-dessus (la forme des blocs de demande et de résultat) sont des lignes distinctes de BOOK.md, confirmées sur SDK 1.2.0.

Comment l’améliorer

  • Parcourez la liste du contenu. Ne l’indexez jamais. Une réponse peut contenir plus d’un bloc, comme le montre la leçon 4.
  • Renvoyez le tour de l’assistant tel qu’il est arrivé. Le SDK accepte le contenu de la réponse sans modification ; le reconstruire à la main, c’est là que des blocs se perdent.
  • Aiguillez selon le nom de l’outil au moyen d’un dictionnaire de fonctions, pour qu’ajouter un outil tienne en une entrée.
  • Gardez la liste des messages. C’est la trace. Affichez-la avant d’avoir une mauvaise réponse à expliquer.
  • Traitez la description comme une partie de la requête. C’est elle qui dit surtout au modèle quand un outil s’applique. Le module 10 mesure jusqu’où ça va.

Les quatre gestes et la boucle sont imprimés au chapitre 4 du livre, « The concept » et « Before / After ». Suite : deux sorties et un plafond.

Chaque nombre de cette leçon et le fichier d’où il vient (7)
ValeurFichier dans les enregistrements du livreConditions
2, 2, 3, 2, 4, 1BOOK.mdclaude-opus-4-6, SDK 1.2.0, 2026-08-28, une exécution, MAX_STEPS = 5 ; la sortie n’a pas été conservée
2, 1, 3, 2, 3, 1runs/ch4-course-check-2026-11-20-run3.txtclaude-opus-5, 2026-11-20, troisième tentative, vérification PASS
2BOOK.md
3BOOK.md
2BOOK.md
4BOOK.md
1BOOK.md

Référence : Chapitre 4, « The concept », la description du diagramme d’architecture et « Before / After ».