Rédiger la fiche de chaque champ du schéma
Un schéma de sortie est lu à la fois par le modèle et par les développeurs, et chacun en attend des choses différentes. Cette leçon vous apprend à documenter chaque champ de façon précise et à repérer les règles que le fournisseur ne fera pas respecter à votre place.
Mis à jour le 29 septembre 2026.
En bref
Un schéma de sortie décrit chaque champ attendu dans la réponse d'un modèle : son nom, son type, s'il est obligatoire, ses valeurs permises et sa signification. Il sert à la fois de consigne pour le modèle et de contrat pour les développeurs. Pour un PM, le documenter précisément évite les malentendus et révèle les règles à vérifier dans le code.
Objectif de la leçon
À la fin de cette leçon, vous serez capable de rédiger un schéma de sortie champ par champ (nom, type, caractère requis, valeurs permises, description, consommateur) et de repérer les contraintes que le fournisseur ne garantit pas.
Les questions auxquelles cette leçon répond
Comment documenter les champs d'un JSON Schema pour un LLM ?
Pour chaque champ, on précise le nom, le type, s'il est requis, les valeurs autorisées et une description claire de ce qu'il doit contenir. Le modèle lit cette description, elle compte donc autant que le type.
Quelles contraintes d'un schéma le fournisseur de modèle ne garantit-il pas ?
Les fournisseurs ne prennent souvent en charge qu'une partie des règles d'un JSON Schema, comme certains formats, bornes ou motifs. Ce qui n'est pas garanti doit être revérifié dans le code.
Thèmes abordés
- JSON Schema
- conception de schéma
- types de données
- énumérations
Dans le glossaire
Guide sur ce thème
- Écrire une spec pour agent IA
Les sections d’une spec qu’un agent de code exécute sans deviner, avec un modèle SPEC.md.
Dans quel module
Concevoir le schéma
Quels champs, quels types et quelles valeurs permises, et comment laisser le modèle dire « je ne sais pas » ?
Leçons du module
- Rédiger la fiche de chaque champ du schéma (cette leçon)
- Laisser le modèle dire « je ne sais pas » dans le schéma
Ce que vous apprendrez dans ce module
Cette leçon fait partie de la formation Obtenir des sorties IA fiables et exploitables par le produit (JSON, schémas, appels de fonction)
- Concevoir un schéma de sortie (types, énumérations, champs requis, champs nullables, descriptions, valeurs « inconnu ») dont chaque champ sert un consommateur.
Formations liées
- IA & ProduitConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Créer un assistant IA pour votre produit
3 h
- Tech pour PMJuniorQuelques bases utiles : notions de contexte ou du domaine.
Concevoir et tester une intégration API en tant que PM
3 h
- Tech pour PMTout publicAucun pré-requis : accessible à toutes et tous.
Expliquer comment fonctionne un produit web, du navigateur au serveur
2 h 30 min