Instalowanie i uruchamianie kontenerów
Obsługa kontenerów jest obecnie dostępna w wersji 2022-08-31 (GA)
analizy dokumentów dla wszystkich modeli oraz 2023-07-31 (GA)
modeli odczytu, układu, dokumentu identyfikatora, paragonu i faktury:
- INTERFEJS API REST
2022-08-31 (GA)
- INTERFEJS API REST
2023-07-31 (GA)
- Określanie elementów docelowych bibliotek klienckich
REST API 2022-08-31 (GA)
- Określanie elementów docelowych bibliotek klienckich
REST API 2023-07-31 (GA)
✔️ Zobacz Instalowanie i uruchamianie kontenerów analizy dokumentów, aby uzyskać obsługiwaną dokumentację kontenera.
Ta zawartość dotyczy: wersja 3.0 (ogólna dostępność) w wersji 3.1 (ogólna dostępność)
Azure AI Document Intelligence to usługa azure AI, która umożliwia tworzenie zautomatyzowanego oprogramowania do przetwarzania danych przy użyciu technologii uczenia maszynowego. Analiza dokumentów umożliwia identyfikowanie i wyodrębnianie tekstu, par klucz/wartość, znaczniki wyboru, dane tabeli i nie tylko z dokumentów. Wyniki są dostarczane jako dane ustrukturyzowane, które .. /zawiera relacje w oryginalnym pliku.
Z tego artykułu dowiesz się, jak pobierać, instalować i uruchamiać kontenery analizy dokumentów. Kontenery umożliwiają uruchamianie usługi Analizy dokumentów we własnym środowisku. Kontenery doskonale nadają się do określonych wymagań w zakresie zabezpieczeń i zarządzania danymi.
Modele odczytu, układu, identyfikatora dokumentu, paragonu i faktury są obsługiwane przez kontenery analizy dokumentów w wersji 3.1.
Kontenery Read, Layout, General Document, Business Card i Custom są obsługiwane przez kontenery analizy dokumentów w wersji 3.0.
Wymagania wstępne
Do rozpoczęcia pracy potrzebne jest aktywne konto platformy Azure. Jeśli nie masz, możesz utworzyć bezpłatne konto.
Do korzystania z kontenerów analizy dokumentów potrzebne są również następujące elementy:
Wymagania | Purpose |
---|---|
Znajomość platformy Docker | Musisz mieć podstawową wiedzę na temat pojęć związanych z platformą Docker, takich jak rejestry, repozytoria, kontenery i obrazy kontenerów, a także znajomość podstawowej docker terminologii i poleceń. |
Zainstalowany aparat platformy Docker |
|
Zasób analizy dokumentów | Usługa Azure AI Document Intelligence lub zasób z wieloma usługami w witrynie Azure Portal. Aby korzystać z kontenerów, musisz mieć skojarzony klucz i identyfikator URI punktu końcowego. Obie wartości są dostępne na stronie Klucze analizy dokumentów i punkt końcowy w witrynie Azure Portal:
|
Opcjonalnie | Purpose |
---|---|
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. Jest ona dostępna do zainstalowania w środowiskach systemu Windows, macOS i Linux oraz może być uruchamiana w kontenerze platformy Docker i usłudze Azure Cloud Shell. |
Wymagania dotyczące komputera hosta
Host to komputer oparty na architekturze x64 z uruchomionym kontenerem platformy Docker. Może to być komputer lokalny lub usługa hostingu platformy Docker na platformie Azure, taka jak:
- Azure Kubernetes Service.
- Azure Container Instances.
- Klaster Kubernetes wdrożony w usłudze Azure Stack. Aby uzyskać więcej informacji, zobacz Wdrażanie rozwiązania Kubernetes w usłudze Azure Stack.
Uwaga
Należy pamiętać, że nie można wdrożyć i uruchomić kontenera studio w usłudze Azure Kubernetes Service. Kontener studio jest obsługiwany tylko do uruchamiania na komputerze lokalnym.
Wymagania i zalecenia dotyczące kontenerów
Wymagane kontenery pomocnicze
W poniższej tabeli wymieniono co najmniej jeden kontener pomocniczy dla każdego pobranego kontenera analizy dokumentów. Aby uzyskać więcej informacji, zobacz sekcję Rozliczenia .
Kontener funkcji | Obsługa kontenerów |
---|---|
Przeczytaj | Niewymagane |
Układ | Niewymagane |
Wizytówka | Przeczytaj |
Dokument ogólny | Układ |
Faktura | Układ |
Paragon | Odczyt lub układ |
Identyfikator dokumentu | Przeczytaj |
Szablon niestandardowy | Układ |
Zalecane rdzenie procesora CPU i pamięć
Uwaga
Minimalne i zalecane wartości są oparte na limitach platformy Docker, a nie na zasobach maszyny hosta.
Kontenery analizy dokumentów
Kontener | Minimum | Zalecane |
---|---|---|
Read |
8 rdzenie, pamięć 10 GB |
8 rdzenie, pamięć 24 GB |
Layout |
8 rdzenie, 16 GB pamięci |
8 rdzenie, pamięć 24 GB |
Business Card |
8 rdzenie, 16 GB pamięci |
8 rdzenie, pamięć 24 GB |
General Document |
8 rdzenie, pamięć 12 GB |
8 rdzenie, pamięć 24 GB |
ID Document |
8 rdzenie, 8 GB pamięci |
8 rdzenie, pamięć 24 GB |
Invoice |
8 rdzenie, 16 GB pamięci |
8 rdzenie, pamięć 24 GB |
Receipt |
8 rdzenie, 11 GB pamięci |
8 rdzenie, pamięć 24 GB |
Custom Template |
8 rdzenie, 16 GB pamięci |
8 rdzenie, pamięć 24 GB |
- Każdy rdzeń musi być co najmniej 2,6 gigahertz (GHz) lub szybszy.
- Rdzeń i pamięć odpowiadają
--cpus
ustawieniu i--memory
, które są używane w ramachdocker compose
polecenia lubdocker run
.
Napiwek
Możesz użyć polecenia docker images , aby wyświetlić listę pobranych obrazów kontenerów. 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>
Uruchamianie kontenera za pomocą polecenia docker-compose up
Zastąp wartości {ENDPOINT_URI} i {API_KEY} identyfikatorem URI punktu końcowego zasobu oraz kluczem ze strony zasobu platformy Azure.
Upewnij się, że wartość jest ustawiona
EULA
na akceptowanie.EULA
Należy określić wartości ,Billing
iApiKey
. W przeciwnym razie nie można uruchomić kontenera.
Ważne
Klucze są używane do uzyskiwania dostępu do zasobu analizy dokumentów. Nie udostępniaj swoich kluczy. Przechowuj je bezpiecznie, na przykład przy użyciu usługi Azure Key Vault. Zalecamy również regularne ponowne generowanie tych kluczy. Tylko jeden klucz jest wymagany do wykonania wywołania interfejsu API. Podczas ponownego generowania pierwszego klucza można używać drugiego klucza, aby nadal uzyskiwać dostęp do usługi.
- Przeczytaj
- Dokument ogólny
- Układ
- Faktura
- Paragon
- Identyfikator dokumentu
- Wizytówka
- Okres niestandardowy
Poniższy przykładowy kod jest przykładem samodzielnego docker compose
uruchamiania kontenera układu analizy dokumentów. Za pomocą docker compose
polecenia użyjesz pliku YAML, aby skonfigurować usługi aplikacji. Następnie za docker-compose up
pomocą polecenia utworzysz i uruchomisz wszystkie usługi z konfiguracji. Wprowadź wartości {FORM_RECOGNIZER_ENDPOINT_URI} i {FORM_RECOGNIZER_KEY} dla wystąpienia kontenera układu.
version: "3.9"
services:
azure-form-recognizer-read:
container_name: azure-form-recognizer-read
image: mcr.microsoft.com/azure-cognitive-services/form-recognizer/read-3.1
environment:
- EULA=accept
- billing={FORM_RECOGNIZER_ENDPOINT_URI}
- apiKey={FORM_RECOGNIZER_KEY}
ports:
- "5000:5000"
networks:
- ocrvnet
networks:
ocrvnet:
driver: bridge
Teraz możesz uruchomić usługę za pomocą polecenia docker compose :
docker-compose up
Sprawdź, czy usługa jest uruchomiona
Istnieje kilka sposobów sprawdzania, czy kontener jest uruchomiony:
Kontener udostępnia stronę główną w
\
postaci wizualnej weryfikacji uruchomionej kontenera.Możesz otworzyć ulubioną przeglądarkę internetową i przejść do zewnętrznego adresu IP i uwidocznić port danego kontenera. Użyj wymienionych adresów URL żądań, aby zweryfikować, czy kontener jest uruchomiony. Wymienione przykładowe adresy URL żądań to
http://localhost:5000
, ale określony kontener może się różnić. Pamiętaj, że przechodzisz do zewnętrznego adresu IP kontenera i uwidaczniasz port.Adres URL żądania Purpose http:// localhost:5000/ Kontener zawiera stronę główną. http:// localhost:5000/ready Żądanie get zapewnia weryfikację, że kontener jest gotowy do akceptowania zapytania względem modelu. To żądanie może służyć do sond gotowości i gotowości platformy Kubernetes. http:// localhost:5000/status Zażądano polecenia GET. To żądanie sprawdza, czy klucz api-key używany do uruchamiania kontenera jest prawidłowy bez powodowania zapytania punktu końcowego. To żądanie może służyć do sond gotowości i gotowości platformy 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 formularzu HTML opartym na sieci Web i utworzyć zapytanie bez konieczności pisania kodu. Po powrocie zapytania zostanie udostępnione przykładowe polecenie CURL, aby zademonstrować wymagane nagłówki HTTP i format treści.
Zatrzymywanie kontenerów
Aby zatrzymać kontenery, użyj następującego polecenia:
docker-compose down
Rozliczenia
Kontenery analizy dokumentów wysyłają informacje rozliczeniowe na platformę Azure przy użyciu zasobu analizy dokumentów na koncie platformy Azure.
Zapytania do kontenera są rozliczane w warstwie cenowej zasobu platformy Azure używanego dla interfejsu API Key
. Rozliczenia są obliczane dla każdego wystąpienia kontenera używanego do przetwarzania dokumentów i obrazów.
Jeśli wystąpi następujący błąd: Kontener nie jest w prawidłowym stanie. Sprawdzanie poprawności subskrypcji nie powiodło się, a stan "OutOfQuota" interfejsu API jest poza limitem przydziału. Jest to wskaźnik, że kontenery nie są komunikacją z punktem końcowym rozliczeń.
Łączenie się z platformą Azure
Do uruchomienia kontenera potrzebne są wartości argumentów rozliczeniowych. Te wartości umożliwiają kontenerowi łączenie się z punktem końcowym rozliczeń. Kontener raportuje użycie co około 10 do 15 minut. Jeśli kontener nie łączy się z platformą Azure w dozwolonym przedziale czasu, kontener będzie nadal działać, ale nie obsługuje zapytań, dopóki punkt końcowy rozliczeń nie zostanie przywrócony. Próba nawiązania 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 ciągu 10 prób, kontener przestanie obsługiwać żądania. Zobacz Często zadawane pytania dotyczące kontenera usługi Azure AI, aby uzyskać przykład informacji wysyłanych do firmy Microsoft na potrzeby rozliczeń.
Argumenty rozliczeniowe
Polecenie docker-compose up uruchamia kontener, gdy wszystkie trzy z następujących opcji są dostarczane z prawidłowymi wartościami:
Opcja | Opis |
---|---|
ApiKey |
Klucz zasobu usług Azure AI używany do śledzenia informacji rozliczeniowych. Wartość tej opcji musi być ustawiona na klucz dla zaaprowizowanego zasobu określonego w Billing pliku . |
Billing |
Punkt końcowy zasobu usług AI platformy Azure używany do śledzenia informacji rozliczeniowych. Wartość tej opcji musi być ustawiona na identyfikator URI punktu końcowego aprowizowanego zasobu platformy Azure. |
Eula |
Wskazuje, że zaakceptowano licencję dla kontenera. Wartość tej opcji należy ustawić tak, aby akceptowała. |
Aby uzyskać więcej informacji na temat tych opcji, zobacz Konfigurowanie kontenerów.
Podsumowanie
I już! W tym artykule przedstawiono pojęcia i przepływy pracy dotyczące pobierania, instalowania i uruchamiania kontenerów analizy dokumentów. Podsumowując:
- Analiza dokumentów udostępnia siedem kontenerów systemu Linux dla platformy Docker.
- Obrazy kontenerów są pobierane z mcr.
- Obrazy kontenerów są uruchamiane na platformie Docker.
- Informacje o rozliczeniach należy określić podczas tworzenia wystąpienia kontenera.
Ważne
Kontenery sztucznej inteligencji platformy Azure nie mają licencji na uruchamianie bez nawiązywania połączenia z platformą Azure na potrzeby pomiaru użytkowania. Klienci muszą umożliwić kontenerom komunikowanie informacji rozliczeniowych z usługą pomiarów przez cały czas. Kontenery sztucznej inteligencji platformy Azure nie wysyłają danych klientów (na przykład obrazu lub tekstu analizowanego) do firmy Microsoft.