Measured Academy Measured Academy
English Pilote Progression 0

Module 2 · Test pratique

Réduire la chaîne, puis rédiger le registre de décisions

Vous l’exécutez sur votre propre machine avec votre propre clé d’API. Rien de ce que vous exécutez n’est envoyé à ce site.

Obtenir les fichiers

Tout ce que ce test vous demande d’exécuter tient dans un seul téléchargement, organisé exactement comme dans le dépôt compagnon : chaque commande des étapes fonctionne depuis le dossier décompressé.

Télécharger la trousse du module 2 (zip, 9 fichiers)

  • ch02-stack/ch2_course_collapse.py
  • ch02-stack/ch2_course_check.py
  • ch02-stack/ch2_collapse.py
  • ch02-stack/run-2026-09-07.txt
  • ch02-stack/run-2026-09-07.jsonl
  • ch02-stack/course-run-2026-11-20.txt
  • ch02-stack/course-run-2026-11-20.jsonl
  • ch02-stack/course-prediction-2026-11-20.json
  • ch02-stack/course-check-2026-11-20.txt

Décompressez-la, ouvrez un terminal dans module-2-kit, créez un environnement virtuel Python 3.12 et installez ce dont les modules 1 à 4 ont besoin :

pip install anthropic==1.2.0 pydantic==2.13.5

Ces deux versions épinglées sont lues dans le requirements.txt de la trousse, qui liste aussi des paquets utilisés seulement par les modules suivants. Le dépôt compagnon n’est pas encore ouvert aux apprenants du pilote : utilisez ce téléchargement partout où les étapes disent « dépôt compagnon ».

Essayez la vérification avant de dépenser quoi que ce soit. Cette commande l’exécute sur l’exécution enregistrée du cours et n’a besoin d’aucune clé :

python ch02-stack/ch2_course_check.py --run ch02-stack/course-run-2026-11-20.jsonl --prediction ch02-stack/course-prediction-2026-11-20.json --part a

Elle devrait afficher Module 2 check: PASS (Part A only). C’est le résultat du cours, pas le vôtre : ne l’inscrivez pas plus bas.

Ce que vous allez faire

Deux parties, vérifiées toutes deux par un seul script.

Partie A, une exécution. Acheminer les 10 billets du chapitre avec la chaîne de trois appels fournie et avec un appel unique, face à un corrigé que vous écrivez d’abord, à l’aide du banc d’essai du cours. Prédisez les deux notes avant d’exécuter.

Partie B, un registre de décisions. Choisir une pile technologique pour le scénario ci-dessous et noter, pour chaque élément, pourquoi vous l’utilisez maintenant ou ce qui vous amènerait à l’ajouter.

Ce cours s’adresse aux personnes de 18 ans ou plus.

Coût

Vous utilisez votre propre clé d’API ; c’est donc vous qui payez cette exécution.

Élément Exécution du cours, claude-opus-5 Exécution du livre, claude-opus-4-6
Appels 40 (30 pour la chaîne, 10 pour l’appel unique) 40
Jetons d’entrée 8,142 2,599
Jetons de sortie 9,058, dont 3,369 de réflexion 799
Coût de cette exécution $0.27 $0.03
Source BOOK.md, constats mesurés ; runs/ch2-course-collapse-2026-11-20.txt COST.md, ligne Ch 2 ; runs/ch2-collapse-2026-09-07.txt

Attendez-vous à un montant proche de celui de l’exécution du cours si vous utilisez un modèle actuel. Le vôtre dépend du modèle choisi et des prix du jour. La partie B ne coûte rien.

Étapes

Travaillez à partir de la trousse décompressée (elle contient les mêmes fichiers que le dossier ch02-stack/ du dépôt compagnon), depuis son dossier principal. Vos fichiers vont dans ch02-stack/out/.

Partie A

  1. Lisez les dix billets et les quatre files de l’exercice du chapitre. N’ouvrez pas encore ch2_collapse.py ni ch2_course_collapse.py : les deux contiennent le corrigé de l’auteur et sa requête d’appel unique.
  2. Écrivez votre corrigé, une file par billet dans l’ordre du chapitre, et prédisez combien de billets chaque version fera concorder exactement. Le banc d’essai les enregistre avec l’heure, avant tout appel :

    python ch02-stack/ch2_course_collapse.py predict --chain <0-10> --single <0-10> --key billing,billing,...
    

    Ne laissez tomber --key que si vous voulez utiliser le corrigé de l’auteur.

  3. Exécutez-le avec votre propre clé et un identifiant de modèle actuel :

    python ch02-stack/ch2_course_collapse.py run --model <model id>
    

    Il fait les trente appels de la chaîne et les dix appels uniques du chapitre, lit le premier bloc de texte de chaque réponse (module 1, leçon 2), journalise les jetons de réflexion, et s’arrête s’il atteint sa limite d’appels ou de jetons. Il écrit ch02-stack/out/run.jsonl.

  4. Ouvrez maintenant le banc d’essai et comparez votre corrigé à celui de l’auteur. Contestez une ligne, pas un total. Comparez ensuite votre exécution à celle du cours dans ch02-stack/course-run-2026-11-20.txt, billet par billet.

  5. Facultatif, pour une deuxième exécution : copiez le banc d’essai, remplacez SINGLE_PROMPT par une requête que vous écrivez (les quatre noms de file, une ligne sur ce dont chacune s’occupe, une consigne de répondre par un seul mot), et exécutez votre copie. C’est l’exercice tel que le chapitre le propose.

