Het voorbeeldhulpprogramma voor labelen implementeren

Deze inhoud is van toepassing op: v2.1.

Tip

• Voor een verbeterde ervaring en geavanceerde modelkwaliteit kunt u Document Intelligence v3.0 Studio gebruiken.
• V3.0 Studio ondersteunt elk model dat is getraind met v2.1 gelabelde gegevens.
• Raadpleeg de API-migratiehandleiding voor gedetailleerde informatie over het migreren van v2.1 naar v3.0.
• Bekijk onze quickstarts voor REST API of C#, Java, JavaScript of Python SDK om aan de slag te gaan met de versie v3.0.

Notitie

Het hulpprogramma voor gehoste labels in de cloud is beschikbaar op https://fott-2-1.azurewebsites.net/. Volg de stappen in dit document alleen als u het hulpprogramma Voorbeeldlabels voor uzelf wilt implementeren.

Het hulpprogramma Document Intelligence Sample Labeling is een toepassing die een eenvoudige gebruikersinterface (UI) biedt, waarmee u formulieren (documenten) handmatig kunt labelen voor leren onder supervisie. In dit artikel vindt u koppelingen en instructies waarmee u het volgende kunt doen:

• Het voorbeeldhulpprogramma voor labelen lokaal uitvoeren
• Het voorbeeldhulpprogramma voor labelen implementeren in een Azure Container Instance (ACI)
• Het opensource-hulpprogramma voor formulierlabels gebruiken en hieraan bijdragen

Het voorbeeldhulpprogramma voor labelen lokaal uitvoeren

De snelste manier om gegevens te labelen is door het hulpprogramma Voorbeeldlabeling lokaal uit te voeren. In de volgende quickstart worden de Document Intelligence REST API en het hulpprogramma Voorbeeldlabels gebruikt om een aangepast model te trainen met handmatig gelabelde gegevens.

• Aan de slag met Azure AI Document Intelligence.

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 hulpprogramma Voorbeeldlabeling uit te voeren met ACI:

• Met behulp van Azure Portal
• Met behulp van de Azure CLI

Azure Portal

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

1. Meld u aan bij het Azure-portaal.

2. Selecteer Een resource maken.

3. Selecteer vervolgens Web-app.

   

4. Controleer eerst of het tabblad Basisinformatie is geselecteerd. Nu moet u wat informatie opgeven:

   

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

   

5. Selecteer vervolgens het tabblad Docker .

   

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

• Opties - Eén container selecteren
• Bron van installatiekopieën - Privéregister selecteren
• Server-URL - ingesteld op https://mcr.microsoft.com
• Gebruikersnaam (optioneel): maak een gebruikersnaam.
• Wachtwoord (optioneel): maak een beveiligd wachtwoord dat u kunt onthouden.
• Afbeelding en tag - ingesteld op mcr.microsoft.com/azure-cognitive-services/custom-form/labeltool:latest-2.1
• Continue implementatie: stel deze optie in op Aan als u automatische updates wilt ontvangen wanneer het ontwikkelteam wijzigingen aanbrengt in het hulpprogramma Voorbeeldlabels.
• Opstartopdracht - Instellen op ./run.sh eula=accept

• Selecteer vervolgens Beoordelen en maken en vervolgens Maken om uw web-app te implementeren. Als u klaar bent, hebt u toegang tot uw web-app via de URL in het overzicht voor uw resource.

Doorlopende implementatie

Nadat u uw web-app hebt gemaakt, kunt u de optie voor 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:

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 voor uw web-app inschakelen om deze op het https adres ervan weer te geven. Volg de instructies in Een TLS-eindpunt inschakelen om een sidecar-container in te stellen dan TLS/SSL inschakelt 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-identiteit (Domain Name System).
• In dit voorbeeld wordt ervan uitgegaan dat u een resourcegroep hebt die u kunt gebruiken om een resource te maken. Vervang door <resource_group_name> een geldige resourcegroep die is gekoppeld aan uw abonnement.
• U moet opgeven waar u de resource wilt maken. Vervang door <region name> de gewenste regio voor de web-app.
• Met deze opdracht wordt automatisch gebruiksrechtovereenkomst (EULA) 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 met Microsoft Entra-id voor autorisatie

U wordt aangeraden uw web-app te verbinden met Microsoft Entra ID. 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 Service-app configureren om verbinding te maken met Microsoft Entra-id.

Open source op GitHub

Het hulpprogramma voor formulierlabels is ook beschikbaar als een opensource-project op GitHub. Het hulpprogramma is een webtoepassing die is gebouwd met React + Redux en is geschreven in TypeScript. Zie het hulpmiddel Formulierlabels voor meer informatie of bijdragen.

Volgende stappen

Gebruik de quickstart Trainen met labels om te leren hoe u het hulpprogramma kunt gebruiken om trainingsgegevens handmatig te labelen en onder supervisie te leren.