Configurar o aplicativo da Web

Cuidado: o Document AI Warehouse foi descontinuado e não estará mais disponível no Google Cloud após 16 de janeiro de 2025. Para proteger seus dados, migre todos os documentos salvos no Document AI Warehouse para uma alternativa como o Cloud Storage. Verifique se a migração de dados foi concluída antes da data de descontinuação para evitar a perda de dados. Consulte Descontinuações para mais detalhes.

Pré-lançamento

Este recurso está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Antes de começar

1. Você precisa ser o administrador do projeto para configurar o aplicativo da Web.

2. Siga o guia de início rápido para configurar as APIs necessárias, conceder permissões e provisionar as instâncias do seu projeto.

3. Para acessar o web app, preencha o seguinte formulário.

Configurar o projeto com o console Google Cloud

1. Na visualização de configurações da Document AI Warehouse, que é a visualização final após o provisionamento, clique em Mostrar detalhes.

   

2. Vá para a terceira etapa. Selecione Sim

   1. Se o projeto for provisionado com o modo de controle de acesso no nível do documento, crie uma conta de serviço e uma chave:

      1. Clique em Criar para criar uma conta de serviço.

         

      2. Depois que a conta de serviço for criada, clique em Criar para criar uma chave de conta de serviço.

         

      3. Clique no botão de download para salvar as credenciais da chave. Em seguida, clique em Conceder para conceder à sua conta e à conta de serviço o papel de administrador do Content Warehouse.

         

      4. Clique em Salvar configuração para salvar.

         

   2. Se o projeto usa o modo de acesso universal, clique diretamente em Salvar configuração:

      

3. Depois que a configuração for salva, vá para a última etapa e abra o link.

   

4. Na janela aberta, faça login.

   

5. Marque a primeira caixa de seleção para dar acesso aos seus dados Google Cloud ao Document AI Warehouse.

   

6. Se você estiver recebendo o CÓDIGO 400 (argumento inválido) ou 401 (escopos de autenticação insuficientes), saia clicando na seção do usuário no canto superior direito e faça login novamente para garantir que você tenha permissões do OAuth.

   

7. Se não for possível abrir o projeto como esperado, atualize a página após 3 a 5 minutos. A configuração salva leva tempo para ser propagada.

   

Configurar controles de acesso no nível do projeto

Observação: os usuários e grupos do Document AI Warehouse são autenticados pelo Cloud Identity. Todos os usuários e grupos do Document AI Warehouse precisam estar no Cloud Identity. A IAM permite sincronizar usuários e grupos do LDAP e do Active Directory do cliente. Para mais informações, consulte Como federar Google Cloud com o Active Directory.

Conceda controles de acesso (ACLs) no nível do projeto aos usuários. Há quatro funções do Document AI Warehouse, incluindo Document Creator, Document Viewer, Document Editor e Document Admin. As seguintes informações sobre as funções são importantes:

• A função Document Creator geralmente é concedida a todos os usuários, permitindo que eles criem documentos.

  • Recomendamos que você atribua esse papel a um grupo de usuários, como Doc Owners, que devem criar documentos no Document AI Warehouse e gerenciar o grupo.
  • O criador recebe automaticamente a função Document Admin no nível do documento por padrão.

• As funções Document Viewer, Document Editor e Document Admin precisam ser usadas com cuidado e concedidas apenas a administradores selecionados. Recomendamos conceder operadores temporariamente para necessidades de limpeza ou auditoria. Assim como esses papéis, os usuários têm permissões para visualizar, editar, compartilhar ou excluir todos os documentos do projeto.

• As ACLs no nível do documento podem ser concedidas posteriormente pelo Document Admin de cada documento.

Observação: conceda à sua conta o acesso de administrador de documentos no nível do projeto na guia Acesso.

Configurar esquemas

Configure o esquema para documentos e pastas. Um esquema de documento é usado para definir a estrutura do documento no warehouse da Document AI. Para mais informações sobre esquemas de documentos, consulte Gerenciar esquemas de documentos.

(Opcional) Processar documentos usando a Document AI

Os clientes podem mapear os processadores da Document AI para o esquema do Document AI Warehouse e usar os processadores da Document AI para extrair texto e dados. Ao fazer isso, quando os documentos são enviados com um esquema específico do Document AI Warehouse, o serviço usa o processador correspondente da Document AI para extrair as propriedades do documento com base no mapeamento. Para que isso funcione, confira os requisitos e as recomendações:

• Isso exige que os processadores da Document AI estejam no mesmo projeto.

• Para que os documentos enviados possam ser pesquisados por texto completo, recomendamos usar o processador de OCR da Document AI para tipos de documentos PDF que não têm processadores especializados. Em seguida, eles podem ser pesquisados por texto completo no Document AI Warehouse.

• Vários processadores podem ser mapeados para um esquema, e o usuário pode especificar qual processador usar para extração ao fazer upload de documentos.

  

• A cota de capacidade dos processadores da Document AI é menor (cerca de 10 qps). Portanto, os pipelines em lote ou vários cenários de upload de usuários simultâneos são executados mais lentamente do que a taxa de transferência de ingestão típica compatível com a API Create do Document AI Warehouse.

• Se você precisar usar modelos personalizados para classificação e extração, converta os dados extraídos em um formato JSON da API Document AI Warehouse e ingira os dados usando a API Create.

  

Solução de problemas

• Para que usuários sem função de administrador acessem o aplicativo da Web do Document AI Warehouse, peça ao administrador para adicionar você ao grupo da lista de permissões.

• Se você receber mensagens como "você não tem acesso ao Partner Dash", siga esta etapa para resolver o problema.

Próximas etapas

Para mais informações, saiba como fazer upload de documentos.