Méthode pratique

Valider les sorties structurées d’une IA avant import

Un JSON bien formé peut attribuer une date plausible au mauvais document. Pour alimenter un tableur, un formulaire ou une base à partir d’un texte, contrôlez séparément la réponse de l’API, la structure du JSON et la fidélité de chaque valeur à sa source.

Illustration d’un poste de développement consacré à la revue d’un résultat généré.
Illustration générée par IA
À retenir

La méthode à appliquer

Pour extraire une échéance, exigez trois champs : status, date et evidence. Prévoyez found, missing et ambiguous pour le statut. Réservez null à une date inconnue lorsque le champ date doit être présent. L’application rapproche la preuve du document et met les cas incertains en attente.

  • Transport
  • Contrat
  • Preuve
  • Écriture

Préparer, tester et décider

  1. Illustration éditoriale

    1. Définir la règle de décision

    Précisez quelle date importe : publication, échéance ou dernière révision. Déterminez quelle version du document fait foi. Si deux échéances se contredisent et que leur priorité est inconnue, attendez un statut ambiguous et une date nulle.

  2. Illustration générée par IA

    2. Écrire le contrat de sortie

    Définissez le type de chaque champ, les clés obligatoires et les statuts permis. Un champ obligatoire nullable doit apparaître même quand sa valeur est null. Contrôlez séparément les règles qui relient plusieurs champs, par exemple found exige une date et une preuve.

  3. Illustration générée par IA

    3. Vérifier les capacités du modèle

    Confirmez que l’API et le modèle prennent en charge les mots-clés nécessaires du schéma. Testez la requête complète avec des données fictives. Préparez des traitements distincts pour erreur de configuration, refus et réponse interrompue.

  4. Bibliothèque avec livres et carnet de recherche
    Illustration générée par IA

    4. Comparer la valeur au document

    Pour une date au format AAAA-MM-JJ, contrôlez notamment la validité du calendrier et la correspondance avec le passage fourni. Un extrait présent dans le texte doit aussi justifier le type de date demandé. Une mention de publication ne suffit pas à établir une échéance.

  5. Ordinateur portable et dossiers sur un bureau privé
    Illustration générée par IA

    5. Valider avant enregistrement

    Distinguez les dossiers exploitables, incomplets et conflictuels. Gardez une trace de l’identifiant de document, de sa révision et de la décision de validation. Rejouez le même dossier pour vérifier qu’une reprise ne crée pas un doublon.

  6. Disques externes et dossiers préparés pour une migration
    Illustration générée par IA

    6. Tester une migration par étapes

    Figez modèle, paramètres, schéma et règles de validation. Rejouez le même lot avec les deux configurations et comparez les différents motifs d’échec. Une compatibilité de format ne suffit pas à autoriser le basculement tant que des champs décisifs dérivent.

Mettre la méthode à l’épreuve

Studio de création avec appareil photo et tablette graphique
Illustration générée par IA

Cas pratique

Préparez quatre avis fictifs. A indique une échéance le 14 février 2027. B ne contient qu’une date de publication. C donne deux échéances sans ordre de priorité. D reproduit A, mais la réponse simulée s’arrête avant la fin du JSON.

Bureau en bois avec ordinateur portable et écran
Illustration générée par IA

Preuves à conserver

Attendus pour A : found et 2027-02-14, avec le passage d’échéance. Pour B : missing et null. Pour C : ambiguous et null, avec les deux passages. Pour D : réponse incomplète, orientée vers le traitement d’erreur.

Recherche documentaire avec atlas et livres dans une bibliothèque
Illustration générée par IA

Décider

Enregistrez A une seule fois. Après rejeu, vérifiez que B, C et D ne créent pas de ligne d’échéance et qu’un deuxième traitement de A ne crée pas de doublon.

Critères d’acceptation

Illustration générée par IA

Transport

Une erreur, un refus et une réponse incomplète déclenchent des traitements distincts.

Classement de documents avec dossiers et liseuse
Illustration générée par IA

Contrat

Les champs présents, les statuts autorisés et les valeurs nulles répondent aux règles prévues.

Illustration éditoriale

Preuve

Le passage source confirme la valeur et le rôle de la date.

Illustration générée par IA

Écriture

La reprise du même dossier ne crée aucune ligne supplémentaire.

4 repères

Fiches liées à cette méthode

Ces fiches documentent les outils concernés. Leur ordre ne constitue pas un classement de performances.

Comment cette sélection est-elle produite ?

Ces fiches sont reliées au sujet du guide dans notre catalogue éditorial. Leur présence ne constitue pas un classement ni une mesure de performance sur vos documents. Méthodologie.

Explorer toute la catégorie

Familles d’outils liées

Questions fréquentes

Peut-on valider un résultat avec le seul schéma JSON ?

Le schéma contrôle les propriétés et leurs valeurs autorisées. L’application doit encore vérifier le sens des valeurs et les rapprocher du texte source.

Comment transporter un champ inconnu ?

Un champ explicitement nul diffère d’une clé absente. Choisissez la représentation attendue, documentez-la et vérifiez que les clients la conservent.

Comment changer de fournisseur ?

Rejouez les mêmes entrées, testez la prise en charge du schéma et comparez les sorties valides, refusées, incomplètes et incorrectes selon les règles métier.

Les références ci-dessous approfondissent les concepts et contrôles évoqués. Les scénarios et grilles d’essai restent des propositions éditoriales ; une documentation fournisseur décrit son propre produit, pas un benchmark indépendant.

Sources officielles

Poursuivre avec un autre guide