L'attività Doc AI - Operation consente di controllare lo stato di un'operazione a lunga esecuzione (LRO) nel processore Document AI. Il processore Document AI crea un LRO ogni volta che invii una richiesta di elaborazione batch.
Cloud Document AI è un servizio di Google Cloud che consente di analizzare informazioni strutturate da documenti non strutturati o semi-strutturati utilizzando l'IA di Google all'avanguardia, come linguaggio naturale, visione artificiale, traduzione e AutoML.
Prima di iniziare
Assicurati di eseguire le attività seguenti nel tuo progetto Google Cloud prima di configurare l'attività Doc AI - Operation:
- Abilita l'API Cloud Document AI (
documentai.googleapis.com) nel tuo progetto Google Cloud prima di configurare l'attività Doc AI - Operation. - Crea un profilo di autenticazione. L'Apigee Integration utilizza un profilo di autenticazione per connettersi a un endpoint di autenticazione per l'attività Doc AI - Operation.
Per informazioni su come concedere ruoli o autorizzazioni aggiuntivi a un account di servizio, vedi Concessione, modifica e revoca dell'accesso.
Configura l'attività Operativa - Doc AI
- Nell'interfaccia utente di Apigee, seleziona la tua organizzazione Apigee.
- Fai clic su Sviluppa > Integrazioni.
- Seleziona un'integrazione esistente o creane una nuova facendo clic su Crea integrazione.
Se stai creando una nuova integrazione:
- Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
- Seleziona una regione per l'integrazione dall'elenco delle regioni supportate.
- Fai clic su Crea.
In questo modo viene aperta l'integrazione nel designer dell'integrazione.
- Nella barra di navigazione del designer dell'integrazione, fai clic su +Aggiungi un'attività/un trigger > Tasks per visualizzare l'elenco delle attività disponibili.
- Fai clic sull'elemento Doc AI - Operation e posizionalo nel designer dell'integrazione.
- Fai clic sull'elemento Doc AI - Operation sul designer per visualizzare il riquadro di configurazione delle attività Doc AI - Operation.
- Vai ad Autenticazione e seleziona un profilo di autenticazione esistente che vuoi utilizzare.
Facoltativo. Se non hai creato un profilo di autenticazione prima di configurare l'attività, fai clic su + Nuovo profilo di autenticazione e segui i passaggi descritti in Creare un nuovo profilo di autenticazione.
- Vai a Input attività e configura i campi di input visualizzati utilizzando la seguente tabella Parametri di input attività.
Le modifiche ai campi di immissione vengono salvate automaticamente.
Parametri di input dell'attività
La tabella seguente descrive i parametri di input dell'attività Doc AI - Operation:
| Proprietà | Tipo di dati | Descrizione |
|---|---|---|
| Regione | Stringa | Posizione di Cloud Document AI per il processore. Ad esempio: us - Stati Uniti. |
| ProjectsId | Stringa | L'ID del tuo progetto Google Cloud. |
| OperationId | Stringa | L'ID dell'operazione. L'ID è l'ultimo elemento del nome dell'operazione. |
Output attività
L'attività Doc AI - Operation restituisce i dettagli dell'operazione a lunga esecuzione (LRO), simili al seguente output di esempio:
{
"name": "projects/[PROJECT_ID]/locations/[LOCATION]/operations/[OPERATION_ID]",
"metadata": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.BatchProcessMetadata",
"state": "SUCCEEDED",
"stateMessage": "Processed 1 document(s) successfully",
"createTime": "TIMESTAMP",
"updateTime": "TIMESTAMP",
"individualProcessStatuses": [
{
"inputGcsSource": "[INPUT_BUCKET_FOLDER]/DOCUMENT1.ext",
"status": {},
"outputGcsDestination": "OUTPUT_BUCKET_FOLDER/[OPERATION_ID]/0",
"humanReviewStatus": {
"state": "ERROR",
"stateMessage": "Sharded document files are not supported for human review."
}
}
]
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.documentai.v1.BatchProcessResponse"
}
}
Strategia di gestione degli errori
Una strategia di gestione degli errori per un'attività specifica l'azione da intraprendere se l'attività non riesce a causa di un errore temporaneo. Per informazioni su come utilizzare una strategia di gestione degli errori e per conoscere i diversi tipi di strategie di gestione degli errori, consulta Strategie di gestione degli errori.
Passaggi successivi
- Aggiungi bordi e condizioni degli spigoli.
- Testa e pubblica l'integrazione.
- Configura un attivatore.
- Aggiungi un'attività di mappatura dei dati.
- Vedi tutte le attività per i servizi Google Cloud.