Condividi tramite

Distribuire lo Strumento di etichettatura campioni

  • Articolo

Questo contenuto si applica a: Segno di spunta di Document Intelligence v2.1 v2.1.

Suggerimento

Nota

Lo strumento di etichettatura ospitato nel cloud è disponibile all'indirizzo https://fott-2-1.azurewebsites.net/. Seguire la procedura descritta in questo documento solo se si vuole distribuire manualmente lo Strumento di etichettatura campioni.

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

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.

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:

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.

    Selezionare l'app Web

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

    Selezionare Nozioni di base

    • 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.

    Configurare l'app Web

  5. Selezionare quindi la scheda Docker.

    Selezionare 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

Configurare Docker

  • 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:

Screenshot dell'ingrandimento delle impostazioni del contenitore per la distribuzione continua.

Nota

Quando si crea l'app Web, è anche possibile configurare l'autorizzazione/autenticazione. Questa operazione non è necessaria per iniziare.

Importante

Potrebbe essere necessario abilitare TLS per l'app Web per la visualizzazione all'indirizzo https. Seguire le istruzioni riportate in Abilitare un endpoint TLS per configurare un contenitore collaterale che abilita TLS/SSL per l'app Web.

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.