Partie B

Scénario : une équipe de quatre personnes gère un centre d’assistance interne. Elle veut un outil qui lit chaque billet entrant, l’achemine vers l’une de quatre files et rédige une première réponse qu’une personne révisera. Le volume est de quelques centaines de billets par jour. Rien n’est envoyé sans l’approbation d’une personne. Il existe un wiki de procédures que les brouillons pourraient citer plus tard, mais il n’est pas à jour et personne n’a encore demandé de citations.

Écrivez ch02-stack/out/stack-decision.md, qui contient un tableau Markdown avec exactement ces colonnes :

| Component | Decision | Reason or trigger |
| --- | --- | --- |
| Provider SDK | use | ... |
| Agent framework | defer | ... |
  • Au moins quatre lignes.
  • Decision vaut use ou defer.
  • Une ligne use donne l’exigence actuelle qui a besoin de l’élément.
  • Une ligne defer donne un déclencheur : quelque chose d’observable qui devrait se produire, deux fois, avant que vous l’ajoutiez.
  • Les en-têtes et les mots use et defer restent en anglais, parce que le script les lit tels quels ; les noms des composants et les raisons peuvent être en français.

Vérification

Cette étape n’a besoin ni de clé ni de réseau :

python ch02-stack/ch2_course_check.py

Réussi quand

ch2_course_check.py affiche Module 2 check: PASS et se termine avec le code 0, et vous pouvez cocher chaque ligne de la liste de vérification. Le script réussit quelle que soit la note. Il vérifie que :

  • le fichier d’exécution a son en-tête et chaque enregistrement d’appel avec tous ses champs ;
  • les deux versions ont tourné sur les dix billets : trois étapes de chaîne et un appel unique par billet ;
  • les billets et les files sont ceux du module, sur un seul modèle, et le corrigé de l’exécution est celui de votre prédiction ;
  • les notes de l’en-tête se recalculent à partir des enregistrements d’appel, donc le fichier n’a pas été modifié ;
  • la consommation de jetons est journalisée pour chaque appel, aucune réponse n’est vide et aucune ne s’est arrêtée sur max_tokens ;
  • vos prédictions sont des nombres entiers dans l’intervalle et datées d’avant votre premier appel ;
  • votre registre de décisions contient le tableau, au moins quatre lignes, une décision valide sur chacune, au moins un defer, et une raison ou un déclencheur sur chaque ligne.

Liste de vérification, que vous jugez vous-même jusqu’à ce que Measured Lab la note :

Marquez ensuite le module comme terminé.

Si la vérification échoue

Le script énumère chaque problème avec le numéro de la vérification qui l’a détecté. Ne modifiez pas run.jsonl ; refaites l’étape qui l’a produit.

Le message commence par Ce que ça veut dire Quoi faire
Can't check yet Un fichier manque ou n’est pas du JSON valide (code de sortie 2) Faites les étapes de prédiction et d’exécution, et écrivez stack-decision.md, le tout dans ch02-stack/out/
Expected ... calls Une version n’a pas tourné sur chaque billet, ou le banc d’essai s’est arrêté à une limite Relancez le banc d’essai
key in the run differs Vous avez changé votre corrigé après la prédiction Prédisez de nouveau avec le corrigé que vous allez exécuter, puis exécutez de nouveau
doesn't recompute L’en-tête et les enregistrements d’appel ne concordent pas Relancez ; ne modifiez pas le fichier
the answer is empty ou stopped on 'max_tokens' Le modèle a dépensé le budget à réfléchir Relancez avec un plus grand budget, par exemple run --model <id> --max-tokens 2048
Decision record Le tableau manque, est trop court, ou a une ligne sans raison Corrigez stack-decision.md et relancez la vérification

Deux exécutions enregistrées auxquelles comparer la vôtre, toutes deux faites avec la clé de l’auteur. L’exécution du livre sur claude-opus-4-6 a donné à la chaîne 4 sur 10 en correspondance exacte et 9 sur 10 en lettres seulement, et à l’appel unique 10 sur 10 (runs/ch2-collapse-2026-09-07.txt). L’exécution du cours sur claude-opus-5 a donné à la chaîne 8 sur 10 en correspondance exacte et 9 sur 10 en lettres seulement, et à l’appel unique 10 sur 10 (runs/ch2-course-collapse-2026-11-20.txt). La vôtre sera différente. Dites en quoi, et pourquoi selon vous.

Inscrire votre résultat

Exécutez ch2_course_check.py sur votre machine, puis collez tout ce qu’il a affiché. La page lit la première ligne (Module 2 check: PASS ou FAIL) et garde le résultat dans ce navigateur. Ne collez pas de clé d’API ; le script n’en affiche jamais.

Aucun résultat inscrit pour l’instant.