A tarefa Doc AI - Operation permite verificar o status de uma operação de longa duração (LRO, na sigla em inglês) no processador da Document AI. O processador da Document AI cria uma LRO sempre que você envia uma solicitação de processamento em lote.
O Cloud Document AI é um serviço do Google Cloud que permite analisar informações estruturadas de documentos não estruturados ou semiestruturados usando IA de ponta do Google, como linguagem natural, visão computacional, tradução e AutoML
Antes de começar
Verifique se você executa as seguintes tarefas no projeto do Google Cloud antes de configurar a tarefa Doc AI - Operation:
- Ative a API Cloud Document AI (
documentai.googleapis.com) no seu projeto do Google Cloud antes de configurar a tarefa Doc AI - Operation. - Criar um perfil de autenticação. A integração da Apigee usa um perfil de autenticação para se conectar a um endpoint de autenticação para a tarefa Doc AI - Operation.
Para informações sobre como conceder papéis ou permissões adicionais a uma conta de serviço, consulte Como conceder, alterar e revogar acesso.
Configurar a tarefa de operação do Doc AI
- Na IU da Apigee, selecione sua organização da Apigee.
- Clique em Desenvolver > Integrações.
- Selecione uma integração existente ou clique em Criar integração.
Caso você esteja criando uma nova integração, siga estas etapas:
- Digite um nome e uma descrição na caixa de diálogo Criar integração.
- Selecione uma Região para a integração na lista de regiões compatíveis.
- Clique em Criar.
Isso abre a integração na página do designer de integração.
- Na barra de navegação do designer de integração, clique em +Adicionar uma tarefa/gatilho> Tarefas para ver a lista de tarefas disponíveis.
- Clique e coloque o elemento Doc AI - Operation no designer de integração.
- Clique no elemento Doc AI - Operation no designer para ver o painel de configuração de tarefas Doc AI - Operation.
- Acesse Autenticação e selecione o perfil de autenticação que você quer usar.
Opcional. Se você não tiver criado um perfil de autenticação antes de configurar a tarefa, clique em + Novo perfil de autenticação e siga as etapas em Criar um novo perfil de autenticação.
- Acesse Entrada de tarefas e configure os campos de entrada exibidos com a tabela Parâmetros de entrada de tarefas.
As mudanças nos campos de entrada são salvas automaticamente.
Parâmetros de entrada da tarefa
A tabela a seguir descreve os parâmetros de entrada da tarefa Doc AI - Operation:
| Propriedade | Tipo de dados | Descrição |
|---|---|---|
| Região | String | Local do Cloud Document AI para o processador. Por exemplo: us - Estados Unidos. |
| ProjectsId | String | É o ID do seu projeto no Google Cloud. |
| OperationId | String | O ID da operação. Ele é o último elemento do nome da operação. |
Saída da tarefa
A tarefa Doc AI - Operation retorna os detalhes da operação de longa duração (LRO, na sigla em inglês), semelhante ao seguinte exemplo de saída:
{
"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"
}
}
Estratégia de solução de erros
A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.
A seguir
- Adicione bordas e condições de borda.
- Teste e publique sua integração.
- Configure um gatilho.
- Adicione uma tarefa de mapeamento de dados.
- Confira todas as tarefas para os serviços do Google Cloud.