GuidesDéveloppement IA

Tuto : obtenir un JSON fiable d’un modèle IA

Par l’équipe Banzai LabsMis à jour le 2 min de lecture

{ "nom": … "total": … "date": …}Sinon, redemandéUn schéma imposé, une sortie vérifiée
Un texte libre entre, un JSON conforme au schéma sort, et le code le valide.

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

Du plus souple au plus strict
  1. 1Consigne et exempleLe format décrit dans le prompt, avec un exemple.
  2. 2Outil imposéUn outil dont les paramètres suivent le schéma, que le modèle doit appeler.
  3. 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 null plutô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.

À lire ensuite

Tous les guides