1. Panoramica

Che cos'è Procurement Document AI?
Le aziende gestiscono grandi pipeline di approvvigionamento, tra cui migliaia di fatture, ricevute e altri documenti correlati ogni anno. Utilizza Procurement DocAI per elaborare in modo intelligente i tuoi "dati oscuri" come PDF, immagini e moduli scritti a mano per ridurre il sovraccarico manuale del ciclo di vita dell'approvvigionamento. Automatizza l'acquisizione di dati di approvvigionamento su larga scala trasformando documenti non strutturati come fatture e scontrini in dati strutturati per migliorare l'efficienza operativa e l'esperienza del cliente, oltre che acquisire informazioni per il processo decisionale.
In questo codelab vedremo come configurare la piattaforma Document AI, elaborare una fattura di esempio, estrarre e visualizzare le entità in un notebook AI Platform.
Cosa imparerai a fare
- Come iniziare a utilizzare la piattaforma Document AI
- Estrarre entità schematizzate utilizzando la soluzione Procurement DocAI
- Crea e personalizza un'istanza di AI Platform Notebooks
Che cosa ti serve
Sondaggio
Come utilizzerai questo tutorial?
Come valuteresti la tua esperienza con Python?
Come valuti la tua esperienza di utilizzo dei servizi Google Cloud?
2. Configurazione e requisiti
Configurazione dell'ambiente autonomo
- Accedi alla console Cloud e crea un nuovo progetto o riutilizzane uno esistente. Se non hai già un account Gmail o G Suite, devi crearne uno.



Ricorda l'ID progetto, un nome univoco tra tutti i progetti Google Cloud. Il nome riportato sopra è già stato utilizzato e non funzionerà per te. Ci dispiace. Devi fornire questo ID in un secondo momento come PROJECT_ID.
- Successivamente, devi abilitare la fatturazione in Cloud Console per utilizzare le risorse Google Cloud.
Assicurati di seguire le istruzioni riportate nella sezione "Pulizia". La sezione ti consiglia come arrestare le risorse in modo che non vengano addebitati costi di fatturazione al termine di questo tutorial. I nuovi utenti di Google Cloud possono beneficiare del programma prova senza costi di 300$.
3. Abilita l'API Cloud Document AI
Prima di poter iniziare a utilizzare Document AI, devi abilitare l'API. Apri Cloud Console nel browser.
- Fai clic sul menu di navigazione ☰ > API e servizi > Libreria.

- Cerca "API Document AI", quindi fai clic su Abilita per utilizzare l'API nel tuo progetto Google Cloud.
4. Crea e testa un processore
Per questo tutorial, devi prima creare un'istanza del processore Form Parser da utilizzare in Document AI Platform.
- Nella console, vai alla panoramica della piattaforma Document AI.
- Fai clic su Crea processore e seleziona Analizzatore sintattico delle fatture

- Specifica un nome del processore e seleziona la tua regione dall'elenco.
- Fai clic su Crea per creare il processore.
- Copia l'ID processore. Lo dovrai utilizzare nel tuo codice in un secondo momento.
(Facoltativo) Puoi testare il processore nella console caricando un documento. Fai clic su Carica documento e seleziona un modulo da analizzare. Puoi scaricare e utilizzare questo modulo di esempio se non ne hai uno disponibile.

L'output dovrebbe essere simile al seguente: 
5. Creare un notebook AI Platform
Vai alla sezione AI Platform Notebooks della tua console Cloud e fai clic su Nuova istanza. Poi seleziona il tipo di istanza Python più recente:

Utilizza le opzioni predefinite e poi fai clic su Crea. Una volta creata l'istanza, seleziona Apri JupyterLab.
6. Richiedi il codice di esempio
Importa direttamente il codice campione dal repository GitHub di Document AI Notebooks. Nel notebook, vai a Git > Clona un repository nel menu in alto oppure fai clic sull'icona Git: 
Incolla il seguente URL del repository:
https://github.com/GoogleCloudPlatform/documentai-notebooks.git
Una volta clonato il repository, fai clic sulla directory documentai-notebooks/specialized/ e apri il notebook specialized_form_parser.ipynb. Trova la cella in cui sono dichiarati l'ID progetto GCP e l'ID processore di Document AI.

Incolla l'ID progetto GCP e l'ID processore del passaggio 4. Salva il notebook.
7. Estrarre e visualizzare le entità
Ora puoi estrarre le entità schematizzate dalle fatture e i relativi punteggi di confidenza. L'oggetto di risposta Document contiene un elenco di entità. Per saperne di più sulle entità schematizzate, leggi la guida rapida di Invoice Parser.
Esegui tutte le celle del notebook e scorri verso il basso fino all'output tabellare. Il codice precedente scorre ogni entità e crea un DataFrame Pandas con i risultati. 
Ora scorri verso il basso fino al componente di visualizzazione. La risposta dell'oggetto Document contiene informazioni sul layout spaziale di ogni pagina del documento. Di seguito, le informazioni sul layout di ciascun campo del modulo vengono utilizzate per disegnare i riquadri di selezione sull'immagine. Questi dati possono essere utilizzati per integrare Document AI in un'applicazione frontend.

8. Complimenti
Congratulazioni, hai utilizzato correttamente la soluzione Document AI per l'approvvigionamento per estrarre dati da una fattura. Ti invitiamo a sperimentare con altri tipi di moduli.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, puoi arrestare il notebook o eliminare il progetto GCP.
Arresto dell'istanza di AI Platform Notebooks
Segui queste istruzioni per arrestare un'istanza di AI Platform Notebooks.
Elimina il progetto
Il modo più semplice per eliminare la fatturazione è eliminare il progetto creato per il tutorial.
Per eliminare il progetto:
- Nella console di GCP, vai alla pagina Progetti. Pagina Progetti
- Nell'elenco dei progetti, seleziona quello da eliminare e fai clic su Elimina.
- Nella finestra di dialogo, digita l'ID progetto, quindi fai clic su Chiudi per eliminare il progetto.