Risorse · 81

Estrazione con IA: validare il JSON prima dell’integrazione

Separare sintassi, schema, prove documentali e regole di business per ottenere dati utilizzabili.

Aggiornato · 3 min

Portatile con codice su una scrivania Illustrazione · scena fittizia

Obiettivi di questa guida

  • Definire il contratto
  • Collegare i valori alle prove
  • Validare per livelli
  • Provare documenti difficili
  • Preparare correzione e ripresa

Verifica rapida

  • Il JSON valido può essere errato?
  • Un campo assente diventa zero?
  • Quando serve una revisione umana?

Metodo passo passo

  1. 1

    Definire il contratto

    Elencare campi, tipi, unità e valori mancanti. In JSON Schema, properties descrive un campo ma non lo rende obbligatorio: required è una regola distinta. Decidere se accettare campi aggiuntivi e conservare la versione dello schema.

    Risultato: schema versionato ed esempi accettati o rifiutati.

  2. 2

    Collegare i valori alle prove

    Per importi, identità e date determinanti, richiedere pagina o passaggio di origine. Un numero corretto può appartenere a un altro documento. Lasciare sconosciuto ciò che la fonte non stabilisce, senza sostituirlo con un valore plausibile.

    Risultato: collegamento fra campo, fonte e interpretazione.

  3. 3

    Validare per livelli

    Controllare parsing, schema e regole di business: valuta consentita, identificatore esistente, totali e cronologia. Uno schema valido non dimostra verità né autorizzazione a scrivere. Bloccare l’azione finché i requisiti non sono soddisfatti.

    Risultato: errori distinti e decisioni di accettazione.

  4. 4

    Provare documenti difficili

    Includere tabelle spezzate, lingue diverse, valori in conflitto, documenti vuoti e istruzioni ostili nel testo. Separare i casi di valutazione dalla messa a punto e confrontare gli errori per campo.

    Risultato: insieme di riferimento ed errori critici.

  5. 5

    Preparare correzione e ripresa

    Collegare documento, modello, schema e risultato a un identificatore di elaborazione. Un nuovo tentativo non deve creare due record. Conservare il motivo delle correzioni e individuare gli output da aggiornare, evitando copie inutili nei log.

    Risultato: procedura di correzione e ripetizione controllata.

Prima di scrivere un valore

Seguire il percorso per ogni campo che comporta una decisione.

  1. Esiste una fonte?

    In assenza di evidenza conservare il valore sconosciuto.

  2. Il valore è supportato?

    Confrontare testo, unità e contesto.

  3. Il contratto è rispettato?

    Validare schema e regole operative.

  4. La scrittura è autorizzata?

    Verificare permessi e revisione prima dell’effetto.

Un importo ben formato ma non presente nel documento non supera il controllo.

Foglio di lavoro riutilizzabile

Completare con le proprie osservazioni autorizzate. Questi campi costituiscono un modello di lavoro, non risultati osservati.

CampoInformazioni da registrare
ContrattoCampi, tipi, unità, assenze e versione
ProveDocumento e passaggio per ogni valore decisivo
ValidazioneParsing, schema, regole e motivo di rifiuto
RipresaIdentificatore, duplicati e correzioni propagate

Esempio pratico fittizio

Situazione illustrativa

Esempio fittizio: un estrattore seleziona il totale imponibile di una fattura, mentre il connettore richiede il totale da pagare.

Decisione e prove attese

Lo schema accetta il numero, ma il confronto con righe e valuta blocca la scrittura e richiede una revisione.

Distinguere i meccanismi

MeccanismoScopoVerifica o limitazione
JSON leggibilePermette il parsingNon verifica campi obbligatori o significato
Conformità allo schemaControlla forma e vincoliNon dimostra fedeltà alla fonte
Confronto di businessVerifica uso e coerenzaRichiede regole e prove

Indicatori di gestione

IndicatoreCosa misuraPrima azione
Accuratezza per campoValori corretti fra quelli valutabiliPriorità agli errori che cambiano un’azione
Astensione utileCasi senza prove sufficientiEsaminare la coda senza premiare invenzioni
Duplicati nei tentativiRecord ripetuti per la stessa operazioneCorreggere deduplicazione e ripresa

Errori comuni

  • Non verifica campi obbligatori o significato
  • Non dimostra fedeltà alla fonte
  • Richiede regole e prove

Domande frequenti

Il JSON valido può essere errato?

Sì. Sintassi e schema possono essere corretti mentre importo, data o identità sono sbagliati. Verificare i valori decisivi sulla fonte.

Un campo assente diventa zero?

Solo se il contratto attribuisce a zero quel significato. Altrimenti usare lo stato di assenza previsto.

Quando serve una revisione umana?

Quando conflitti, prove mancanti o errori critici superano il perimetro accettato. Definire questi casi prima dell’elaborazione.

Letture e strumenti complementari

Risorse editoriali per approfondire il metodo.

Riferimenti ufficiali

I riferimenti supportano il metodo. Adattare i controlli al proprio contesto; non costituiscono una certificazione. I titoli dei riferimenti originali e i documenti di origine potrebbero essere in un'altra lingua.

Riferimenti consultati il .