Implementación de la herramienta de etiquetado de ejemploDeploy the sample labeling tool

La herramienta de etiquetado de ejemplo de Form Recognizer es una aplicación que proporciona una interfaz de usuario simple (IU), que puede usar para etiquetar manualmente los formularios (documentos) de cara al aprendizaje supervisado.The Form Recognizer sample labeling tool is an application that provides a simple user interface (UI), which you can use to manually label forms (documents) for the purpose of supervised learning. En este artículo, se proporcionan vínculos e instrucciones que le enseñarán a:In this article, we'll provide links and instructions that teach you how to:

Ejecución de la herramienta de etiquetado de ejemplo de manera localRun the sample labeling tool locally

La manera más rápida de empezar a etiquetar los datos es ejecutar la herramienta de etiquetado de ejemplo de manera local.The fastest way to start labeling data is to run the sample labeling tool locally. En el siguiente inicio rápido, usará la API REST de Form Recognizer con la herramienta de etiquetado de ejemplo para entrenar un modelo personalizado con datos etiquetados manualmente.The following quickstart uses the Form Recognizer REST API and the sample labeling tool to train a custom model with manually labeled data.

Implementación con Azure Container Instances (ACI)Deploy with Azure Container Instances (ACI)

Antes de comenzar, es importante tener en cuenta que hay dos maneras de implementar la herramienta de etiquetado de ejemplo en una instancia de Azure Container Instances (ACI).Before we get started, it's important to note that there are two ways to deploy the sample labeling tool to an Azure Container Instance (ACI). Ambas opciones se usan para ejecutar la herramienta de etiquetado de ejemplo con ACI:Both options are used to run the sample labeling tool with ACI:

Azure PortalAzure portal

Siga estos pasos para crear un recurso mediante Azure Portal:Follow these steps to create a new resource using the Azure portal:

  1. Inicie sesión en Azure Portal.Sign in to the Azure portal.

  2. Seleccione Crear un recurso.Select Create a resource.

  3. Luego, seleccione Aplicación web.Next, select Web App.

    Selección de Aplicación webSelect web app

  4. En primer lugar, asegúrese de que la pestaña Aspectos básicos está seleccionada.First, make sure that the Basics tab is selected. Ahora, tendrá que proporcionar algo de información:Now, you're going to need to provide some information:

    Selección de Aspectos básicosSelect Basics

    • Suscripción: seleccione una suscripción de Azure existente.Subscription - Select an existing Azure subscription
    • Grupo de recursos: puede usar un grupo de recursos existente o crear uno para este proyecto.Resource Group - You can reuse an existing resource group or create a new one for this project. Se recomienda la segunda opción.Creating a new resource group is recommended.
    • Nombre: asigne un nombre a la aplicación web.Name - Give your web app a name.
    • Publicar: seleccione Contenedor de Docker.Publish - Select Docker Container
    • Sistema operativo: seleccione Linux.Operating System - Select Linux
    • Región: elija una región que sea significativa para usted.Region - Choose a region that makes sense for you.
    • Linux Plan (Plan de Linux): seleccione un plan de tarifa para su servicio de aplicación.Linux Plan - Select a pricing tier/plan for your app service.

    Configuración de la aplicación webConfigure your web app

  5. A continuación, seleccione la pestaña Docker.Next, select the Docker tab.

    Selección de DockerSelect Docker

  6. Ahora vamos a configurar el contenedor de Docker.Now let's configure your Docker container. Todos los campos son obligatorios a menos que se indique lo contrario:All fields are required unless otherwise noted:

  • Opciones: seleccione Contenedor único.Options - Select Single Container

  • Origen de imagen: seleccione Registro privado.Image Source - Select Private Registry

  • URL de servidor: establézcalo en https://mcr.microsoft.com.Server URL - Set this to https://mcr.microsoft.com

  • Nombre de usuario (opcional): cree un nombre de usuario.Username (Optional) - Create a username.

  • Contraseña (opcional): cree una contraseña segura que recuerde.Password (Optional) - Create a secure password that you'll remember.

  • Imagen y etiqueta: establézcalo en mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest.Image and tag - Set this to mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest

  • Implementación continua: establezca esta opción en Activado si quiere recibir actualizaciones automáticas cuando el equipo de desarrollo realice cambios en la herramienta de etiquetado de ejemplo.Continuous Deployment - Set this to On if you want to receive automatic updates when the development team makes changes to the sample labeling tool.

  • Comando de inicio: establézcalo en ./run.sh eula=accept.Startup command - Set this to ./run.sh eula=accept

  • Opciones: seleccione Contenedor único.Options - Select Single Container

  • Origen de imagen: seleccione Registro privado.Image Source - Select Private Registry

  • URL de servidor: establézcalo en https://mcr.microsoft.com.Server URL - Set this to https://mcr.microsoft.com

  • Nombre de usuario (opcional): cree un nombre de usuario.Username (Optional) - Create a username.

  • Contraseña (opcional): cree una contraseña segura que recuerde.Password (Optional) - Create a secure password that you'll remember.

  • Imagen y etiqueta: establézcalo en mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-preview.Image and tag - Set this to mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-preview

  • Implementación continua: establezca esta opción en Activado si quiere recibir actualizaciones automáticas cuando el equipo de desarrollo realice cambios en la herramienta de etiquetado de ejemplo.Continuous Deployment - Set this to On if you want to receive automatic updates when the development team makes changes to the sample labeling tool.

  • Comando de inicio: establézcalo en ./run.sh eula=accept.Startup command - Set this to ./run.sh eula=accept


    Configurar DockerConfigure Docker

  1. Eso es todo.That's it. A continuación, seleccione Revisar + crear y, luego, Crear para implementar la aplicación web.Next, select Review + Create, then Create to deploy your web app. Cuando haya finalizado, puede acceder a la aplicación web en la dirección URL proporcionada en la pestaña Información general del recurso.When complete, you can access your web app at the URL provided in the Overview for your resource.

