Het voorbeeldhulpprogramma voor labelen implementeren

Het Form Recognizer Voorbeeldhulpprogramma voor labelen is een toepassing die een eenvoudige gebruikersinterface (UI) biedt, die u kunt gebruiken om formulieren (documenten) handmatig te labelen voor leren onder supervisie. In dit artikel vindt u koppelingen en instructies voor het volgende:

Het voorbeeldhulpprogramma voor labelen lokaal uitvoeren

De snelste manier om gegevens te labelen, is door het voorbeeldhulpprogramma voor labelen lokaal uit te voeren. In de volgende quickstart worden de Form Recognizer REST API en het voorbeeldhulpprogramma voor labelen gebruikt om een aangepast model te trainen met handmatig gelabelde gegevens.

Implementeren met Azure Container Instances (ACI)

Voordat we aan de slag gaan, is het belangrijk om te weten dat er twee manieren zijn om het voorbeeldhulpprogramma voor labelen te implementeren in een Azure Container Instance (ACI). Beide opties worden gebruikt om het voorbeeldhulpprogramma voor labelen met ACI uit te voeren:

Azure Portal

Volg deze stappen om een nieuwe resource te maken met behulp van de Azure Portal:

  1. Meld u aan bij de Azure-portal.

  2. Selecteer Een resource maken.

  3. Selecteer vervolgens Web-app.

    Web-app selecteren

  4. Zorg er eerst voor dat het tabblad Basisinformatie is geselecteerd. Nu moet u enkele gegevens verstrekken:

    Basisbeginselen selecteren

    • Abonnement: selecteer een bestaand Azure-abonnement
    • Resourcegroep: u kunt een bestaande resourcegroep opnieuw gebruiken of een nieuwe maken voor dit project. Het wordt aanbevolen om een nieuwe resourcegroep te maken.
    • Naam: geef uw web-app een naam.
    • Publiceren - Selecteer Docker-container
    • Besturingssysteem: selecteer Linux
    • Regio: kies een regio die zinvol is voor u.
    • Linux-abonnement: selecteer een prijscategorie/abonnement voor uw app-service.

    Uw web-app configureren

  5. Selecteer vervolgens het tabblad Docker.

    Selecteer Docker

  6. Nu gaan we uw Docker-container configureren. Alle velden zijn vereist, tenzij anders vermeld:

  • Opties - Selecteer Enkele container
  • Bron van de afbeelding- Selecteer Privéregister
  • Server-URL: stel in op https://mcr.microsoft.com
  • Gebruikersnaam (optioneel) - Maak een gebruikersnaam.
  • Wachtwoord (optioneel) - Maak een veilig wachtwoord dat u kunt onthouden.
  • Afbeelding en tag : stel in op mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1
  • Doorlopende implementatie: stel deze functie in op Aan als u automatische updates wilt ontvangen wanneer het ontwikkelteam wijzigingen aan het voorbeeldhulpprogramma voor labelen aanzet.
  • Opstartopdracht: stel in op ./run.sh eula=accept

Docker configureren

  • Selecteer vervolgens Beoordelen en maken en vervolgens Maken om uw web-app te implementeren. Wanneer u klaar bent, hebt u toegang tot uw web-app via de URL die is opgegeven in Overzicht voor uw resource.

Doorlopende implementatie

Nadat u uw web-app hebt gemaakt, kunt u de optie continue implementatie inschakelen:

  • Kies containerinstellingen in het linkerdeelvenster.
  • Navigeer in het hoofdvenster naar Continue implementatie en schakel tussen de knoppen Aan en Uit om uw voorkeur in te stellen:

Schermopname: de containerinstellingen voor continue implementatie.

Notitie

Bij het maken van uw web-app kunt u ook autorisatie/verificatie configureren. Dit is niet nodig om aan de slag te gaan.

Belangrijk

Mogelijk moet u TLS inschakelen voor uw web-app om deze op het adres ervan weer te https geven. Volg de instructies in Enable a TLS endpoint to set up a sidecar container than enable TLS/SSL for your web app (TLS/SSL inschakelen voor uw web-app).

Azure CLI

Als alternatief voor het gebruik van Azure Portal kunt u een resource maken met behulp van de Azure CLI. Voordat u doorgaat, moet u de Azure CLI installeren. U kunt deze stap overslaan als u al met de Azure CLI werkt.

Er zijn enkele dingen die u moet weten over deze opdracht:

  • DNS_NAME_LABEL=aci-demo-$RANDOM genereert een willekeurige DNS-naam.
  • In dit voorbeeld wordt ervan uitgenomen dat u een resourcegroep hebt die u kunt gebruiken om een resource te maken. Vervang <resource_group_name> door een geldige resourcegroep die is gekoppeld aan uw abonnement.
  • U moet opgeven waar u de resource wilt maken. Vervang <region name> door de gewenste regio voor de web-app.
  • Met deze opdracht wordt de eula automatisch geaccepteerd.

Voer vanuit de Azure CLI deze opdracht uit om een web-app-resource te maken voor het voorbeeldhulpprogramma voor labelen:

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"

Verbinding maken azure ad voor autorisatie

Het is raadzaam om uw web-app te verbinden met Azure Active Directory (Azure AD). Deze verbinding zorgt ervoor dat alleen gebruikers met geldige referenties zich kunnen aanmelden en uw web-app kunnen gebruiken. Volg de instructies in Uw app configureren App Service verbinding te maken met Azure Active Directory.

Open source op GitHub

Het OCR-hulpprogramma voor formulierlabels is ook beschikbaar als een opensource-project op GitHub. Het hulpprogramma is een webtoepassing die is gebouwd React + Redux en is geschreven in TypeScript. Zie OCR Form Labeling Toolvoor meer informatie of bijdragen.

Volgende stappen

Gebruik de quickstart Trainen met labels voor meer informatie over het gebruik van het hulpprogramma om handmatig trainingsgegevens te labelen en onder supervisie te leren.