Ressources · 81

Extraction par IA : valider un JSON avant de l’intégrer

Séparer parsing, schéma, preuve documentaire et règles métier pour transformer des documents en données utilisables.

· 4 min

Ordinateur portable affichant du code sur un bureau Illustration · scène fictive

Ce que ce guide permet

  • Définir le contrat du résultat
  • Relier chaque valeur à une preuve
  • Valider dans un ordre explicite
  • Tester les documents difficiles
  • Prévoir reprise et correction

Contrôle express

  • Un JSON valide peut-il contenir une erreur ?
  • Faut-il remplacer un champ manquant par zéro ?
  • Quand demander une revue humaine ?

Méthode pas à pas

  1. 01

    Définir le contrat du résultat

    Listez les champs réellement nécessaires, leur type, unité et statut d’absence. JSON Schema distingue propriétés décrites et champs obligatoires : déclarer une propriété ne la rend pas obligatoire. Décidez si les champs supplémentaires sont acceptés. Conservez la version du schéma avec chaque lot, sans multiplier des champs sans usage.

    Livrable : schéma versionné et exemples valides ou rejetés.

  2. 02

    Relier chaque valeur à une preuve

    Demandez une référence à la page, au passage ou à la cellule source pour les valeurs qui déterminent une action. Prévoyez un état inconnu lorsque l’information manque. Un montant correctement typé peut être celui d’un autre document ; une date plausible peut être la date d’émission au lieu de la date d’échéance.

    Livrable : correspondance champ, source et règle de lecture.

  3. 03

    Valider dans un ordre explicite

    Contrôlez d’abord le parsing JSON, puis le schéma, puis les règles métier : devise autorisée, identifiant existant, somme des lignes, chronologie. Un résultat conforme au schéma ne garantit ni vérité ni autorisation d’écrire dans un système. Bloquez l’action métier tant que ses conditions ne sont pas réunies.

    Livrable : erreurs distinctes et décisions d’acceptation.

  4. 04

    Tester les documents difficiles

    Constituez des cas avec tableaux scindés, plusieurs langues, valeurs contradictoires, document vide et instructions hostiles dans le texte. Vérifiez refus, troncature et nouvelle tentative. Réservez un jeu indépendant de la mise au point et comparez les erreurs par champ, sans convertir un taux global en garantie.

    Livrable : jeu de référence et liste des erreurs critiques.

  5. 05

    Prévoir reprise et correction

    Associez document, version du modèle, schéma et résultat à un identifiant de traitement. Une reprise ne doit pas créer deux fiches. Une correction humaine doit conserver sa justification et permettre de retrouver les sorties dérivées. Évitez de copier inutilement le document entier dans les journaux.

    Livrable : procédure de correction et reprise contrôlée.

Du résultat lisible à l’action autorisée

Un contrôle réussi ne remplace pas le suivant. Arrêtez le traitement au premier contrôle indispensable non satisfait.

  1. Lire le JSON

    La réponse est-elle complète et analysable ?

  2. Valider le contrat

    Types, champs, unités et absence correspondent-ils au schéma ?

  3. Vérifier les valeurs

    Les preuves sources et règles métier justifient-elles les valeurs ?

  4. Autoriser l’action

    L’identité, la portée et les conditions d’écriture sont-elles réunies ?

Exemple fictif : le parsing et le schéma passent, mais deux montants se contredisent. L’écriture reste bloquée ; le dossier part en revue.

Fiche de travail à réutiliser

À compléter avec vos observations autorisées. Ces champs constituent une trame de travail, pas des résultats observés.

ChampInformation à consigner
ContratChamps, types, unités, absence et version du schéma
PreuveDocument et passage correspondant à chaque champ décisif
ValidationParsing, schéma, règles métier et raison du rejet
RepriseIdentifiant de traitement, doublon évité et correction propagée

Exemple d’application

Situation illustrative

Exemple fictif : un extracteur trouve deux totaux sur une facture et choisit le montant hors taxes alors que le connecteur attend le montant à payer.

Décision et preuve attendue

Le schéma accepte le nombre, mais le rapprochement des lignes et de la devise bloque l’écriture et transmet le document à la revue.

Distinguer les mécanismes

MécanismeUtilitéPoint de vigilance
JSON lisiblePermettre le parsingNe valide ni champs attendus ni sens
Schéma conformeContrôler types et contraintesNe prouve pas la fidélité au document
Rapprochement métierVérifier l’usage et la cohérenceDépend de règles et de références explicites

Indicateurs de pilotage

IndicateurCe qu’il mesurePremière action
Exactitude par champValeurs correctement extraites parmi les champs évaluablesPrioriser les erreurs qui changent une action
Abstention utileCas non décidés faute de preuveExaminer la file sans pousser à inventer une valeur
Doublons à la repriseFiches répétées pour un même traitementCorriger le mécanisme de déduplication

Erreurs fréquentes

  • Ne valide ni champs attendus ni sens
  • Ne prouve pas la fidélité au document
  • Dépend de règles et de références explicites

Questions fréquentes

Un JSON valide peut-il contenir une erreur ?

Oui. Il peut respecter la syntaxe et le schéma tout en donnant un montant, une identité ou une date incorrects. Vérifiez les valeurs décisives avec leur source.

Faut-il remplacer un champ manquant par zéro ?

Seulement si le contrat donne ce sens à zéro. Sinon, utilisez le statut d’absence prévu ; une valeur par défaut inventée fausse les calculs.

Quand demander une revue humaine ?

Lorsqu’une contradiction, une preuve absente ou une erreur critique dépasse le périmètre accepté. Définissez les cas avant de lancer les lots.

Lectures et outils complémentaires

Repères éditoriaux pour prolonger la méthode.

Références officielles

Date de consultation des références : . La méthode et la fiche de travail proposent des contrôles à adapter à votre contexte ; elles ne constituent pas une certification.