Distribuire lo Strumento di etichettatura campioni

Questo contenuto si applica a: v2.1.

Lo Strumento di etichettatura campioni di Document Intelligence è un'applicazione che fornisce un'interfaccia utente semplice, che è possibile usare per etichettare manualmente moduli (documenti) per l'apprendimento supervisionato. In questo articolo vengono forniti collegamenti e istruzioni che illustrano come:

• Eseguire lo Strumento di etichettatura campioni in locale
• Distribuire lo Strumento di etichettatura campioni in un'istanza di Azure Container
• Usare e contribuire allo strumento di etichettatura dei moduli open source

Eseguire lo Strumento di etichettatura campioni in locale

Il modo più rapido per avviare l'etichettatura dei dati consiste nell'eseguire lo Strumento di etichettatura campioni in locale. L'avvio rapido seguente usa l'API REST Document Intelligence e lo Strumento di etichettatura campioni per eseguire il training di un modello personalizzato con dati etichettati manualmente.

• Introduzione a Document Intelligence per intelligenza artificiale di Azure.

Eseguire la distribuzione con Istanze di Azure Container

Prima di iniziare, è importante notare che esistono due modi per distribuire lo Strumento di etichettatura campioni in un'istanza di Azure Container. Entrambe le opzioni vengono usate per eseguire lo Strumento di etichettatura campioni con un'istanza di Azure Container:

• Tramite il portale di Azure
• Con l'interfaccia della riga di comando di Azure

Azure portal

Seguire questa procedura per creare una nuova risorsa usando il portale di Azure:

1. Accedere al portale di Azure.

2. Selezionare Crea una risorsa.

3. Selezionare quindi App Web.

   

4. Assicurarsi prima di tutto che sia selezionata la scheda Informazioni di base. A questo punto, è necessario fornire alcune informazioni:

   

   • Sottoscrizione: selezionare una sottoscrizione di Azure esistente
   • Gruppo di risorse: è possibile riutilizzare un gruppo di risorse esistente o crearne uno nuovo per questo progetto. È consigliabile creare un nuovo gruppo di risorse.
   • Nome: assegnare un nome all'app Web.
   • Pubblica: selezionare Contenitore Docker
   • Sistema operativo: selezionare Linux
   • Area: scegliere un'area appropriata per l'utente.
   • Piano Linux: selezionare un piano tariffario/piano per il servizio app.

   

5. Selezionare quindi la scheda Docker.

   

6. A questo punto si configurerà il contenitore Docker. Tutti i campi sono obbligatori se non diversamente specificato:

• Opzioni: selezionare Contenitore singolo
• Origine immagine: selezionare Registro privato
• URL del server: impostare su https://mcr.microsoft.com
• Nome utente (facoltativo): creare un nome utente.
• Password (facoltativo): creare una password sicura che è possibile ricordare.
• Immagine e tag: impostare su mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1
• Distribuzione continua: impostare su On se si vogliono ricevere aggiornamenti automatici quando il team di sviluppo apporta modifiche allo Strumento di etichettatura campioni.
• Comando di avvio: impostare su ./run.sh eula=accept

• Selezionare quindi Rivedi e crea, quindi Crea per distribuire l'app Web. Al termine, è possibile accedere all'app Web con l'URL fornito in Panoramica per la risorsa.

Distribuzione continua

Dopo aver creato l'app Web, è possibile abilitare l'opzione di distribuzione continua:

• Nel riquadro sinistro scegliere Impostazioni contenitore.
• Nella finestra principale passare a Distribuzione continua e alternare tra i pulsanti On e Off per impostare le preferenze:

Interfaccia della riga di comando di Azure

In alternativa all'uso del portale di Azure, è possibile creare una risorsa usando l'interfaccia della riga di comando di Azure. Prima di continuare, è necessario installare l'interfaccia della riga di comando di Azure. È possibile ignorare questo passaggio se si usa già l'interfaccia della riga di comando di Azure.

Sono necessarie alcune informazioni su questo comando:

• DNS_NAME_LABEL=aci-demo-$RANDOM genera un'identità DNS (Domain Name System) casuale.
• In questo esempio si presuppone che sia disponibile un gruppo di risorse che è possibile usare per creare una risorsa. Sostituire <resource_group_name> con un gruppo di risorse valido associato alla sottoscrizione.
• È necessario specificare dove si vuole creare la risorsa. Sostituire <region name> con l'area desiderata per l'app Web.
• Questo comando accetta automaticamente il Contratto di licenza per l'utente finale (EULA).

Dall'interfaccia della riga di comando di Azure eseguire questo comando per creare una risorsa dell'app Web per lo Strumento di etichettatura campioni:

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"

Connettersi a Microsoft Entra ID per l'autorizzazione

È consigliabile connettere l'app Web a Microsoft Entra ID. Questa connessione garantisce che solo gli utenti con credenziali valide possano accedere e usare l'app Web. Seguire le istruzioni in Configurare l'app del Servizio app per connettersi a Microsoft Entra ID.

Open source in GitHub

È inoltre disponibile lo Strumento di etichettatura dei moduli come progetto open source in GitHub. Si tratta di un'applicazione Web creata con React + Redux e scritta in TypeScript. Per altre informazioni o per contribuire, vedere Strumento di etichettatura dei moduli.

Passaggi successivi

Usare l'avvio rapido Eseguire il training con le etichette per imparare a usare lo strumento per etichettare manualmente i dati di training ed eseguire l'apprendimento supervisionato.