Nota

Al crear la aplicación web, también puede configurar la autorización o autenticación.When creating your web app, you can also configure authorization/authentication. Esto no es necesario para comenzar.This is not necessary to get started.

Importante

Es posible que tenga que habilitar TLS para la aplicación web para verla en su dirección https.You may need to enable TLS for your web app in order to view it at its https address. Siga las instrucciones que se indican en Habilitación de un punto de conexión de TLS para configurar un contenedor de tipo sidecar que habilite TLS/SSL para la aplicación web.Follow the instructions in Enable a TLS endpoint to set up a sidecar container than enables TLS/SSL for your web app.

Azure CLIAzure CLI

Como alternativa al uso de Azure Portal, puede crear un recurso mediante la CLI de Azure.As an alternative to using the Azure portal, you can create a resource using the Azure CLI. Antes de continuar, deberá instalar la CLI de Azure.Before you continue, you'll need to install the Azure CLI. Si ya está trabajando con la CLI de Azure, puede omitir este paso.You can skip this step if you're already working with the Azure CLI.

Hay algunas cosas que necesita saber sobre este comando:There's a few things you need know about this command:

  • DNS_NAME_LABEL=aci-demo-$RANDOM genera un nombre DNS aleatorio.DNS_NAME_LABEL=aci-demo-$RANDOM generates a random DNS name.
  • En este ejemplo se da por hecho que tiene un grupo de recursos que puede usar para crear un recurso.This sample assumes that you have a resource group that you can use to create a resource. Reemplace <resource_group_name> por un grupo de recursos válido asociado a su suscripción.Replace <resource_group_name> with a valid resource group associated with your subscription.
  • Deberá especificar dónde desea crear el recurso.You'll need to specify where you want to create the resource. Reemplace <region name> por la región deseada para la aplicación web.Replace <region name> with your desired region for the web app.
  • Este comando acepta automáticamente el CLUF.This command automatically accepts EULA.

En la CLI de Azure, ejecute este comando para crear un recurso de aplicación web para la herramienta de etiquetado de ejemplo:From the Azure CLI, run this command to create a web app resource for the sample labeling tool:

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 \
  --ports 3000 \
  --dns-name-label $DNS_NAME_LABEL \
  --location <region name> \
  --cpu 2 \
  --memory 8 \
  --command-line "./run.sh eula=accept"
`

# [v2.1 preview](#tab/v2-1) 
   
```azurecli
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-preview \
  --ports 3000 \
  --dns-name-label $DNS_NAME_LABEL \
  --location <region name> \
  --cpu 2 \
  --memory 8 \
  --command-line "./run.sh eula=accept"

Conexión a Azure AD para la autorizaciónConnect to Azure AD for authorization

Se recomienda conectar la aplicación web a Azure Active Directory.It's recommended that you connect your web app to Azure Active Directory. De esta forma se garantiza que solo los usuarios con credenciales válidas pueden iniciar sesión en la aplicación web y usarla.This ensures that only users with valid credentials can sign in and use your web app. Siga las instrucciones que se indican en Configuración de la aplicación de App Service para conectarse a Azure Active Directory.Follow the instructions in Configure your App Service app to connect to Azure Active Directory.

Código fuente en DockerOpen source on GitHub

OCR Form Labeling Tool también está disponible como proyecto de código abierto en GitHub.The OCR Form Labeling Tool is also available as an open-source project on GitHub. La herramienta es una aplicación web compilada mediante React + Redux y está escrita en TypeScript.The tool is a web application built using React + Redux, and is written in TypeScript. Para más información o para contribuir, consulte OCR Form Labeling Tool.To learn more or contribute, see OCR Form Labeling Tool.

Pasos siguientesNext steps

Use el inicio rápido Entrenamiento con etiquetas para aprender a usar la herramienta para etiquetar manualmente los datos de entrenamiento y realizar aprendizaje supervisado.Use the Train with labels quickstart to learn how to use the tool to manually label training data and perform supervised learning.