Comporre modelli personalizzati

stile di enfasi

Questo contenuto si applica a:🟩v4.0 (GA) | Versioni precedenti:🟦v3.1 (GA)🟥v3.0 (ritiro)🟥v2.1 (ritiro)

Questo contenuto si applica a:🟩v3.1 (GA) | Ultima versione:🟪v4.0 (GA) | Versioni precedenti:🟦v3.0🟦v2.1

Questo contenuto si applica a:🟥v3.0 (ritiro) | Versioni più recenti:🟪v4.0 (GA)🟪v3.1 (GA) | Versione precedente:🟥v2.1 (ritiro)

Questo contenuto si applica a:🟥v2.1 | Ultima versione:🟪v4.0 (GA)

Importante

Il comportamento di composizione del modello viene modificato per api-version=2024-11-30 (GA). Per altre informazioni, vedere Modelli personalizzati composti. Il comportamento seguente si applica solo alle versioni v3.1 e precedenti.

Un modello composto viene creato prendendo una raccolta di modelli personalizzati e assegnandoli a un singolo ID modello. È possibile assegnare fino a 200 modelli personalizzati sottoposti a training a un singolo ID modello composto. Quando un documento viene inviato a un modello composto, il servizio esegue un passaggio di classificazione per decidere quale modello personalizzato rappresenta in modo accurato il modulo presentato per l'analisi. I modelli composti sono utili quando si esegue il training di diversi modelli e si vogliono raggrupparli per analizzare tipi di modulo simili. Ad esempio, il modello composto può includere modelli personalizzati sottoposti a training per analizzare l'offerta, l'attrezzatura e gli ordini di acquisto di mobili. Anziché tentare manualmente di selezionare il modello appropriato, è possibile usare un modello composto per determinare il modello personalizzato appropriato per ogni analisi ed estrazione.

Per altre informazioni, vedere Modelli personalizzati composti.

Questo articolo illustra come creare e usare modelli personalizzati composti per analizzare moduli e documenti.

Prerequisiti

Per iniziare, sono necessarie le risorse seguenti:

  • Scrizioni di Azure. È possibile creare una sottoscrizione Azure gratuita.

  • Istanza di Document Intelligence. Dopo aver creato la sottoscrizione Azure, creare una risorsa di Document Intelligence nel portale di Azure per ottenere la chiave e l'endpoint. Se si dispone di una risorsa di Document Intelligence esistente, passare direttamente alla pagina della risorsa. È possibile usare il piano tariffario gratuito (F0) per provare il servizio e eseguire l'aggiornamento in un secondo momento a un livello a pagamento per la produzione.

    1. Dopo la distribuzione della risorsa, selezionare Vai alla risorsa.

    2. Copiare i valori Keys e Endpoint dal portale di Azure e incollarli in una posizione comoda, ad esempio Microsoft Blocco note. Per connettere l'applicazione all'API Document Intelligence sono necessari i valori di chiave ed endpoint.

Ancora foto che mostra come accedere alla chiave di risorsa e all'URL dell'endpoint.

Suggerimento

Per altre informazioni, vedere Creare una risorsa di Document Intelligence.

  • Un account di archiviazione Azure. Se non sai come creare un account di archiviazione di Azure, segui la guida introduttiva Archiviazione di Azure per il portale di Azure. È possibile usare il piano tariffario gratuito (F0) per provare il servizio e eseguire l'aggiornamento in un secondo momento a un livello a pagamento per la produzione.

Creare modelli personalizzati

Prima di tutto, è necessario un set di modelli personalizzati da comporre. È possibile usare Document Intelligence Studio, l'API REST o le librerie client. I passaggi sono i seguenti:

Assemblare il set di dati di training

La creazione di un modello personalizzato inizia con la definizione del set di dati di training. Per il set di dati di esempio sono necessari almeno cinque moduli completati dello stesso tipo. Possono essere di diversi tipi di file (jpg, png, pdf, tiff) e contengono sia testo che grafia. I moduli devono rispettare i requisiti di input per Document Intelligence.

Suggerimento

Seguire questi suggerimenti per ottimizzare il set di dati per il training:

  • Se possibile, usare documenti PDF basati su testo anziché documenti basati su immagini. I PDF scansionati vengono gestiti come immagini.
  • Per i moduli compilati, usare esempi con tutti i campi compilati.
  • Usare moduli con valori diversi in ogni campo.
  • Se le immagini del modulo hanno una qualità inferiore, usare un set di dati più grande (ad esempio 10-15 immagini).

