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.pych02-stack/ch2_course_check.pych02-stack/ch2_collapse.pych02-stack/run-2026-09-07.txtch02-stack/run-2026-09-07.jsonlch02-stack/course-run-2026-11-20.txtch02-stack/course-run-2026-11-20.jsonlch02-stack/course-prediction-2026-11-20.jsonch02-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
- Lisez les dix billets et les quatre files de l’exercice du chapitre. N’ouvrez pas encore
ch2_collapse.pynich2_course_collapse.py: les deux contiennent le corrigé de l’auteur et sa requête d’appel unique. -
É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
--keyque si vous voulez utiliser le corrigé de l’auteur. -
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. -
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. - Facultatif, pour une deuxième exécution : copiez le banc d’essai, remplacez
SINGLE_PROMPTpar 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.
Decisionvautuseoudefer.- Une ligne
usedonne l’exigence actuelle qui a besoin de l’élément. - Une ligne
deferdonne 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
useetdeferrestent 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.