Instalowanie i uruchamianie kontenerów Rozpoznawanie formularzy w wersji 2.1 w wersji zapoznawczej

Ważne

Rozpoznawanie formularzy kontenery są w wersji zapoznawczej z bramą. Aby z nich korzystać, musisz przesłać żądanie onlinei otrzymać zatwierdzenie. Aby uzyskać więcej informacji, zobacz Żądanie zatwierdzenia uruchomienia kontenera poniżej.

Azure Rozpoznawanie formularzy to usługa azure applied AI, która umożliwia tworzenie zautomatyzowanego oprogramowania do przetwarzania danych przy użyciu technologii uczenia maszynowego. Rozpoznawanie formularzy umożliwia identyfikowanie i wyodrębnianie tekstu, par klucz/wartość, znaczników wyboru, danych tabeli i innych danych z dokumentów formularza i danych wyjściowych ze strukturą, które zawierają relacje w oryginalnym pliku.

W tym artykule dowiesz się, jak pobierać, instalować i uruchamiać Rozpoznawanie formularzy kontenery. Kontenery umożliwiają uruchamianie usługi Rozpoznawanie formularzy we własnym środowisku. Kontenery doskonale nadają się do określonych wymagań w zakresie zabezpieczeń i zarządzania danymi. Rozpoznawanie formularzy są obsługiwane przez sześć kontenerów funkcji usługi Rozpoznawanie formularzy —układu, wizytówki,dokumentu identyfikatora, paragonu, faktury i niestandardowego (w przypadku kontenerów paragonu, wizytówki i dokumentu tożsamości potrzebny będzie również kontener Odczytuj OCR).

Wymagania wstępne

Aby rozpocząć pracę, musisz mieć aktywne konto platformy Azure. Jeśli go nie masz, możesz utworzyć bezpłatne konto.

Do korzystania z kontenerów Rozpoznawanie formularzy potrzebne są również następujące elementy:

Wymagane Przeznaczenie
Znajomość platformy Docker Musisz mieć podstawową wiedzę na temat pojęć dotyczących platformy Docker, takich jak rejestry, repozytoria, kontenery i obrazy kontenerów, a także podstawową docker terminologię i polecenia.
Zainstalowany aparat platformy Docker
  • Aparat platformy Docker musi być zainstalowany na komputerze-hoście. Platforma Docker udostępnia pakiety, które konfigurują środowisko platformy Docker w systemach macOS, Windows i Linux. Aby uzyskać podstawowe informacje na temat platformy Docker i kontenerów, zapoznaj się z artykułem Docker overview (Przegląd platformy Docker).
  • Platformę Docker należy skonfigurować tak, aby umożliwić kontenerom nawiązywanie połączeń z platformą Azure i wysyłanie danych rozliczeniowych na platformę Azure.
  • Na Windows platformy Docker należy również skonfigurować do obsługi kontenerów systemu Linux.
Rozpoznawanie formularzy zasobów Pojedyncza usługa platformy Azure Rozpoznawanie formularzy wielu usług Cognitive Services zasobów w Azure Portal. Aby korzystać z kontenerów, musisz mieć skojarzony klucz interfejsu API i jego URI. Obie wartości są dostępne na stronie Azure Portal Rozpoznawanie formularzy Kluczy i punktu końcowego:
  • {FORM_RECOGNIZER_API_KEY}: jeden z dwóch dostępnych kluczy zasobów.
  • {FORM_RECOGNIZER_ENDPOINT_URI}: punkt końcowy zasobu używanego do śledzenia informacji rozliczeniowych.
