Primeiras etapas com o human-in-the-loop

Primeiras etapas com o human-in-the-loop

Cuidado: o human-in-the-loop do Document AI foi descontinuado e não vai estar mais disponível no Google Cloud após 16 de janeiro de 2025. Novos clientes não estão na lista de permissões. Se você quiser usar o HITL, mas não encontrar a opção disponível, entre em contato com sua Equipe de Contas do Google.

Para implementar uma solução de correção e revisão humana que atenda aos seus requisitos, recomendamos trabalhar com um parceiro certificado do Google Cloud , como Devoteam, Searce ou Quantiphi. Consulte Descontinuações para mais detalhes.

Este guia de início rápido apresenta o recurso human-in-the-loop. Neste guia de início rápido, você vai usar o console Google Cloud para configurar o projeto e a autorização Google Cloud , criar um processador e ativar a revisão humana nele.

---

Para seguir as instruções detalhadas desta tarefa diretamente no console do Google Cloud , clique em Orientação:

Orientações

---

Antes de começar

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Document AI, Cloud Storage, Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Document AI, Cloud Storage, Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Criar um processador

Observação: o fluxo de trabalho de revisão humana é compatível com os processadores listados na página de visão geral.

1. No Google Cloud menu de navegação do console, clique em Document AI e selecione Galeria de processadores. Galeria de processadores

2. Na Galeria de processadores, procure analisador de faturas e selecione Criar.

3. No menu Criar processador, insira um nome para o processador, como my-invoice-processor.

4. Selecione a região mais próxima de você.

5. Clique em Criar. Você será direcionado para a página de detalhes do processador recém-criado.

Ativar revisão humana no processador

1. Acesse a guia Human-in-the-Loop do processador.

2. Selecione Configurar human-in-the-loop

   

3. Na lista Selecionar especialistas, selecione Usar meus próprios especialistas

   Observação: a opção Google HITL workforce está na visualização particular e limitada a processar somente dados sem PII.

4. Na lista Pool de rotuladores, selecione Novo pool de especialistas.

   

5. Na caixa de diálogo pop-up, insira um Nome do pool, como My Labeler Pool.

   

6. Digite seu endereço de e-mail para os Administradores de pools e Especialistas.

7. Clique em Criar Pool. A ação vai levar alguns segundos para ser concluída.

8. (Opcional) Marque a caixa Ativar atribuição automática.

9. Marque a caixa Confirmar cobranças.

10. Na seção Definir filtros, selecione Filtro no nível do documento.

    1. (Opcional) Você também pode definir filtros no nível do marcador para filtrar com base em campos individuais.

11. Defina o Limite de confiança como 100%. Todos os documentos previstos para revisão humana serão enviados.

    

12. Na seção Adicionar instruções, insira o caminho do Cloud Storage a seguir no campo Local das instruções.

    Este é um PDF com instruções predefinidas para o analisador de faturas. Você também pode criar suas próprias instruções.

    cloud-samples-data/documentai/labeling-instructions/pretrained-invoice-v1.3-2022-07-15.pdf
    

13. No campo Local dos resultados, selecione ou crie um bucket para a saída da revisão humana.

14. Clique no botão Salvar configuração. O processo vai levar vários segundos para ser concluído.

    

15. Quando a configuração estiver concluída, selecione o controle deslizante Ativar human-in-the-loop.

    

16. Selecione Ativar na caixa de diálogo pop-up.

Você configurou o recurso human-in-the-loop em um analisador de fatura.

(Opcional) Gerenciar tarefas de rotulagem

1. Depois de configurar a revisão humana, você vai receber um e-mail semelhante a este:

   From: AI Platform <[e-mail]>\
   Subject: Added to AI Platform SpecialistPool Test Labeler Group
   
   Hello AI Platform Customer,
   
   You are added as a manager to specialist pool
   cloudml_data_specialists_us_central1_785484070008756xxxx.
   To view details, visit Manager console
   https://datacompute.google.com/cm/
   
   Sincerely,
   The Google Cloud AI Team
   

2. Siga as instruções em Concluir uma tarefa de revisão e Gerenciar tarefas de rotulagem para usar o console de revisão humana.

A seguir

• Conclua uma tarefa de revisão usando o console do rotulador.
• Confira uma lista e descrições dos processadores disponíveis no momento.