Measured Academy Measured Academy
English Pilote Progression 0

Module 3 · Leçon 4 sur 4

Typé ne veut pas dire juste

  1. Ce qui s’est passéUn appel typé a renvoyé une valeur qui passait toutes les vérifications et qui n’était pas la valeur de la requête, et les deux routeurs se sont entendus entre eux tout en contredisant le corrigé sur un billet.
  2. Pourquoi ça a changéUne contrainte de motif a été retirée du schéma que reçoit le modèle et déplacée dans une description ; le modèle a donc respecté le format au lieu d’extraire la valeur, et sur le billet contesté, la différence se trouvait dans la requête, à laquelle le typage ne touche pas.
  3. Comment on le mesureLe schéma enregistré comme envoyé est comparé au schéma tel qu’écrit, la valeur renvoyée est comparée à la requête, et les retours typés sont notés par rapport à un corrigé écrit à l’avance.
  4. Comment l’améliorerLire le schéma réellement envoyé, préférer les contraintes qui survivent au voyage, comme une liste fixe de valeurs, continuer de noter la sortie typée par rapport à un corrigé, et régler les décisions dans la requête.
Côte à côte

La règle que vous avez écrite et celle qui est arrivée

Essayez. Choisissez une partie du champ vendor à comparer telle qu’écrite et telle qu’envoyée. Affichez ensuite la réponse que l’appel a renvoyée.

D’où viennent ces données · claude-opus-5 · 2026-09-02, un appel

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/ch7-parse-output-format-2026-09-02.txt section C2
  • chapters/chapter-03-structured-output.md "Edge cases"
Explorateur

Trois routeurs et un corrigé sur un seul billet

Essayez. Commencez par le billet 10, puis essayez-en d’autres. Cochez la case pour lire la requête de chaque routeur et trouver ce qu’on a dit à celui qui a concordé avec le corrigé.

D’où viennent ces données · claude-opus-4-6, 2026-10-14 et 2026-09-07; 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.jsonl
  • runs/ch2-collapse-2026-09-07.jsonl
  • scripts/ch3_route_typed.py
  • runs/ch3-course-route-typed-2026-11-20.jsonl
  • runs/ch2-course-collapse-2026-11-20.jsonl

Ce qui s’est passé

Deux résultats tirés de l’enregistrement, qui paraissent tous deux corrects à un vérificateur de types.

Une valeur valide, mais fausse. On a donné à un modèle de facture un champ vendor avec un motif : les lettres ACME, un trait d’union, quatre chiffres. La requête nommait le fournisseur ACME Corp. L’appel typé a renvoyé ACME-0000 sans lever d’exception (runs/ch7-parse-output-format-2026-09-02.txt, section C2, claude-opus-5, un appel). La valeur respecte le motif. Ce n’est pas le fournisseur de la requête.

Un accord qui n’était pas de la justesse. À la leçon 1, les routeurs non typé et typé ont choisi la même file pour chaque billet. Notez-les par rapport au corrigé du module 2 et chacun obtient 9 sur 10 (BOOK.md, constats mesurés). Les deux ont envoyé le billet 10, celui de l’équipe qui ne voit pas un dossier partagé, à auth. Le corrigé dit general. L’appel unique du module 2 lui-même a obtenu 10 sur 10 par rapport à ce corrigé (runs/ch2-collapse-2026-09-07.txt).

Routeur Type de retour Billet 10, exécutions du livre (claude-opus-4-6) Billet 10, exécutions du cours (claude-opus-5)
Requête du chapitre 1, non typée chaîne auth auth
Requête du chapitre 1, typée une de quatre valeurs auth bug
Appel unique du module 2, non typé chaîne general general

Dans les exécutions du livre, les deux routeurs ont chacun obtenu 9 sur 10 par rapport au corrigé, et l’appel unique du module 2 10 sur 10. Dans les exécutions du cours (runs/ch3-course-route-typed-2026-11-20.txt, runs/ch2-course-collapse-2026-11-20.txt), le portrait est le même, avec une variante : le routeur typé a quitté auth pour bug, qui n’est pas plus proche du corrigé.

Sur les deux modèles, le routeur qui a concordé avec le corrigé pour ce billet était un routeur non typé.

Pourquoi ça a changé

Le motif n’a jamais atteint le modèle. Tout ce qu’on peut déclarer dans Pydantic ne peut pas s’exprimer dans le schéma qu’accepte l’API. Le SDK a retiré le motif du champ et ajouté son texte à la description du champ, en guise d’indication. Pydantic a quand même appliqué le motif localement au retour de la réponse. Le modèle a donc reçu une indication de format, a produit quelque chose dans ce format, et la vérification locale l’a laissé passer. C’est la lecture que fait le chapitre d’un seul appel, qui n’a pas été répété : une observation, pas un taux.

Une liste fixe de valeurs permises, c’est autre chose. Les quatre noms de file du routeur ont bel et bien voyagé dans le schéma, et c’est pourquoi la garantie de la leçon 1 tient pour eux.

Le billet a été tranché par la requête. BOOK.md consigne pourquoi les routeurs ont divergé sur le billet 10 : la requête de l’appel unique du module 2 dit ce dont chaque file s’occupe, alors que la requête du chapitre 1 se contente d’énumérer les noms. Le typage était présent dans une rangée qui contredit le corrigé et absent de la rangée qui concorde, sur les deux modèles. Ouvrez le deuxième explorateur ci-dessus, affichez les requêtes et lisez-les côte à côte.

Le typage règle ce qu’un retour peut être. Il n’a aucun avis sur sa justesse.

Comment on le mesure

  • Lisez le schéma qui a été envoyé, pas la classe que vous avez écrite. La sonde affiche les deux. La différence entre eux est la liste des règles que le modèle n’a jamais reçues.
  • Comparez la valeur avec la source. Un validateur peut dire qu’un code de fournisseur est bien formé. Seule une comparaison avec la requête, ou avec un corrigé, peut dire que c’est le bon fournisseur.
  • Gardez le corrigé. Une sortie typée est plus facile à noter, parce qu’un champ se compare proprement là où une chaîne doit être normalisée. Elle doit quand même être notée. C’est un corrigé écrit avant l’exécution, comme au module 2, qui a transformé « les deux versions s’entendent » en « les deux versions ratent le même billet ».

Comment l’améliorer

  • Préférez les contraintes qui survivent au voyage. Un ensemble fixe de valeurs survit. Pour une règle de format, énoncez-la aussi dans la requête et gardez la vérification locale.
  • Réglez les décisions dans la requête. Si un billet va dans la mauvaise file, définissez les files. Changer le type de retour ne le déplacera pas.
  • Ne confondez pas « ça a validé » avec « ça a réussi ». La validation est la première barrière. Le module 10 construit la deuxième.
  • Sachez quand vous en passer. Le chapitre donne trois cas : une sortie lue par une personne, un champ unique qui est déjà une chaîne, et des règles de validité qui changent si souvent que le schéma devient un chantier de maintenance à lui seul.

Lisez les trois cas au chapitre 3 du livre, « When NOT to use this », puis passez au test pratique.

Chaque nombre de cette leçon et le fichier d’où il vient (3)
ValeurFichier dans les enregistrements du livreConditions
ACME-0000runs/ch7-parse-output-format-2026-09-02.txtclaude-opus-5, 2026-09-02, un appel, non répété
9 sur 10BOOK.md
10 sur 10runs/ch2-collapse-2026-09-07.txtclaude-opus-4-6, 2026-09-07, la clé de l’auteur

Référence : Chapitre 3, « The tradeoff », « Edge cases » et « When NOT to use this ».