przetwarzanie obrazów interfejsu API Do przetwarzania wizytówek, dokumentów identyfikatorów lub paragonów potrzebny jest przetwarzanie obrazów zasobów.
  • Dostęp do tej funkcji Rozpoznawanie tekstu jako zasób platformy Azure (interfejs API REST lub zestaw SDK) lub kontener cognitive-services-recognize-text. Obowiązują zwykłe opłaty rozliczeniowe.
  • Jeśli używasz kontenera cognitive-services-recognize-text, upewnij się, że klucz przetwarzanie obrazów kontenera Rozpoznawanie formularzy jest kluczem określonym w kontenerze przetwarzanie obrazów lub poleceniu dla kontenera docker run docker compose cognitive-services-recognize-text, a punkt końcowy rozliczeń jest punktem końcowym kontenera (na przykład http://localhost:5000 ). Jeśli używasz kontenera przetwarzanie obrazów i kontenera Rozpoznawanie formularzy na tym samym hoście, nie można rozpocząć ich z domyślnym portem 5000.

Przekaż zarówno klucz interfejsu API, jak i punkty końcowe dla przetwarzanie obrazów azure cloud lub Cognitive Services kontenera:
  • {COMPUTER_VISION_API_KEY}: jeden z dwóch dostępnych kluczy zasobów.
  • {COMPUTER_VISION_ENDPOINT_URI}: punkt końcowy zasobu używanego do śledzenia informacji rozliczeniowych.
Opcjonalne Przeznaczenie
Interfejs wiersza polecenia platformy Azure (interfejs wiersza polecenia) Interfejs wiersza polecenia platformy Azure umożliwia tworzenie zasobów platformy Azure i zarządzanie nimi za pomocą zestawu poleceń online. Można ją zainstalować w środowiskach Windows, macOS i Linux. Można ją uruchamiać w kontenerze platformy Docker i Azure Cloud Shell.

Żądanie zatwierdzenia w celu uruchomienia kontenera

Wypełnij i prześlij formularz Aplikacji dla usług gated, aby zażądać zatwierdzenia uruchomienia kontenera.

Formularz żąda informacji o Użytkowniku, Twojej firmie i scenariuszu użytkownika, dla którego będziesz używać kontenera. Po przesłaniu formularza zespół Azure Cognitive Services go przejrzeć i wysłać do Ciebie wiadomość e-mail z decyzją.

W formularzu należy użyć adresu e-mail skojarzonego z identyfikatorem subskrypcji platformy Azure. Zasób platformy Azure, za pomocą których uruchamiasz kontener, musi zostać utworzony z zatwierdzonym identyfikatorem subskrypcji platformy Azure. Sprawdź pocztę e-mail (skrzynkę odbiorczą i foldery wiadomości-śmieci), aby uzyskać aktualizacje dotyczące stanu aplikacji od firmy Microsoft. Po zatwierdzeniu będziesz mieć możliwość uruchomienia kontenera po pobraniu go z aplikacji Microsoft Container Registry (MCR), opisanej w dalszej części tego artykułu.

Wymagania dotyczące komputera hosta

Host jest komputerem z systemem x64, na których jest uruchamiany kontener platformy Docker. Może to być komputer w środowisku lokalnym lub usługa hostingu platformy Docker na platformie Azure, taka jak:

Wymagania i zalecenia dotyczące kontenerów

Wymagane kontenery

W poniższej tabeli wymieniono dodatkowe kontenery obsługi dla każdego Rozpoznawanie formularzy kontenera, który można pobrać. Aby uzyskać więcej informacji, zapoznaj się z sekcją Rozliczenia.

Kontener funkcji Kontenery obsługi
Układ Brak
Wizytówka przetwarzanie obrazów Odczytaj
ID Document przetwarzanie obrazów Odczytaj
Faktura Układ
Otrzymania przetwarzanie obrazów Odczytaj
Niestandardowe Niestandardowy interfejs API, niestandardowy nadzorowany, układ

Uwaga

Minimalne i zalecane wartości są oparte na limitach platformy Docker, a nie na zasobach maszyny hosta.

Odczytywanie, układ i wstępnie utworzone kontenery
Kontener Minimum Zalecane
Przeczytaj 3.2 8 rdzeni, 16 GB pamięci 8 rdzeni, 24 GB pamięci
Układ 2.1-preview 8 rdzeni, 16 GB pamięci 4-rdzeniowe, 8 GB pamięci
Business Card 2.1-preview 2 rdzenie, 4 GB pamięci 4 rdzenie, 4 GB pamięci
Id Document 2.1-preview 1 rdzeń, 2 GB pamięci 2 rdzenie, 2 GB pamięci
Faktura 2.1 (wersja zapoznawcza) 4 rdzenie, 8 GB pamięci 8 rdzeni, 8 GB pamięci
Receipt 2.1-preview 4 rdzenie, 8 GB pamięci 8 rdzeni, 8 GB pamięci
Kontenery niestandardowe

Następujące wymagania dotyczące maszyny hosta mają zastosowanie do trenowania i analizowania żądań:

Kontener Minimum Zalecane
Niestandardowy interfejs API 0,5 rdzenia, 0,5 GB pamięci 1 rdzeń, 1 GB pamięci
Niestandardowy nadzorowany 4 rdzenie, 2 GB pamięci 8 rdzeni, 4 GB pamięci

Jeśli tylko wywołujesz analizę, wymagania dotyczące maszyny hosta są następujące:

Kontener Minimum Zalecane
Custom Supervised (Analizuj) 1 rdzeń, 0,5 GB 2 rdzenie, 1 GB pamięci
  • Każdy rdzeń musi mieć co najmniej 2,6 GHz lub szybszy.
  • Rdzeń i pamięć odpowiadają --cpus ustawieniam i --memory , które są używane jako część polecenia lub docker compose docker run .

Porada

Aby wyświetlić listę pobranych obrazów kontenerów, możesz użyć polecenia docker images. Na przykład następujące polecenie wyświetla identyfikator, repozytorium i tag każdego pobranego obrazu kontenera sformatowane jako tabela:

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

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

Uruchom kontener za pomocą polecenia docker-compose up

  • Zastąp wartości {ENDPOINT_URI} i {API_KEY} identyfikatorem URI punktu końcowego zasobu i kluczem interfejsu API ze strony zasobu platformy Azure.

    Zrzut ekranu: Azure Portal strony kluczy i punktu końcowego.

  • Upewnij się, że wartość umowy EULA jest ustawiona na wartość "accept".

  • Należy określić wartości , i . W przeciwnym razie nie można EULA Billing uruchomić ApiKey kontenera.

Ważne

Klucze subskrypcji są używane do uzyskiwania dostępu do Rozpoznawanie formularzy zasobów. Nie udostępniaj kluczy. Przechowuj je bezpiecznie, na przykład przy użyciu Azure Key Vault. Zalecamy również regularne ponowne generowanie tych kluczy. Tylko jeden klucz jest niezbędny do wywołania interfejsu API. Podczas ponownego generowania pierwszego klucza można użyć drugiego klucza w celu uzyskania dalszego dostępu do usługi.

Poniżej znajduje się samodzielny przykład docker compose uruchamiania kontenera Rozpoznawanie formularzy Layout. Za docker compose pomocą pliku YAML można skonfigurować usługi aplikacji. Następnie za docker-compose up pomocą polecenia utworzysz i uruchom wszystkie usługi z konfiguracji. Wprowadź wartości {FORM_RECOGNIZER_ENDPOINT_URI} i {{FORM_RECOGNIZER_API_KEY} dla wystąpienia kontenera układu.

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_API_KEY}
    ports:
      - "5000"
    networks:
      - ocrvnet
networks:
  ocrvnet:
    driver: bridge

Teraz możesz uruchomić usługę za pomocą polecenia docker compose:

docker-compose up

Sprawdzanie, czy usługa jest uruchomiona

Istnieje kilka sposobów sprawdzania, czy kontener jest uruchomiony:

  • Kontener zawiera stronę główną na stronie \ jako wizualną weryfikację, czy kontener jest uruchomiony.

  • Możesz otworzyć ulubioną przeglądarkę internetową i przejść do zewnętrznego adresu IP i widocznego portu kontenera. Użyj różnych adresów URL żądań poniżej, aby sprawdzić, czy kontener jest uruchomiony. Przykładowe adresy URL żądań wymienione poniżej to http://localhost:5000 , ale określony kontener może się różnić. Pamiętaj, że nawigujesz do zewnętrznego adresu IP kontenera i widocznego portu.

    Adres URL żądania Przeznaczenie
    http:// localhost:5000/ Kontener zawiera stronę główną.
    http:// localhost:5000/ready Żądanie get zapewnia weryfikację, czy kontener jest gotowy do zaakceptowania zapytania względem modelu. Tego żądania można użyć w przypadku sond liveness i gotowości usługi Kubernetes.
    http:// localhost:5000/status Żądany za pomocą funkcji GET sprawdza, czy klucz api-key użyty do uruchomienia kontenera jest prawidłowy bez powodowania zapytania punktu końcowego. Tego żądania można użyć w przypadku sond liveness i gotowości usługi Kubernetes.
    http:// localhost:5000/swagger Kontener zawiera pełen zestaw dokumentacji dla punktów końcowych oraz funkcję Wypróbuj. Dzięki tej funkcji możesz wprowadzić ustawienia w internetowym formularzu HTML i utworzyć zapytanie bez konieczności pisania kodu. Po zwracaniu zapytania zostanie podane przykładowe polecenie CURL, aby zademonstrować wymagane nagłówki HTTP i format treści.

Zrzut ekranu: strona powitania kontenera platformy Azure.

Zatrzymywanie kontenerów

Aby zatrzymać kontenery, użyj następującego polecenia:

docker-compose down

Rozliczenia

Kontenery Rozpoznawanie formularzy wysyłają informacje rozliczeniowe na platformę Azure przy użyciu zasobu Rozpoznawanie formularzy na koncie platformy Azure.

Zapytania do kontenera są rozliczane w warstwie cenowej zasobu platformy Azure, który jest używany przez usługę ApiKey . Za każde wystąpienie kontenera używane do przetwarzania dokumentów i obrazów będą naliczane faktury. W związku z tym w przypadku korzystania z funkcji wizytówki będą naliczane Rozpoznawanie formularzy BusinessCard i Compuer Vision Read wystąpienia kontenerów. W przypadku funkcji faktury będą naliczane faktury za wystąpienia Rozpoznawanie formularzy Invoice Layout kontenera. Zobacz, Rozpoznawanie formularzy i przetwarzanie obrazów Przeczytaj cennik kontenera funkcji.

Azure Cognitive Services nie są licencjonowane do uruchamiania bez połączenia z punktem końcowym pomiaru/rozliczeń. Należy włączyć kontenery do przekazywania informacji rozliczeniowych z punktem końcowym rozliczeń przez cały czas. Cognitive Services kontenery nie wysyłają danych klienta, takich jak obraz lub tekst, który jest analizowany, do firmy Microsoft.

Nawiązywanie połączenia z usługą Azure

Kontener wymaga uruchomienia wartości argumentu rozliczeniowego. Te wartości umożliwiają kontenerowi łączenie się z punktem końcowym rozliczeń. Kontener raportuje użycie co około 10–15 minut. Jeśli kontener nie łączy się z platformą Azure w dozwolonym oknie czasowym, kontener będzie nadal działać, ale nie będzie obsługiwać zapytań, dopóki punkt końcowy rozliczeń nie zostanie przywrócony. Próba nawiązaniu połączenia jest podejmowana 10 razy w tym samym przedziale czasu od 10 do 15 minut. Jeśli nie może nawiązać połączenia z punktem końcowym rozliczeń w ramach próby 10, kontener przestaje obsługuje żądania. Zobacz często zadawane Cognitive Services kontenera aplikacji, aby uzyskać przykład informacji wysyłanych do firmy Microsoft w celu rozliczeń.

Argumenty rozliczeń

Polecenie docker-compose up spowoduje uruchomienie kontenera, gdy wszystkie trzy z następujących opcji zostaną podane z prawidłowymi wartościami:

Opcja Opis
ApiKey Klucz interfejsu API Cognitive Services używany do śledzenia informacji rozliczeniowych.
Wartość tej opcji musi być ustawiona na klucz interfejsu API dla aprowizowanych zasobów określonych w pliku Billing .
Billing Punkt końcowy zasobu Cognitive Services używany do śledzenia informacji rozliczeniowych.
Wartość tej opcji musi być ustawiona na wartość URI punktu końcowego aprowizowanych zasobów platformy Azure.
Eula Wskazuje, że zaakceptowaliśmy licencję kontenera.
Wartość tej opcji musi być ustawiona tak, aby akceptowała wartość.

Aby uzyskać więcej informacji na temat tych opcji, zobacz Konfigurowanie kontenerów.

Podsumowanie

Gotowe. W tym artykule poznaliśmy pojęcia i przepływy pracy dotyczące pobierania, instalowania i uruchamiania Rozpoznawanie formularzy kontenerów. Podsumowanie:

  • Rozpoznawanie formularzy udostępnia siedem kontenerów systemu Linux dla platformy Docker.
  • Obrazy kontenerów są pobierane z aplikacji mcr.
  • Obrazy kontenerów są uruchamiane na platformy Docker.
  • Informacje rozliczeniowe należy określić podczas wystąpienia kontenera.

Ważne

Cognitive Services nie mają licencji na uruchamianie bez połączenia z platformą Azure w celu zmierzania. Klienci muszą włączyć kontenery, aby przez cały czas przekazywać informacje dotyczące rozliczeń z usługą pomiarów. Cognitive Services nie wysyłają danych klienta (na przykład obrazu lub tekstu, który jest analizowany) do firmy Microsoft.

Następne kroki