GuidesDéveloppement IA
Tuto : obtenir un JSON fiable d’un modèle IA
1. Décrire le résultat attendu
import { z } from 'zod';
const Facture = z.object({
fournisseur: z.string(),
total_ttc: z.number(),
date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
});
2. Contraindre le modèle
- 1Consigne et exempleLe format décrit dans le prompt, avec un exemple.
- 2Outil imposéUn outil dont les paramètres suivent le schéma, que le modèle doit appeler.
- 3Sortie structuréeLe mode du fournisseur qui force la sortie à suivre le schéma, quand il existe.
3. Valider, toujours
const parsed = Facture.safeParse(JSON.parse(texteDuModele));
if (!parsed.success) {
// renvoyer parsed.error.issues au modèle et redemander, une ou deux fois
} else {
enregistrer(parsed.data);
}
Les pièges
- Les nombres écrits en texte (« 1 234,50 € ») : précisez le format attendu.
- Les champs absents du document : autorisez
nullplutôt que de forcer une invention. - Les dates : imposez un format unique.
Voir aussi les hallucinations et l’appel d’outils.
Questions fréquentes
- Demander « réponds en JSON » dans le prompt suffit-il ?
- Souvent, pas toujours. Les mécanismes de sortie structurée ou d’outil imposé rendent l’écart beaucoup plus rare. La validation par le code reste obligatoire.
- Que faire si la validation échoue ?
- Renvoyer au modèle l’erreur précise et redemander, une ou deux fois. Au-delà, mettre le cas de côté pour un humain.
- Le JSON valide est-il forcément juste ?
- Non. Un JSON bien formé peut contenir une valeur fausse. Les valeurs critiques se recoupent avec vos données.