Consulte os conectores compatíveis com a Application Integration.

Doc AI: tarefa operacional

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:

  1. Ative a API Cloud Document AI (documentai.googleapis.com) no seu projeto do Google Cloud antes de configurar a tarefa Doc AI - Operation.

    Ativar a API Document AI do Cloud

  2. Criar um perfil de autenticação. A Application Integration 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

  1. No console do Google Cloud, acesse a página Application Integration.

    Acessar o Application Integration

  2. No menu de navegação, clique em Integrações.

    A página Integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

  3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

    Se você estiver criando uma integração:

    1. Digite um nome e uma descrição no painel Create Integration.
    2. Selecione uma região para a integração.
    3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas.
    4. Clique em Criar.

    Isso abre a integração na página do editor de integração.

  4. Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas disponíveis.
  5. Clique e coloque o elemento Doc AI - Operação no editor de integração.
  6. Clique no elemento Doc AI - Operation no designer para ver o painel de configuração de tarefas Doc AI - Operation.
  7. 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.

  8. 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.
OperationIdString 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

  1. Adicione bordas e condições de borda.
  2. Teste e publique sua integração.
  3. Configure um gatilho.
  4. Adicione uma tarefa de mapeamento de dados.
  5. Confira todas as tarefas para os serviços do Google Cloud.