Module 3 · Leçon 1 sur 4
L’exécution qui n’a pas planté
- Ce qui s’est passéLe routeur non typé a renvoyé un nom de file propre pour chaque billet ; l’échec autour duquel ce module avait été prévu ne s’est donc jamais produit, et le routeur typé a choisi la même file pour chaque billet.
- Pourquoi ça a changéRien n’a changé dans l’acheminement ; les mauvaises formes vues au module 2 venaient de la chaîne de trois appels, pas de la requête à un seul appel, et le typage change ce que le retour a le droit d’être, pas ce que le modèle décide.
- Comment on le mesureChaque retour non typé est testé pour son appartenance exacte à la liste des files, sans nettoyage ; chaque appel typé est compté comme ayant renvoyé une valeur ou levé une exception, et les deux sont comparés billet par billet.
- Comment l’améliorerTyper le retour pour la garantie, présenter une exécution sans faute comme sans faute, et ne jamais transformer dix échantillons en taux.
Dix billets, deux types de retour
Essayez. Choisissez un billet, ou regardez les dix. Cochez ensuite « Qu’est-ce que ça aurait pu être ? » pour voir ce que chaque type de retour permet.
D’où viennent ces données · claude-opus-4-6, 2026-10-14; 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.
runs/ch3-router-typed-2026-10-14.jsonlscripts/ch3_route_typed.pyruns/ch2-collapse-2026-09-07.jsonlruns/ch3-course-route-typed-2026-11-20.jsonl
Ce qui s’est passé
Le module 2 se terminait sur une promesse : remplacer « répondez par un seul mot » par un retour qui ne peut pas être un nom de file en gras. Ce module avait été prévu pour montrer d’abord le routeur non typé en train de planter.
Il n’a pas planté. Le routeur du chapitre 1, sans changement, a été exécuté sur les dix billets du module 2 avec claude-opus-4-6. Puis le même routeur a été typé et exécuté de nouveau.
Exécution du livre, claude-opus-4-6 |
Exécution du cours, claude-opus-5 |
|
|---|---|---|
| Retour non typé utilisable comme clé de dictionnaire | 10 sur 10 | 10 sur 10 |
| Appels typés qui ont renvoyé une file | 10 sur 10 | 10 sur 10 |
| Appels typés qui ont levé une exception | 0 sur 10 | 0 sur 10 |
| Billets où les deux versions ont choisi la même file | 10 sur 10 | 9 sur 10 |
Sources : runs/ch3-router-typed-2026-10-14.txt et les constats mesurés de BOOK.md pour l’exécution du livre, faite d’abord le 2026-09-14 et répétée le 2026-10-14 avec les mêmes résultats ; runs/ch3-course-route-typed-2026-11-20.txt pour l’exécution du même exercice par le cours sur un modèle actuel, faite avec le banc d’essai du cours.
Il n’y a donc pas d’avant-après spectaculaire ici. Le titre honnête : les deux versions ont fonctionné sur les deux modèles. Sur l’ancien modèle, elles se sont entendues sur chaque billet. Sur le nouveau, elles ont divergé sur un seul : le billet 10, l’équipe qui ne voit pas un dossier partagé, est allé à auth en non typé et à bug en typé. Basculez la comparaison ci-dessus vers l’exécution du cours pour le voir.
Pourquoi ça a changé
Ça vaut la peine de se demander pourquoi le plantage ne s’est pas produit, puisque le module 2 a montré bien des retours brisés.
Ils venaient d’ailleurs. Dans l’exécution du module 2, 6 sur 10 des retours de la chaîne n’étaient pas un nom de file, contre 0 sur 10 pour l’appel unique (runs/ch2-collapse-2026-09-07.txt). Les retours décorés étaient produits par un dernier appel à qui on avait remis un paragraphe de la prose mise en forme du modèle lui-même. Une courte requête qui demande un seul mot, sur ce modèle, n’en a pas produit.
Ce que le typage a changé n’apparaît pas du tout dans les notes. Comparez les deux signatures :
| Non typé | Typé | |
|---|---|---|
| La signature promet | une chaîne quelconque | l’une de quatre chaînes nommées |
| Si le modèle écrit une phrase | l’appelant reçoit la phrase | l’appel lève une exception avant que quoi que ce soit soit renvoyé |
| Où vous l’apprenez | à la recherche dans le dictionnaire, ou plus tard | à l’appel |
Ouvrez la comparaison ci-dessus et cochez « Qu’est-ce que ça aurait pu être ? ». Les valeurs enregistrées restent les mêmes. Ce qui diffère, c’est l’ensemble des valeurs que chaque colonne avait le droit de contenir.
La divergence sur le billet 10 dans l’exécution du cours ne contredit pas ce point. Les deux routeurs ne font pas la même requête : le routeur typé retire « Reply with one word » et porte un schéma, et chaque appel est un tirage dans une distribution, comme le module 1 l’a mesuré. Un désaccord sur dix vous dit que les deux versions ne sont pas interchangeables pour ce billet. Il ne vous dit pas que le typage a dégradé l’acheminement, et les deux réponses diffèrent de toute façon du corrigé (leçon 4).
Comment on le mesure
Trois décomptes, que vous reproduirez chacun dans le test pratique :
- Propre sans nettoyage. Le retour non typé, débarrassé des espaces qui l’entourent et de rien d’autre, est ou n’est pas l’un des quatre noms de file. Pas de mise en minuscules, pas de retrait de ponctuation. C’est ce que vit un appelant qui indexe un dictionnaire.
- Renvoyé ou exception. Un appel typé a deux issues qui comptent ici : il a renvoyé une file, ou il a levé une exception. Une exception est comptée, pas cachée.
- Concordance. Pour chaque billet, les deux versions ont-elles choisi la même file ? Dans l’exécution du livre, ce décompte disait que le typage n’avait changé aucune décision. Dans l’exécution du cours, il a trouvé le seul billet où les deux versions diffèrent, et c’est exactement son rôle.
Une autre chose a été mesurée par accident : le plan. La première ébauche du chapitre affirmait que le routeur non typé échouerait sur ces billets. L’exécution a dit le contraire, et l’affirmation a été retirée (BOOK.md, l’entrée d’errata mise en file à partir de l’exécution du chapitre 3). Une prédiction sur laquelle on peut se tromper : voilà pourquoi le test à la fin de ce module vous fait écrire la vôtre d’abord.
Comment l’améliorer
- Typez le retour pour la garantie, pas pour la démonstration. Vous remplacez « faites-moi confiance » par « ceci, ou une exception ». Ça vaut la peine même un jour où rien ne plante.
- Présentez une exécution sans faute comme sans faute. On est tenté de chercher une requête qui échoue pour que la correction paraisse nécessaire. Ne le faites pas. Dites ce que l’exécution a montré.
- Ne transformez pas dix en taux. Dix retours propres sur un modèle à une date, ce sont dix retours propres. Ce n’est pas « cette requête est fiable ».
- Gardez la comparaison appariée. Les mêmes billets, le même modèle, la même formulation hormis la consigne que le type remplace.
Les deux versions du routeur sont imprimées au chapitre 3 du livre, « Before / After ». Suite : ce que coûte le schéma.
Chaque nombre de cette leçon et le fichier d’où il vient (10)
| Valeur | Fichier dans les enregistrements du livre | Conditions |
|---|---|---|
| 10 sur 10 | runs/ch3-router-typed-2026-10-14.txt | claude-opus-4-6, Python 3.12.3, 2026-10-14, une exécution |
| 10 sur 10 | runs/ch3-course-route-typed-2026-11-20.txt | claude-opus-5, 2026-11-20, une exécution |
| 10 sur 10 | runs/ch3-router-typed-2026-10-14.txt | claude-opus-4-6, Python 3.12.3, 2026-10-14, une exécution |
| 10 sur 10 | runs/ch3-course-route-typed-2026-11-20.txt | claude-opus-5, 2026-11-20, une exécution |
| 0 sur 10 | runs/ch3-router-typed-2026-10-14.txt | |
| 0 sur 10 | runs/ch3-course-route-typed-2026-11-20.txt | |
| 10 sur 10 | BOOK.md | |
| 9 sur 10 | runs/ch3-course-route-typed-2026-11-20.txt | claude-opus-5, 2026-11-20, une exécution |
| 6 sur 10 | runs/ch2-collapse-2026-09-07.txt | |
| 0 sur 10 | runs/ch2-collapse-2026-09-07.txt |
Référence : Chapitre 3, « Opening » et « Before / After ».