Implantar a ferramenta de rotulagem de exemplo

Este conteúdo aplica-se a: v2.1.

A ferramenta Document Intelligence Sample Labeling é um aplicativo que fornece uma interface de usuário (UI) simples, que você pode usar para rotular manualmente formulários (documentos) para aprendizagem supervisionada. Neste artigo, fornecemos links e instruções que ensinam como:

• Execute a ferramenta de rotulagem de exemplo localmente
• Implantar a ferramenta de Rotulagem de Exemplo em uma Instância de Contêiner do Azure (ACI)
• Use e contribua para a Ferramenta de Etiquetagem de Formulários de código aberto

Execute a ferramenta de rotulagem de exemplo localmente

A maneira mais rápida de começar a rotular dados é executar a ferramenta de rotulagem de exemplo localmente. O guia de início rápido a seguir usa a API REST do Document Intelligence e a ferramenta Rótulo de exemplo para treinar um modelo personalizado com dados rotulados manualmente.

• Introdução ao Azure AI Document Intelligence.

Implantar com instâncias de contêiner do Azure (ACI)

Antes de começarmos, é importante observar que há duas maneiras de implantar a ferramenta de Rotulagem de Exemplo em uma Instância de Contêiner do Azure (ACI). Ambas as opções são usadas para executar a ferramenta Rotulagem de exemplo com ACI:

• Utilizar o portal do Azure
• Com a CLI do Azure

Portal do Azure

Siga estas etapas para criar um novo recurso usando o portal do Azure:

1. Inicie sessão no portal do Azure.

2. Selecione Criar um recurso.

3. Em seguida, selecione Aplicativo Web.

   

4. Primeiro, certifique-se de que a guia Noções básicas está selecionada. Agora, você vai precisar fornecer algumas informações:

   

   • Subscrição - Selecione uma subscrição existente do Azure
   • Grupo de Recursos - Você pode reutilizar um grupo de recursos existente ou criar um novo para este projeto. Recomenda-se a criação de um novo grupo de recursos.
   • Nome - Dê um nome ao seu aplicativo Web.
   • Publicar - Selecionar contêiner do Docker
   • Sistema Operacional - Selecione Linux
   • Região - Escolha uma região que faça sentido para si.
   • Plano Linux - Selecione uma camada/plano de preço para o seu serviço de aplicativo.

   

5. Em seguida, selecione a guia Docker .

   

6. Agora vamos configurar seu contêiner do Docker. Todos os campos são obrigatórios, salvo indicação em contrário:

• Opções - Selecione Contêiner Único
• Fonte da imagem - Selecione o registro privado
• URL do servidor - Definir como https://mcr.microsoft.com
• Nome de usuário (opcional) - Crie um nome de usuário.
• Senha (Opcional) - Crie uma senha segura que você possa lembrar.
• Imagem e tag - Definir como mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1
• Implantação contínua - Defina como Ativado se quiser receber atualizações automáticas quando a equipe de desenvolvimento fizer alterações na ferramenta Rotulagem de exemplo.
• Comando de inicialização - Definir como ./run.sh eula=accept

• Em seguida, selecione Rever + Criar e, em seguida , Criar para implementar a sua aplicação Web. Quando terminar, você poderá acessar seu aplicativo Web na URL fornecida na Visão geral do seu recurso.

Implementação contínua

Depois de criar seu aplicativo Web, você pode habilitar a opção de implantação contínua:

• No painel esquerdo, escolha Configurações do contêiner.
• Na janela principal, navegue até Implantação contínua e alterne entre os botões Ativado e Desativado para definir sua preferência:

CLI do Azure

Como alternativa ao uso do portal do Azure, você pode criar um recurso usando a CLI do Azure. Antes de continuar, você precisa instalar a CLI do Azure. Pode ignorar este passo se já estiver a trabalhar com a CLI do Azure.

Há algumas coisas que você precisa saber sobre este comando:

• DNS_NAME_LABEL=aci-demo-$RANDOM gera uma identidade aleatória de DNS (Sistema de Nomes de Domínio).
• Este exemplo pressupõe que você tenha um grupo de recursos que possa ser usado para criar um recurso. Substitua <resource_group_name> por um grupo de recursos válido associado à sua assinatura.
• Você precisa especificar onde deseja criar o recurso. Substitua <region name> pela região desejada para o aplicativo Web.
• Este comando aceita automaticamente o Contrato de Licença de Usuário Final (EULA).

Na CLI do Azure, execute este comando para criar um recurso de aplicativo Web para a ferramenta Rotulagem de Exemplo:

DNS_NAME_LABEL=aci-demo-$RANDOM

az container create \
  --resource-group <resource_group_name> \
  --name <name> \
  --image mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1 \
  --ports 3000 \
  --dns-name-label $DNS_NAME_LABEL \
  --location <region name> \
  --cpu 2 \
  --memory 8 \
  --command-line "./run.sh eula=accept"

Conectar-se ao Microsoft Entra ID para autorização

Recomendamos que você conecte seu aplicativo Web ao Microsoft Entra ID. Essa conexão garante que apenas usuários com credenciais válidas possam entrar e usar seu aplicativo Web. Siga as instruções em Configurar seu aplicativo do Serviço de Aplicativo para se conectar à ID do Microsoft Entra.

Código aberto no GitHub

A Form Labeling Tool também está disponível como um projeto de código aberto no GitHub. A ferramenta é uma aplicação web construída usando React + Redux, e é escrita em TypeScript. Para saber mais ou contribuir, consulte Ferramenta de etiquetagem de formulário.

Próximos passos

Use o Guia de início rápido Treinar com rótulos para aprender a usar a ferramenta para rotular manualmente os dados de treinamento e realizar o aprendizado supervisionado.