Per suggerimenti su come raccogliere i documenti di training, vedere Creare un set di dati di training .

Caricare il set di dati di training

Dopo aver raccolto un set di documenti di training, è necessario upload i dati di training in un contenitore di archiviazione BLOB Azure.

Se si vogliono usare dati etichettati manualmente, è necessario caricare i file di.labels.json e .ocr.json corrispondenti ai documenti di training.

Addestrare il proprio modello personalizzato

Quando si esegue il training del modello con dati etichettati, il modello usa l'apprendimento supervisionato per estrarre i valori di interesse, usando i moduli etichettati forniti. I dati etichettati generano modelli con prestazioni migliori e possono produrre modelli che funzionano con forme complesse o moduli contenenti valori senza chiavi.

Intelligence per i documenti usa l'API modello di layout predefinito per apprendere le dimensioni e le posizioni previste di caratteri tipografici ed elementi di testo scritti a mano ed estrarre tabelle. Usa quindi le etichette specificate dall'utente per apprendere le associazioni chiave/valore e le tabelle nei documenti. È consigliabile usare cinque forme etichettate manualmente dello stesso tipo (stessa struttura) per iniziare a eseguire il training di un nuovo modello. Aggiungere quindi altri dati etichettati, se necessario, per migliorare l'accuratezza del modello. Document Intelligence consente di addestrare un modello per estrarre coppie chiave-valore e tabelle utilizzando capacità di apprendimento supervisionato.

Per creare modelli personalizzati, iniziare con la configurazione del progetto:

  1. Nella home page di Studio selezionare Crea nuovo dalla scheda Modello personalizzato.

  2. Usare il ➕ comando Crea un progetto per avviare la configurazione guidata del nuovo progetto.

  3. Immettere i dettagli del progetto, selezionare la sottoscrizione e la risorsa Azure e il contenitore di archiviazione BLOB Azure che contiene i dati.

  4. Rivedere, confermare le impostazioni e creare il progetto.

Animazione che mostra la creazione di un progetto personalizzato in Document Intelligence Studio.

Durante la creazione di modelli personalizzati, potrebbe essere necessario estrarre raccolte di dati dai documenti. Le raccolte possono essere visualizzate in uno dei due formati. Uso delle tabelle come modello visivo:

  • Conteggio dinamico o variabile di valori (righe) per un determinato set di campi (colonne)

  • Raccolta specifica di valori per un determinato set di campi (colonne e/o righe)

Consulta Document Intelligence Studio: etichettatura sotto forma di tabelle

Creare un modello composto

Nota

L'operazione create compose model è disponibile solo per i modelli personalizzati sottoposti a training con etichette. Il tentativo di comporre modelli senza etichetta genererà un errore.

Con l'operazione di creazione del modello di composizione, è possibile assegnare fino a 100 modelli personalizzati addestrati a un singolo ID del modello. Quando si analizzano i documenti con un modello composto, Document Intelligence classifica innanzitutto il modulo inviato, quindi sceglie il modello assegnato più adatto e restituisce i risultati per tale modello. Questa operazione è utile quando i moduli in ingresso possono appartenere a uno dei diversi modelli.

Al termine del processo di training, è possibile iniziare a compilare il modello composto. Ecco i passaggi per la creazione e l'uso di modelli composti:

Raccogli gli ID modello

Quando si esegue il training dei modelli usando Document Intelligence Studio, l'ID modello si trova nel menu dei modelli in un progetto:

Screenshot della finestra di configurazione del modello in Document Intelligence Studio.

Comporre i modelli personalizzati

  1. Selezionare un progetto di modelli personalizzati.

  2. Nel progetto selezionare la voce di menu Models.

  3. Nell'elenco risultante dei modelli selezionare i modelli da comporre.

  4. Scegliere il pulsante Compose nell'angolo superiore sinistro.

  5. Nella finestra popup assegnare un nome al modello appena composto e selezionare Compose.

  6. Al termine dell'operazione, il modello appena composto viene visualizzato nell'elenco.

  7. Quando il modello è pronto, usare il comando Test per convalidarlo con i documenti di test e osservare i risultati.

Analizzare i documenti

L'operazione di analisi del modello personalizzato richiede di fornire modelID nella chiamata a Document Intelligence. È necessario specificare l'ID modello composto per il modelID parametro nelle applicazioni.

