Este guia fornece todas as etapas de configuração necessárias para começar a usar a Document AI.
Sobre o Google Cloud console
O Google Cloud console é uma UI da Web usada para provisionar, configurar, gerenciar, e monitorar sistemas que usam Google Cloud produtos. Use o Google Cloud console para configurar e gerenciar recursos da Document AI.
Criar um projeto
Para usar os serviços fornecidos pelo Google Cloud, crie um projeto, que organiza todos os seus Google Cloud recursos e consiste nos seguintes componentes:
- Um grupo de colaboradores
- APIs ativadas (e outros recursos)
- Ferramentas de monitoramento
- Informações de faturamento
- Autenticação e controles de acesso
- Processadores da Document AI
É possível criar um projeto ou vários projetos. É possível usar seus projetos para organizar os Google Cloud recursos em uma hierarquia de recursos. Para mais informações sobre projetos, consulte a documentação do Resource Manager.
No Google Cloud console do, na página do seletor de projetos, escolha ou crie um Google Cloud projeto do.
Papéis necessários para selecionar ou criar um projeto
- Selecionar um projeto: a seleção de um projeto não exige um papel específico do IAM. É possível selecionar qualquer projeto em que você tenha recebido um papel.
-
Criar um projeto: para criar um projeto, é necessário ter o papel de criador de projetos
(
roles/resourcemanager.projectCreator), que contém aresourcemanager.projects.createpermissão. Saiba como conceder papéis.
Ativar a API
Você precisa ativar a API Document AI para seu projeto. Para mais informações sobre como ativar APIs, consulte a documentação do Service Usage.
Ativar a API Document AI.
Funções necessárias para ativar APIs
Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder
papéis.
Ativar faturamento
Uma conta de faturamento define quem paga por um determinado conjunto de recursos. As contas de faturamento podem ser vinculadas a um ou mais projetos. O uso do projeto é cobrado na conta de faturamento vinculada. Você configura o faturamento quando cria um projeto. Para mais informações, consulte a documentação de faturamento.
Verifique se o faturamento está ativado para o Google Cloud projeto.
Receber os papéis necessários
Para receber as permissões necessárias para conceder a um principal acesso a arquivos no Cloud Storage, peça ao administrador para conceder a você o papel do IAM de administrador do Storage (roles/storage.admin) no bucket.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.
Locais
A Document AI oferece algum controle sobre onde os recursos do seu projeto são armazenados e processados. Em particular, ao criar um processador, é necessário escolher um local para armazenar e processar os dados. Por padrão, a Document AI armazena e processa recursos em um local dos EUA. Se você escolher o local da União Europeia, seus dados e processos serão armazenados apenas na União Europeia.
Como definir o local usando a API
É necessário especificar o local do processador sempre que você enviar uma solicitação de processamento usando a API. Por exemplo, se o processador estiver configurado para armazenar e processar os dados na União Europeia, use o URI eu-documentai.googleapis.com da seguinte maneira:
Process |
|
batchProcess |
|
Instalar a biblioteca de cliente da API Document AI
Há opções para chamar a API Document AI:
- Bibliotecas de cliente compatíveis com o Google (recomendado)
- REST
- gRPC
As bibliotecas de cliente estão disponíveis para vários idiomas conhecidos. Para informações sobre como instalar as bibliotecas de cliente, consulte Bibliotecas de cliente da API Document AI.
Instale e inicialize a Google Cloud CLI.
A CLI gcloud fornece um conjunto de ferramentas que podem ser usadas para gerenciar recursos e aplicativos hospedados no Google Cloud.
O link a seguir fornece as instruções:
Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud initConfigurar a autenticação
Qualquer aplicativo cliente que usa a API precisa ser autenticado e receber acesso aos recursos solicitados. A configuração da autenticação depende se você está trabalhando em um ambiente de desenvolvimento local ou configurando um ambiente de produção. Para mais informações, consulte Configurar o Application Default Credentials.
Selecione as guias para definir como você quer acessar a API:
gcloud
Instale a Google Cloud CLI. Após a instalação, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud initBibliotecas de cliente
Para usar bibliotecas de cliente em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.
-
Instale a Google Cloud CLI.
-
Se você estiver usando um shell local, crie credenciais de autenticação local para sua conta de usuário:
gcloud auth application-default login
Não é necessário fazer isso se você estiver usando o Cloud Shell.
Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.
Saiba mais em Configurar o ADC para um ambiente de desenvolvimento local na documentação de autenticação do. Google Cloud
REST
Para usar a API REST em um ambiente de desenvolvimento local, use as credenciais que você vai informar à CLI gcloud.
Instale a Google Cloud CLI.
Saiba mais em Autenticar para usar REST na documentação de Google Cloud autenticação.
Para informações sobre como configurar a autenticação em um ambiente de produção, consulte Configurar o Application Default Credentials para código em execução em Google Cloud na documentação de autenticação. Google Cloud
Sobre os papéis
Quando um principal autenticado tenta acessar um Google Cloud recurso, o IAM verifica se o principal tem as permissões necessárias. Você concede permissões a principais concedendo papéis nas políticas de permissão do IAM. Para mais informações sobre principais, papéis, recursos e políticas de permissão, consulte a visão geral do IAM.
Siga o princípio de privilégio mínimo ao conceder papéis em Google Cloud recursos para principais. Não conceda a um principal mais permissões do que o necessário para concluir a solicitação. Para mais informações sobre as práticas recomendadas de controle de acesso, consulte Usar o IAM com segurança.
Para acessar recursos na Document AI, use um papel que tenha as permissões específicas necessárias. Para mais informações, consulte Permissões da Document AI e Papéis da Document AI.
Configuração de acesso a arquivos entre projetos
Ao configurar o processador da Document AI em um projeto, talvez você queira que esse projeto acesse arquivos de entrada armazenados em um projeto diferente na mesma organização que hospeda os processadores da Document AI.
Para permitir o acesso entre projetos, conceda o papel de Leitor de objetos do Storage
(roles/storage.objectViewer) ao agente de serviço da Document AI, conforme mostrado na figura a seguir.
Exemplo
- Suponha que o projeto A hospede processadores da Document AI e, opcionalmente, um bucket em que a saída do processador seja gravada.
- O projeto B é proprietário do bucket que contém arquivos de entrada para processadores da Document AI.
Para tornar os arquivos no projeto B acessíveis ao projeto A, conceda o papel de Leitor de objetos do Storage (
roles/storage.objectViewer) para o bucket de entrada no projeto B ao agente de serviço da Document AI do projeto A.
Para mais informações sobre o IAM e o papel de Leitor de objetos do Storage, consulte Papéis do IAM para o Cloud Storage.
Contas de serviço integradas
Um agente de serviço da Document AI segue esta convenção de nomenclatura:
service-{project number}@gcp-sa-prod-dai-core.iam.gserviceaccount.com
Exemplo: service-361747088407@gcp-sa-prod-dai-core.iam.gserviceaccount.com
Próximas etapas: casos de uso
Depois que a API Document AI for ativada, os processadores da Document AI poderão ser criados e usados. O tipo de processador mais adequado depende do seu caso de uso.