Installera och köra Formigenkänning v2.1-containrar

Den här artikeln gäller för bockmarkeringen:Formigenkänning v2.1Formigenkänning v2.1.

Azure Formigenkänning är en Azure Applied AI-tjänst som gör att du kan skapa automatiserad databearbetningsprogramvara med maskininlärningsteknik. Formigenkänning kan du identifiera och extrahera text, nyckel/värde-par, urvalsmarkeringar, tabelldata med mera från formulärdokumenten. Resultaten levereras som strukturerade data som innehåller relationerna i den ursprungliga filen.

I den här artikeln får du lära dig hur du laddar ned, installerar och kör Formigenkänning containrar. Med containrar kan du köra Formigenkänning-tjänsten i din egen miljö. Containrar är bra för specifika säkerhets- och datastyrningskrav. Formigenkänning funktioner stöds av sex Formigenkänning-funktionscontainrar – Layout, Visitkort, ID-dokument, Kvitto, Faktura och Anpassad (för kvitto-, visitkorts- och ID-dokumentcontainrar behöver du även Read OCR-containern).

Krav

För att komma igång behöver du ett aktivt Azure-konto. Om du inte har ett konto kan du skapa ett kostnadsfritt konto.

Du behöver också följande för att använda Formigenkänning containrar:

Obligatorisk Syfte
Kunskaper om Docker Du bör ha grundläggande kunskaper om Docker-begrepp som register, lagringsplatser, containrar och containeravbildningar samt kunskaper om grundläggande dockerterminologi och kommandon.
Docker Engine installerat
  • Du behöver Docker-motorn installerad på en värddator. Docker innehåller paket som konfigurerar Docker-miljön på macOS, Windows och Linux. En introduktion till grunderna för Docker och containrar finns i Docker-översikt.
  • Docker måste konfigureras så att containrarna kan ansluta till och skicka faktureringsdata till Azure.
  • I Windows måste Docker också konfigureras för att stödja Linux-containrar .
Formigenkänning resurs En Azure-Formigenkänning med en tjänst eller en Cognitive Services-resurs med flera tjänster i Azure Portal. Om du vill använda containrarna måste du ha den associerade nyckeln och slutpunkts-URI:n. Båda värdena är tillgängliga på sidan Azure Portal Formigenkänning Nycklar och Slutpunkt:
  • {FORM_RECOGNIZER_KEY}: en av de två tillgängliga resursnycklarna.
  • {FORM_RECOGNIZER_ENDPOINT_URI}: slutpunkten för resursen som används för att spåra faktureringsinformation.
