Accueil / Techniques qui changent le résultat
Sorties structurées et garde-fous
Imposer un schéma exact à une sortie et vérifier cette sortie avant de l'utiliser sont deux moitiés du même réflexe, l'une force la forme en amont, l'autre la contrôle en aval, et les deux comptent davantage quand l'action qui suit ne se rattrape pas.
Les sorties structurées contraignent la réponse de Claude à suivre un schéma précis, ce qui garantit une sortie valide et exploitable par un traitement automatique en aval. Deux mécanismes distincts se combinent : forcer le format d'une réponse selon un schéma défini d'un côté, forcer les arguments d'un appel d'outil de l'autre. Les deux imposent la forme avant que la réponse ne parte, ils ne disent rien de ce qui se passe après qu'elle est arrivée.
Le schéma force la forme, pas le contenu
Définir un schéma revient à dessiner un gabarit : ces champs, ces types, cet ordre, rien d'autre. Un champ prénom attend une chaîne, un champ montant attend un nombre, une réponse qui ne colle pas à ce gabarit est rejetée avant même d'atteindre le programme qui l'utilise.
schema attendu : { "nom": string, "quantite": number, "urgent": boolean }
sortie recue : { "nom": "gants de protection", "quantite": 12, "urgent": true }
Le schéma garantit que la forme ci-dessus arrive à chaque fois, il ne garantit pas que douze est le bon chiffre. Le nombre de champs valides ne dit rien sur l'exactitude d'un seul d'entre eux : c'est exactement ce qu'un schéma ne peut pas voir.
Le garde-fou vérifie ce que le schéma ne voit pas
Le second réflexe prend le relais où le premier s'arrête : relire la sortie une fois reçue, avant de la transmettre à l'étape suivante. Un garde-fou peut être une règle simple, ce montant reste sous un plafond, cette quantité reste positive, ou un second passage qui compare la sortie à la demande d'origine. Dans les deux cas, la sortie structurée passe une seconde porte avant d'agir, elle ne se contente pas d'avoir la bonne forme.
Cette seconde porte compte plus quand l'action qui suit ne se rattrape pas : envoyer un message, valider une commande, modifier un fichier partagé. Une sortie mal formée qui reste affichée à l'écran se corrige d'un coup d'oeil, une sortie mal formée qui déclenche une action déjà exécutée ne se corrige plus. Ce garde-fou rejoint la thèse déjà posée dans un vert ne prouve rien tant qu'il n'a pas été prouvé lui-même : un contrôle qui n'a jamais été mis en défaut par une sortie fausse n'a encore rien prouvé.
Une sortie libre contre une sortie forcée puis relue
Il faudrait sans doute une douzaine de gants de protection, et c'est plutôt urgent je pense.
{ "nom": "gants de protection", "quantite": 12, "urgent": true } -> quantite > 0 : verifieUn magasinier demande à Claude de lire un bon de commande papier photographié et de rendre le nom de l'article, la quantité et un indicateur d'urgence selon un schéma fixé à l'avance. La réponse obtenue respecte les trois champs et leurs types, avec la quantité douze et l'indicateur d'urgence à vrai.
Écrivez en une phrase ce que cette situation établit, et en une phrase ce qu'elle n'établit pas.
Ce que cela établit : La réponse respecte le schéma demandé, trois champs présents, chacun du type attendu, ce qui la rend exploitable telle quelle par un programme en aval.
Ce que cela n’établit pas : Elle n'établit pas que la quantité douze correspond réellement à ce qui est écrit sur le bon de commande photographié, un schéma respecté ne garantit pas un contenu exact.
Les trois calibrages faux les plus courants
- Trop large Puisque le schéma est respecté, Claude a correctement lu chaque chiffre présent sur le bon de commande photographié.
- Trop étroit Un seul bon de commande ayant été traité, cette réponse ne permet de dire quoi que ce soit sur le schéma lui-même.
- À côté Cette réponse montre que la photographie du bon de commande était suffisamment nette pour être transmise à Claude.
- Un schéma de sortie garantit la forme d'une réponse, jamais l'exactitude de son contenu, les deux se vérifient séparément.
- Le garde-fou intervient après la réponse, pas avant : il relit ce qui vient d'arriver plutôt que d'empêcher une mauvaise forme de partir.
- Une action qui ne se rattrape pas mérite un garde-fou plus strict qu'une sortie simplement affichée à l'écran.
- Forcer la forme et vérifier le contenu sont deux étapes distinctes du même flux, pas deux façons différentes de faire la même chose.
Choisissez une tâche où vous demandez régulièrement une liste ou un montant à Claude, écrivez les trois champs exacts que la réponse doit contenir, et ajoutez une phrase de règle que vous appliquerez vous-même avant d'utiliser cette réponse.
Ces points dépendent d’une interface ou d’une règle qui peut avoir changé depuis la rédaction. Vérifiez-les sur votre propre écran avant de vous y fier.
- La liste des modèles qui prennent en charge les sorties structurées évolue : ouvrez la page des sorties structurées sur votre écran et vérifiez que le modèle que vous utilisez y figure avant de bâtir un schéma dessus.
Chaque affirmation datable de cette leçon renvoie ici au texte public qui la porte. Une source qui ne s’ouvre pas ne prouve rien.
- Anthropic, Structured outputs consultée le 2026-09-02