Screenshot di un ID modello composto in Document Intelligence Studio.

Gestire i modelli composti

È possibile gestire i modelli personalizzati in tutti i cicli di vita:

  • Testare e convalidare nuovi documenti.
  • Scaricare il modello da usare nelle applicazioni.
  • Eliminare il modello al termine del ciclo di vita.

Screenshot di un modello composto nel Document Intelligence Studio

Grande! Sono stati illustrati i passaggi per creare modelli personalizzati e composti e usarli nei progetti e nelle applicazioni di Document Intelligence.

Passaggi successivi

Prova uno degli avvii rapidi di Document Intelligence:

C#

Document Intelligence usa una tecnologia avanzata di Machine Learning per rilevare ed estrarre informazioni dalle immagini del documento e restituire i dati estratti in un output JSON strutturato. Con Document Intelligence è possibile eseguire il training di modelli personalizzati autonomi o combinare modelli personalizzati per creare modelli composti.

  • Modelli personalizzati. I modelli personalizzati di Document Intelligence consentono di analizzare ed estrarre dati da moduli e documenti specifici dell'azienda. I modelli personalizzati vengono addestrati per i tuoi dati specifici e casi d'uso.

  • Modelli composti. Un modello composto viene creato prendendo una collezione di modelli personalizzati e raggruppandoli in un unico modello che abbraccia i vostri tipi di modulo. Quando un documento viene inviato a un modello composto, il servizio esegue un passaggio di classificazione per decidere quale modello personalizzato rappresenta in modo accurato il modulo presentato per l'analisi.

In questo articolo viene illustrato come creare modelli personalizzati e composti di Document Intelligence usando lo strumento di etichettatura degli esempi di analisi dei documenti, le API REST o le librerie client.

Strumento di etichettatura di esempio

Provare a estrarre dati da moduli personalizzati usando lo strumento di etichettatura di esempio. Sono necessarie le risorse seguenti:

  • Una sottoscrizione Azure: è possibile crearne una gratuitamente

  • Istanza Document Intelligence nel portale di Azure. È possibile usare il piano tariffario gratuito (F0) per provare il servizio. Dopo la distribuzione della risorsa, selezionare Vai alla risorsa per ottenere la chiave e l'endpoint.

Screenshot delle chiavi e della posizione dell'endpoint nel portale di Azure.

Nell'interfaccia utente di Intelligenza Documentale:

  1. Selezionare Usa l'opzione Personalizzato per addestrare un modello con etichette e ottenere coppie chiave-valore.

Screenshot dello strumento 'FOTT' con l'opzione seleziona modello personalizzato.

  1. Nella finestra successiva selezionare Nuovo progetto:

Screenshot dello strumento 'FOTT' che mostra l'opzione di selezione di un nuovo progetto.

Crea i tuoi modelli

I passaggi per la compilazione, il training e l'uso di modelli personalizzati e composti sono i seguenti:

Assemblare il set di dati di training

La creazione di un modello personalizzato inizia con la definizione del set di dati di training. Per il set di dati di esempio sono necessari almeno cinque moduli completati dello stesso tipo. Possono essere di diversi tipi di file (jpg, png, pdf, tiff) e contengono sia testo che grafia. I moduli devono rispettare i requisiti di input per Document Intelligence.

Caricare il set di dati di training

È necessario caricare i dati di addestramento in un contenitore di archiviazione BLOB di Azure. Se non si sa come creare un account Azure storage con un contenitore, seeArchiviazione di Azure guida introduttiva per Azure portal. È possibile usare il piano tariffario gratuito (F0) per provare il servizio e eseguire l'aggiornamento in un secondo momento a un livello a pagamento per la produzione.

Addestrare il proprio modello personalizzato

Addestri il tuo modello con set di dati etichettati. I set di dati etichettati si basano sull'API di layout predefinita, ma l'input umano supplementare è incluso, come le vostre etichette specifiche e le posizioni dei campi. Inizia con almeno cinque moduli completati dello stesso tipo per i dati di addestramento etichettati.

Quando si esegue il training con dati etichettati, il modello usa l'apprendimento supervisionato per estrarre i valori di interesse, usando i moduli etichettati forniti. I dati etichettati generano modelli con prestazioni migliori e possono produrre modelli che funzionano con forme complesse o moduli contenenti valori senza chiavi.