Visuellt innehåll API-resurs Om du vill bearbeta visitkort, ID-dokument eller kvitton behöver du en Visuellt innehåll resurs.
  • Du kan komma åt funktionen Identifiera text som antingen en Azure-resurs (REST API eller SDK) eller en cognitive-services-recognize-text-container. De vanliga faktureringsavgifterna gäller.
  • Om du använder containern cognitive-services-recognize-text kontrollerar du att din Visuellt innehåll nyckel för Formigenkänning-containern är nyckeln som anges i Visuellt innehåll docker run eller docker compose kommandot för containern cognitive-services-recognize-text och att din faktureringsslutpunkt är containerns slutpunkt (till exempel http://localhost:5000). Om du använder både Visuellt innehåll-containern och Formigenkänning containern tillsammans på samma värd kan de inte båda startas med standardporten 5000.

Skicka både nyckeln och slutpunkterna för din Visuellt innehåll Azure-moln- eller Cognitive Services-container:
  • {COMPUTER_VISION_KEY}: en av de två tillgängliga resursnycklarna.
  • {COMPUTER_VISION_ENDPOINT_URI}: slutpunkten för resursen som används för att spåra faktureringsinformation.
Valfritt Syfte
Azure CLI (kommandoradsgränssnitt) Med Azure CLI kan du använda en uppsättning onlinekommandon för att skapa och hantera Azure-resurser. Den är tillgänglig för installation i Windows-, macOS- och Linux-miljöer och kan köras i en Docker-container och Azure Cloud Shell.

Krav för värddator

Värden är en x64-baserad dator som kör Docker-containern. Det kan vara en dator lokalt eller en Docker-värdtjänst i Azure, till exempel:

Krav och rekommendationer för containrar

Nödvändiga containrar

I följande tabell visas stödcontainrar för varje Formigenkänning container som du laddar ned. Mer information finns i avsnittet Fakturering .

Funktionscontainer Stödcontainrar
Layout Ingen
Visitkort Visuellt innehåll Läs
ID-dokument Visuellt innehåll Läs
Faktura Layout
Mottagandet Visuellt innehåll Läs
Anpassad Anpassat API, anpassad övervakad, layout

Anteckning

De lägsta och rekommenderade värdena baseras på Docker-gränser och inte på värddatorresurserna.

Läs-, layout- och fördefinierade containrar
Container Minimum Rekommenderas
Läs 3.2 8 kärnor, 16 GB minne 8 kärnor, 24 GB minne
Layout 2.1 8 kärnor, 16 GB minne 8 kärnor, 24 GB minne
Visitkort 2.1 2 kärnor, 4 GB minne 4 kärnor, 4 GB minne
ID-dokument 2.1 1 core, 2 GB minne 2 kärnor, 2 GB minne
Faktura 2.1 4 kärnor, 8 GB minne 8 kärnor, 8 GB minne
Kvitto 2.1 4 kärnor, 8 GB minne 8 kärnor, 8 GB minne
Anpassade containrar

Följande krav för värddatorer gäller för att träna och analysera begäranden:

Container Minimum Rekommenderas
Anpassat API 0,5 kärnor, 0,5 GB minne 1 core, 1 GB minne
Anpassad övervakad 4 kärnor, 2 GB minne 8 kärnor, 4 GB minne
  • Varje kärna måste vara minst 2,6 gigahertz (GHz) eller snabbare.
  • Kärna och minne motsvarar --cpus inställningarna och --memory som används som en del av docker compose kommandot eller docker run .

Tips

Du kan använda kommandot docker images för att visa en lista över dina nedladdade containeravbildningar. Följande kommando visar till exempel ID, lagringsplats och tagg för varje nedladdad containeravbildning, formaterad som en tabell:

docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

IMAGE ID         REPOSITORY                TAG
<image-id>       <repository-path/name>    <tag-name>

Kör containern med kommandot docker-compose up

  • Ersätt värdena {ENDPOINT_URI} och {API_KEY} med resursens slutpunkts-URI och nyckeln från Azure-resurssidan.

    Skärmbild: Azure Portal nycklar och slutpunktssida.

  • Kontrollera att eula-värdet är inställt på "accept".

  • Värdena EULA, Billingoch Key måste anges. Annars startar inte containern.

Viktigt

Nycklarna används för att komma åt din Formigenkänning resurs. Dela inte dina nycklar. Lagra dem på ett säkert sätt, till exempel med hjälp av Azure Key Vault. Vi rekommenderar också att du återskapar dessa nycklar regelbundet. Endast en nyckel krävs för att göra ett API-anrop. När du återskapar den första nyckeln kan du använda den andra nyckeln för fortsatt åtkomst till tjänsten.

Nedan visas ett fristående docker compose exempel för att köra containern Formigenkänning Layout. Med docker composeanvänder du en YAML-fil för att konfigurera programmets tjänster. docker-compose up Med kommandot skapar och startar du sedan alla tjänster från konfigurationen. Ange {FORM_RECOGNIZER_ENDPOINT_URI} och {{FORM_RECOGNIZER_KEY} värden för din layoutcontainerinstans.

version: "3.9"
services:
  azure-cognitive-service-layout:
    container_name: azure-cognitive-service-layout
    image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/layout
    environment:
      - EULA=accept
      - billing={FORM_RECOGNIZER_ENDPOINT_URI}
      - apiKey={FORM_RECOGNIZER_KEY}
    ports:
      - "5000"
    networks:
      - ocrvnet
networks:
  ocrvnet:
    driver: bridge

Nu kan du starta tjänsten med kommandot docker compose :

docker-compose up

Kontrollera att tjänsten körs

Det finns flera sätt att verifiera att containern körs:

  • Containern tillhandahåller en startsida på som en visuell validering som containern körs på \ .

  • Du kan öppna din favoritwebbläsare och navigera till den externa IP-adressen och den exponerade porten för containern i fråga. Använd de olika url:erna för begäran nedan för att verifiera att containern körs. Url:erna för begäran nedan är http://localhost:5000, men din specifika container kan variera. Tänk på att du navigerar till containerns externa IP-adress och exponerade port.

    URL för begäran Syfte
    http:// localhost:5000/ Containern tillhandahåller en startsida.
    http:// localhost:5000/ready Den här begäran begärs med GET och ger en verifiering av att containern är redo att acceptera en fråga mot modellen. Den här begäran kan användas för Kubernetes liveness- och beredskapsavsökningar.
    http:// localhost:5000/status Begäran med GET verifierar den här begäran om api-nyckeln som används för att starta containern är giltig utan att orsaka en slutpunktsfråga. Den här begäran kan användas för Kubernetes liveness- och beredskapsavsökningar.
    http:// localhost:5000/swagger Containern tillhandahåller en fullständig uppsättning dokumentation för slutpunkterna samt en Prova-funktion. Med den här funktionen kan du ange inställningarna i ett webbaserat HTML-formulär och göra frågan utan att behöva skriva någon kod. När frågan har returnerats tillhandahålls ett exempel på CURL-kommandot för att demonstrera de HTTP-huvuden och brödtextformat som krävs.

Skärmbild: Välkomstsida för Azure-container.

Stoppa containrarna

Om du vill stoppa containrarna använder du följande kommando:

docker-compose down

Fakturering

De Formigenkänning containrarna skickar faktureringsinformation till Azure med hjälp av en Formigenkänning resurs på ditt Azure-konto.

Frågor till containern faktureras på prisnivån för den Azure-resurs som används för Key. Du debiteras för varje containerinstans som används för att bearbeta dokument och avbildningar. Om du använder visitkortsfunktionen debiteras du därför för FormigenkänningBusinessCard- och Computer Vision Read containerinstanserna. För fakturafunktionen debiteras du för FormigenkänningInvoice- och Layout containerinstanserna. Seprissättningen för Formigenkänning och Visuellt innehåll Read-funktionscontainer.

Azure Cognitive Services-containrar licensieras inte för att köras utan att vara anslutna till slutpunkten för mätning/fakturering. Containrar måste vara aktiverade för att kunna kommunicera faktureringsinformation med faktureringsslutpunkten hela tiden. Cognitive Services-containrar skickar inte kunddata, till exempel den bild eller text som analyseras, till Microsoft.

Anslut till Azure

Containern behöver värdena för faktureringsargumentet för att köras. Dessa värden gör att containern kan ansluta till faktureringsslutpunkten. Containern rapporterar användning var 10:e till 15:e minut. Om containern inte ansluter till Azure inom den tillåtna tidsperioden fortsätter containern att köras, men hanterar inte frågor förrän faktureringsslutpunkten har återställts. Anslutningen görs 10 gånger med samma tidsintervall på 10 till 15 minuter. Om den inte kan ansluta till faktureringsslutpunkten inom de 10 försöken slutar containern att hantera begäranden. Se vanliga frågor och svar om Cognitive Services-containern för ett exempel på den information som skickas till Microsoft för fakturering.

Faktureringsargument

Kommandot docker-compose up startar containern när alla tre av följande alternativ har giltiga värden:

Alternativ Beskrivning
Key Nyckeln för Cognitive Services-resursen som används för att spåra faktureringsinformation.
Värdet för det här alternativet måste anges till en nyckel för den etablerade resursen som anges i Billing.
Billing Slutpunkten för Cognitive Services-resursen som används för att spåra faktureringsinformation.
Värdet för det här alternativet måste anges till slutpunkts-URI för en etablerad Azure-resurs.
Eula Anger att du har godkänt licensen för containern.
Värdet för det här alternativet måste vara inställt på att acceptera.

Mer information om dessa alternativ finns i Konfigurera containrar.

Sammanfattning

Klart! I den här artikeln har du lärt dig begrepp och arbetsflöden för att ladda ned, installera och köra Formigenkänning containrar. Sammanfattningsvis:

  • Formigenkänning tillhandahåller sju Linux-containrar för Docker.
  • Containeravbildningar laddas ned från mcr.
  • Containeravbildningar körs i Docker.
  • Faktureringsinformationen måste anges när du instansierar en container.

Viktigt

Cognitive Services-containrar licensieras inte för körning utan att vara anslutna till Azure för mätning. Kunder måste aktivera containrarna för att kunna kommunicera faktureringsinformation med avläsningstjänsten hela tiden. Cognitive Services-containrar skickar inte kunddata (till exempel den bild eller text som analyseras) till Microsoft.

Nästa steg