Modelli documentali: cosa leggere e come leggerlo, in autonomia
Ogni tipo di documento — fattura, DDT, ordine cliente — viene letto da Data Alchemy secondo un modello documentale. Un modello è insieme un documento JSON, con la struttura dei campi da estrarre, e un testo in linguaggio naturale con le istruzioni di lettura: così la lettura è accurata e puoi modificare i modelli in autonomia. Per partire, scegli un modello dal marketplace e personalizzalo.
Marketplace di modelli disponibile ora. Licenza Basic: 1 modello; Business: modelli dimensionati sulle esigenze; Enterprise: modelli su misura. La Demo usa 1 modello scelto tra i predefiniti del marketplace.
Cos'è un modello documentale
Un modello documentale ha due parti. La prima è un documento JSON che descrive la struttura dei dati da estrarre: i campi di testata, i campi annidati come i dati del fornitore e le righe di dettaglio. La seconda è un testo scritto in linguaggio naturale, in italiano o in un'altra lingua, con le istruzioni di lettura: come interpretare un campo, in che formato restituirlo, cosa fare nei casi particolari.
Le istruzioni sono scritte come le spiegheresti a un collega, non in un linguaggio di programmazione: per questo chi conosce i documenti può correggere o estendere un modello in autonomia, senza aspettare uno sviluppatore. Il modello è anche il punto in cui si sceglie il motore AI che lo legge e in cui si configurano gli external fields e la remote validation, nelle licenze che li includono.
Il marketplace di modelli è disponibile ora: invece di partire da zero scegli un modello già pronto e lo personalizzi sui tuoi documenti. I modelli predefiniti che si scelgono nella Demo sono quelli del marketplace.
Dal marketplace al documento letto
Scegli un modello, lo adatti ai tuoi documenti e da quel momento ogni documento di quel tipo viene letto secondo la sua struttura e le sue istruzioni.
- 01Scegli dal marketplaceParti da un modello già pronto per il tipo di documento che vuoi leggere.
- 02PersonalizzaAdatti la struttura JSON dei campi e le istruzioni in linguaggio naturale ai tuoi documenti.
- 03Scegli il motore AIAbbini al modello un solo motore AI: Claude, GPT, un provider europeo o Data Alchemy AI.
- 04Lettura dei documentiOgni documento del modello viene letto secondo la struttura e le istruzioni, e restituito come dato strutturato.
1. Scegli un modello dal marketplace
Il marketplace raccoglie modelli pronti per i documenti ricorrenti: si sceglie quello più vicino al proprio documento invece di partire da un foglio bianco.
2. Adatti la struttura dei campi
Nel documento JSON aggiungi, togli o rinomini i campi da estrarre, per esempio per allinearli ai nomi usati nel tuo gestionale.
3. Scrivi le istruzioni di lettura
Nel testo in linguaggio naturale spieghi come leggere i casi particolari: formati di data, prefissi della partita IVA, righe su più pagine. In italiano o in un'altra lingua.
4. Correggi in autonomia quando serve
Se un fornitore cambia layout o ti serve un campo in più, modifichi il modello: struttura e istruzioni sono tue, senza richieste di sviluppo.
I dati letti secondo il modello possono poi essere verificati sui tuoi sistemi e inviati all'ERP: vedi l'Agente AI e l'integrazione con l'ERP.
Com'è fatto nella piattaforma
L'editor di un modello per i documenti di trasporto (DDT), così come lo vede il cliente: le stesse informazioni si modificano dalla vista a schede oppure direttamente nel JSON.
Un modello in breve: struttura JSON e istruzioni
Una versione semplificata, da leggere a colpo d'occhio, di un modello per le fatture fornitori, a complemento degli screenshot qui sopra: a sinistra la struttura dei campi da estrarre, a destra le istruzioni di lettura scritte in linguaggio naturale. I nomi dei campi e le istruzioni sono un esempio: ogni modello si adatta ai documenti e al gestionale dell'azienda.
{
"numero": "",
"data": "",
"fornitore": {
"ragione_sociale": "",
"partita_iva": ""
},
"imponibile": 0,
"iva": 0,
"totale": 0,
"righe": [
{
"codice_articolo": "",
"descrizione": "",
"quantita": 0,
"prezzo_unitario": 0
}
]
}- Leggi la fattura del fornitore e compila i campi della struttura.
- La data va riportata nel formato GG/MM/AAAA.
- Se la partita IVA ha il prefisso nazionale (per esempio IT), rimuovilo.
- Le quantità e gli importi sono sempre numeri, senza simbolo di valuta.
- Riporta una riga per ogni articolo, anche quando la fattura prosegue su più pagine.
Esempio a scopo illustrativo: non corrisponde a un modello specifico del marketplace.
Cosa puoi fare con i modelli documentali
Partire subito con un modello del marketplace
Scegli un modello pronto per il tuo tipo di documento e lo usi così com'è o lo personalizzi: nessun progetto di configurazione da zero.
Allineare i campi al tuo gestionale
La struttura JSON definisce esattamente quali campi estrarre e come chiamarli, così i dati arrivano già nella forma che serve al tuo ERP.
Gestire i casi particolari con istruzioni scritte
Un fornitore che scrive la data in modo diverso o un documento con righe su più pagine si gestiscono con una frase nelle istruzioni, non con un nuovo template.
Un modello per ogni tipo di documento
Fatture, DDT, ordini clienti, listini: ogni tipo di documento ha il suo modello, con il suo motore AI e, nelle licenze che li includono, le sue verifiche sui sistemi esterni.
Quanti modelli in ciascuna licenza
Il marketplace di modelli è disponibile ora. Il numero di modelli dipende dalla licenza:
Modelli su misura
Modelli e spazio su misura, con tutto ciò che offre la licenza Business, l'integrazione nativa con Salesforce, l'Order Dispatcher e l'Agente AI.
Modelli dimensionati sulle esigenze
Modelli e spazio dimensionati sulle esigenze, con external fields e remote validation configurabili nei modelli.
1 modello
Un modello documentale e 500 MB di spazio, con crediti a consumo acquistabili online: 1 credito = 1 documento.
1 modello predefinito
10 giorni e 10 documenti con 1 modello scelto tra i predefiniti del marketplace, in un ambiente dedicato con dati non condivisi.
Confronta le licenze nella pagina prezzi e licenze oppure richiedi un preventivo.
Funzionalità e pagine collegate
- Motori AIIl motore che legge ogni modello: Claude, GPT, i provider europei o Data Alchemy AI.
- External fieldsCampi del modello verificati sui dati esterni a cui il documento rimanda, come l'ordine d'acquisto.
- Remote validationCodici articolo verificati e codice cliente o fornitore recuperato dall'anagrafica.
- Accuratezza dell'estrazione datiCome si misura la precisione della lettura e il 99,8% misurato con Claude.
Modelli documentali: domande frequenti
Cos'è un modello documentale in Data Alchemy?
È la definizione di come leggere un tipo di documento. Ha due parti: un documento JSON con la struttura dei campi da estrarre e un testo in linguaggio naturale, in italiano o in un'altra lingua, con le istruzioni di lettura. Ogni documento caricato viene letto secondo il suo modello.
Posso modificare i modelli da solo?
Sì. Struttura e istruzioni sono pensate per essere modificate dal cliente in autonomia: i campi si cambiano nel JSON e i casi particolari si spiegano con una frase nelle istruzioni, senza scrivere codice.
Cos'è il marketplace di modelli?
È la raccolta di modelli pronti di Data Alchemy, disponibile ora: il cliente sceglie un modello dal marketplace e lo personalizza in autonomia sui propri documenti. I modelli predefiniti tra cui si sceglie nella Demo sono quelli del marketplace.
In che lingua si scrivono le istruzioni di lettura?
In linguaggio naturale, in italiano o in un'altra lingua: le istruzioni si scrivono come si spiegherebbero a un collega che deve leggere il documento.
Quanti modelli posso usare?
La licenza Basic include 1 modello; nella Business i modelli sono dimensionati sulle esigenze e nella Enterprise sono su misura. La Demo permette di provare 1 modello scelto tra i predefiniti del marketplace.
Parti da un modello e leggi i tuoi documenti
Attiva la Demo gratuita e prova la lettura dei tuoi documenti con un modello predefinito del marketplace, oppure pianifica una call per costruire i modelli sui tuoi flussi.