Document Intelligence usa l'API Layout per apprendere le dimensioni e le posizioni previste del carattere tipografico e degli elementi di testo scritti a mano ed estrarre tabelle. Usa quindi le etichette specificate dall'utente per apprendere le associazioni chiave/valore e le tabelle nei documenti. È consigliabile usare cinque forme etichettate manualmente dello stesso tipo (stessa struttura) per iniziare a eseguire il training di un nuovo modello. Aggiungere altri dati etichettati in base alle esigenze per migliorare l'accuratezza del modello. Document Intelligence consente di eseguire il training di un modello per estrarre coppie chiave-valore e tabelle usando funzionalità di apprendimento supervisionate.

Introduzione al training con le etichette

[! VIDEO https://learn.microsoft.com/Shows/Docs-Azure/Azure-Form-Recognizer/player]

Creare un modello composto

Nota

Model Compose è disponibile solo per i modelli personalizzati addestrati con etichette. Il tentativo di comporre modelli senza etichetta genererà un errore.

Con l'operazione Model Compose è possibile assegnare fino a 200 modelli personalizzati sottoposti a training a un singolo ID modello. Quando si chiama Analizza con l'ID modello composto, Document Intelligence classifica il modulo inviato per primo, sceglie il modello assegnato più adatto e quindi restituisce i risultati per tale modello. Questa operazione è utile quando i moduli in ingresso possono appartenere a uno dei diversi modelli.

Usando lo strumento di etichettatura di esempio di Document Intelligence, l'API REST o le librerie client, seguire la procedura per configurare un modello composto:

  1. Raccogliere gli ID modello personalizzati
  2. Comporre i modelli personalizzati

Raccogliere gli ID modello personalizzati

Al termine del processo di training, al modello personalizzato viene assegnato un ID modello. È possibile recuperare un ID modello come segue:

Quando si esegue il training dei modelli usando lo strumento di etichettatura di esempio di Document Intelligence, l'ID modello si trova nella finestra Esegui training risultato:

Screenshot della finestra dei risultati del training.

Comporre i modelli personalizzati

Dopo aver raccolto i modelli personalizzati che corrispondono a un singolo tipo di modulo, è possibile componerli in un singolo modello.

Lo strumento di etichettatura campione consente di iniziare rapidamente ad addestrare modelli e comporli in un unico ID modello.

Al termine del training, comporre i modelli nel modo seguente:

  1. Nel menu a sinistra selezionare l'icona Model Compose (freccia di unione).

  2. Nella finestra principale selezionare i modelli da assegnare a un singolo ID modello. I modelli con l'icona delle frecce sono già modelli composti.

  3. Scegliere il pulsante Compose nell'angolo superiore sinistro.

  4. Nella finestra popup assegnare un nome al modello appena composto e selezionare Compose.

Al termine dell'operazione, il modello appena composto viene visualizzato nell'elenco.

Screenshot della finestra di composizione del modello.

Analizzare i documenti con il modello personalizzato o composto

L'operazione di analisi del modulo personalizzato richiede di fornire modelID nella chiamata a Document Intelligence. È possibile specificare un singolo ID modello personalizzato o un ID modello composto per il modelID parametro .

  1. Nel menu del riquadro sinistro dello strumento selezionare l'iconaAnalyze (lampadina).

  2. Scegliere un URL di file o immagine locale da analizzare.

  3. Selezionare il pulsante Esegui analisi .

  4. Lo strumento applica tag nei riquadri delimitatori e segnala la percentuale di confidenza per ogni tag.

Screenshot dello strumento Document Intelligence che analizza una finestra di un modulo personalizzato.

Testare i modelli appena sottoposti a training analizzando i moduli che non fanno parte del set di dati di training. A seconda dell'accuratezza segnalata, potrebbe essere necessario eseguire ulteriori training per migliorare il modello. È possibile continuare il training per migliorare i risultati.

Gestire i modelli personalizzati

È possibile gestire i modelli personalizzati durante tutto il ciclo di vita visualizzando un elenco di tutti i modelli personalizzati nella sottoscrizione, recuperando informazioni su un modello personalizzato specifico ed eliminando modelli personalizzati dall'account.

Grande! Sono stati illustrati i passaggi per creare modelli personalizzati e composti e usarli nei progetti e nelle applicazioni di Document Intelligence.

Passaggi successivi

Per altre informazioni sulla libreria client di Document Intelligence, vedere la documentazione di riferimento sulle API.