Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Ważne
Usługa Language Understanding Intelligent Service (LUIS) zostanie w pełni wycofana 31 marca 2026 r. Tworzenie zasobów usługi LUIS nie jest dostępne. Od 31 października 2025 r. portal usługi LUIS nie będzie już dostępny. Zalecamy migrację aplikacji LUIS do interpretacji języka konwersacyjnego, aby korzystać z ciągłej pomocy technicznej i wielojęzycznych możliwości produktów.
Uwaga
Lokalizacja obrazu kontenera została ostatnio zmieniona. Przeczytaj ten artykuł, aby wyświetlić zaktualizowaną lokalizację dla tego kontenera.
Kontenery umożliwiają korzystanie z usługi LUIS we własnym środowisku. Kontenery doskonale nadają się do określonych wymagań w zakresie zabezpieczeń i zarządzania danymi. W tym artykule dowiesz się, jak pobrać, zainstalować i uruchomić kontener usługi LUIS.
Kontener Language Understanding (LUIS) ładuje Twój wytrenowany lub opublikowany model Language Understanding. Jako aplikacja usługi LUIS kontener platformy Docker zapewnia dostęp do przewidywań zapytań z punktów końcowych interfejsu API kontenera. Dzienniki zapytań można zbierać z kontenera i przekazywać je z powrotem do aplikacji Language Understanding, aby poprawić dokładność przewidywania aplikacji.
W poniższym filmie wideo pokazano, jak używać tego kontenera.
Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.
Wymagania wstępne
Aby uruchomić kontener usługi LUIS, należy pamiętać o następujących wymaganiach wstępnych:
-
Platforma Docker zainstalowana na komputerze hosta. Platforma Docker musi być skonfigurowana tak, aby umożliwić kontenerom łączenie się z platformą Azure i wysyłanie danych rozliczeniowych do platformy Azure.
- W systemie Windows platforma Docker musi być również skonfigurowana do obsługi kontenerów systemu Linux.
- Musisz mieć podstawową wiedzę na temat pojęć związanych z platformą Docker.
- z warstwą cenową Bezpłatna (F0) lub Standardowa (S).
- Wytrenowana lub opublikowana aplikacja spakowana jako zamontowane wejście do kontenera ze skojarzonym identyfikatorem aplikacji. Spakowany plik można pobrać z portalu usługi LUIS lub interfejsów API autorskich. Jeśli pozyskujesz spakowaną aplikację LUIS z interfejsów API tworzenia, będziesz również potrzebować klucza autoryzacji.
Zbieranie wymaganych parametrów
Wymagane są trzy podstawowe parametry dla wszystkich kontenerów sztucznej inteligencji platformy Azure. Warunki licencji oprogramowania firmy Microsoft muszą mieć wartość akceptuj. Również wymagane są identyfikator URI punktu końcowego oraz klucz API.
URI punktu końcowego
Wartość {ENDPOINT_URI}
jest dostępna na stronie Przegląd portalu Azure dla odpowiedniego zasobu usługi Azure AI. Przejdź do strony Przegląd, umieść kursor nad punktem końcowym, a zostanie wyświetlona ikona Kopiuj do schowka. Skopiuj punkt końcowy i używaj go w razie potrzeby.
Klucze
Wartość {API_KEY}
jest używana do uruchamiania kontenera i jest dostępna na stronie Klucze portalu Azure odpowiedniego zasobu usług Azure AI. Przejdź do strony Klucze i wybierz ikonę Kopiuj do schowka.
Ważne
Te klucze subskrypcji są używane do uzyskiwania dostępu do interfejsu API usług Azure AI. Nie udostępniaj kluczy. Przechowuj je bezpiecznie. Na przykład użyj 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żyć drugiego klucza w celu dalszego dostępu do usługi.
Identyfikator aplikacji {APP_ID}
Ten identyfikator służy do wybierania aplikacji. Identyfikator aplikacji można znaleźć w portalu usługi LUIS , klikając pozycję Zarządzaj w górnej części ekranu aplikacji, a następnie pozycję Ustawienia.
Klucz tworzenia {AUTHORING_KEY}
Ten klucz służy do pobierania spakowanej aplikacji z usługi LUIS w chmurze i przekazywania dzienników zapytań z powrotem do chmury. Klucz tworzenia będzie potrzebny w przypadku eksportowania aplikacji przy użyciu interfejsu API REST opisanego w dalszej części artykułu.
Klucz tworzenia można pobrać z portalu usługi LUIS , klikając pozycję Zarządzaj w górnej części ekranu aplikacji, a następnie pozycję Zasoby platformy Azure.
Tworzenie interfejsów API dla pliku pakietu
Tworzenie interfejsów API dla spakowanych aplikacji:
- Opublikowane API pakietu
- Nieopublikowany, przeznaczony tylko dla wytrenowanych modeli interfejs API pakietu
Komputer-gospodarz
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.
Wymagania i zalecenia dotyczące kontenerów
W poniższej tabeli wymieniono minimalne i zalecane wartości dla hosta kontenera. Wymagania mogą ulec zmianie w zależności od ilości ruchu.
Pojemnik | Minimalna wartość | Zalecane | TPS (Minimum, Maksimum) |
---|---|---|---|
LUIS | 1 rdzeń, 2 GB pamięci | 1 rdzeń, 4 GB pamięci | 20, 40 |
- Każdy rdzeń musi być co najmniej 2,6 gigaherca (GHz) albo szybszy.
- TPS — transakcje na sekundę
Rdzeń i pamięć odpowiadające ustawieniom --cpus
i --memory
, które są używane w ramach polecenia docker run
.
Pobieranie obrazu kontenera za pomocą polecenia docker pull
Obraz kontenera usługi LUIS jest dostępny w mcr.microsoft.com
syndykacie rejestracji kontenerów. Znajduje się on w azure-cognitive-services/language
repozytorium i ma nazwę luis
. W pełni kwalifikowana nazwa obrazu kontenera to mcr.microsoft.com/azure-cognitive-services/language/luis
.
Aby użyć najnowszej wersji kontenera, możesz użyć tagu latest
. Pełną listę tagów można również znaleźć w mcR.
Użyj polecenia , docker pull
aby pobrać obraz kontenera mcr.microsoft.com/azure-cognitive-services/language/luis
z repozytorium:
docker pull mcr.microsoft.com/azure-cognitive-services/language/luis:latest
Pełny opis dostępnych tagów, takich jak latest
używany w poprzednim poleceniu, można znaleźć w usłudze LUIS w usłudze Docker Hub.
Wskazówka
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>
Jak używać kontenera
Gdy kontener znajduje się na komputerze hosta, użyj następującego procesu, aby pracować z kontenerem.
- Eksport pakietu dla kontenera z portalu LUIS lub interfejsów API LUIS.
- Przenieś plik pakietu do wymaganego katalogu wejściowego na komputerze hosta. Nie należy zmieniać nazwy, modyfikować, nadpisywać ani dekompresować pliku pakietu usługi LUIS.
-
Uruchom kontener z wymaganymi ustawieniami instalowania danych wejściowych i rozliczeń. Dostępnych jest więcej przykładów
docker run
polecenia. - Wykonywanie zapytań względem punktu końcowego przewidywania kontenera.
- Po zakończeniu pracy z kontenerem zaimportuj dzienniki punktu końcowego z instalacji wyjściowej w portalu usługi LUIS i zatrzymaj kontener.
- Użyj aktywnego uczenia się w portalu usługi LUIS na stronie Przegląd wypowiedzi punktu końcowego, aby ulepszyć aplikację.
Nie można zmienić aplikacji działającej w kontenerze. Aby zmienić aplikację w kontenerze, musisz zmienić aplikację w usłudze LUIS przy użyciu portalu usługi LUIS lub użyć interfejsów API tworzenia usługi LUIS. Następnie wytrenuj i/lub opublikuj, a następnie pobierz nowy pakiet i ponownie uruchom kontener.
Nie można wyeksportować aplikacji LUIS wewnątrz kontenera z powrotem do usługi LUIS. Można przekazać tylko dzienniki zapytań.
Eksportowanie spakowanej aplikacji z usługi LUIS
Kontener usługi LUIS wymaga wytrenowanej lub opublikowanej aplikacji LUIS, aby odpowiedzieć na zapytania dotyczące przewidywania wypowiedzi użytkowników. Aby uzyskać aplikację usługi LUIS, użyj wytrenowanego lub opublikowanego pakietu API.
Domyślna input
lokalizacja to podkatalog w odniesieniu do lokalizacji, w której uruchamiasz docker run
polecenie.
Umieść plik pakietu w katalogu i odwołaj się do tego katalogu jako punktu montowania wejściowego podczas uruchamiania kontenera Docker.
Typy pakietów
Zamontowany katalog wejściowy może zawierać jednocześnie modele aplikacji: produkcyjne, testowe i wersjonowane. Wszystkie pakiety są instalowane.
Typ pakietu | Interfejs API punktu końcowego zapytań | Dostępność zapytań | Format nazwy pliku pakietu |
---|---|---|---|
Wersjonowane | POBIERZ, OPUBLIKUJ | Tylko kontener | {APP_ID}_v{APP_VERSION}.gz |
Etapowanie | POBIERZ, OPUBLIKUJ | Platforma Azure i kontener | {APP_ID}_STAGING.gz |
Produkcja | POBIERZ, OPUBLIKUJ | Platforma Azure i kontener | {APP_ID}_PRODUCTION.gz |
Ważne
Nie zmieniaj nazwy, przekształcaj, nadpisuj ani dekompresuj plików pakietu usługi LUIS.
Wymagania wstępne dotyczące pakowania
Przed opakowaniem aplikacji usługi LUIS musisz mieć następujące elementy:
Wymagania dotyczące pakowania | Szczegóły |
---|---|
Wystąpienie zasobu usług Azure AI | Obsługiwane regiony obejmują Zachodnie stany USA ( westus )Europa Zachodnia ( westeurope )Australia Wschodnia ( australiaeast ) |
Przeszkolona lub opublikowana aplikacja LUIS | Bez nieobsługiwanych zależności. |
Dostęp do systemu plików komputera hosta | Komputer-host musi zezwalać na instalację wejściową. |
Eksportowanie pakietu aplikacji z portalu usługi LUIS
Portal Azure LUIS umożliwia eksportowanie wytrenowanej lub opublikowanej aplikacji.
Eksport pakietu opublikowanej aplikacji z portalu LUIS
Pakiet opublikowanej aplikacji jest dostępny na stronie listy Moje aplikacje .
- Zaloguj się do portalu Azure LUIS.
- Zaznacz pole wyboru po lewej stronie nazwy aplikacji na liście.
- Wybierz pozycję Eksportuj z paska narzędzi kontekstowego nad listą.
- Wybierz pozycję Eksportuj do kontenera (GZIP).
- Wybierz środowisko slotu produkcyjnego lub slotu przejściowego.
- Pakiet jest pobierany z przeglądarki.
Eksportowanie pakietu wersjonowanej aplikacji z portalu LUIS
Pakiet z wersjonowaną aplikacją jest dostępny na stronie listy Wersje.
- Zaloguj się do portalu Azure LUIS.
- Wybierz aplikację z listy.
- Wybierz pozycję Zarządzaj na pasku nawigacyjnym aplikacji.
- Wybierz Wersje w okienku po lewej stronie.
- Zaznacz pole wyboru po lewej stronie nazwy wersji na liście.
- Wybierz pozycję Eksportuj z paska narzędzi kontekstowego nad listą.
- Wybierz pozycję Eksportuj do kontenera (GZIP).
- Pakiet jest pobierany z przeglądarki.
Eksportowanie pakietu opublikowanej aplikacji z interfejsu API
Użyj następującej metody interfejsu API REST, aby spakować już opublikowaną aplikację usługi LUIS. Podstawianie własnych odpowiednich wartości dla symboli zastępczych w wywołaniu interfejsu API przy użyciu tabeli poniżej specyfikacji HTTP.
GET /luis/api/v2.0/package/{APP_ID}/slot/{SLOT_NAME}/gzip HTTP/1.1
Host: {AZURE_REGION}.api.cognitive.microsoft.com
Ocp-Apim-Subscription-Key: {AUTHORING_KEY}
Element zastępczy | Wartość |
---|---|
{APP_ID} | Identyfikator opublikowanej aplikacji LUIS. |
{SLOT_NAME} | Środowisko opublikowanej aplikacji LUIS. Użyj jednej z następujących wartości:PRODUCTION STAGING |
{AUTHORING_KEY} | Klucz autorski konta LUIS dla opublikowanej aplikacji LUIS. Klucz autorski można pobrać ze strony Ustawienia użytkownika w portalu usługi LUIS. |
{AZURE_REGION} | Odpowiedni region świadczenia usługi Azure:westus - Zachodnie stany USAwesteurope - Europa Zachodniaaustraliaeast - Australia Wschodnia |
Aby pobrać opublikowany pakiet, zapoznaj się z dokumentacją interfejsu API tutaj. W przypadku pomyślnego pobrania odpowiedź to plik pakietu usługi LUIS. Zapisz plik w lokalizacji przechowywania określonej dla punktu montowania wejściowego kontenera.
Eksportowanie pakietu wersjonowanej aplikacji za pośrednictwem interfejsu API.
Użyj następującej metody interfejsu API REST, aby spakować aplikację LUIS, którą już przeszkoliłeś. Podstawianie własnych odpowiednich wartości dla symboli zastępczych w wywołaniu interfejsu API przy użyciu tabeli poniżej specyfikacji HTTP.
GET /luis/api/v2.0/package/{APP_ID}/versions/{APP_VERSION}/gzip HTTP/1.1
Host: {AZURE_REGION}.api.cognitive.microsoft.com
Ocp-Apim-Subscription-Key: {AUTHORING_KEY}
Element zastępczy | Wartość |
---|---|
{APP_ID} | Identyfikator wyszkolonej aplikacji LUIS. |
{APP_VERSION} | Wersja wytrenowanej aplikacji LUIS. |
{AUTHORING_KEY} | Klucz autorski konta LUIS dla opublikowanej aplikacji LUIS. Klucz autorski można pobrać ze strony Ustawienia użytkownika w portalu usługi LUIS. |
{AZURE_REGION} | Odpowiedni region świadczenia usługi Azure:westus - Zachodnie stany USAwesteurope - Europa Zachodniaaustraliaeast - Australia Wschodnia |
Aby pobrać pakiet z wersją, zapoznaj się z dokumentacją interfejsu API tutaj. W przypadku pomyślnego pobrania odpowiedź to plik pakietu usługi LUIS. Zapisz plik w lokalizacji przechowywania określonej dla punktu montowania wejściowego kontenera.
Uruchamianie kontenera za pomocą polecenia docker run
Użyj polecenia docker run, aby uruchomić kontener. Aby uzyskać szczegółowe informacje dotyczące tego, jak pobrać wartości i {ENDPOINT_URI}
, zobacz {API_KEY}
.
docker run --rm -it -p 5000:5000 ^
--memory 4g ^
--cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output\,target=/output ^
mcr.microsoft.com/azure-cognitive-services/language/luis ^
Eula=accept ^
Billing={ENDPOINT_URI} ^
ApiKey={API_KEY}
- W tym przykładzie użyto katalogu poza dyskiem
C:
, aby uniknąć konfliktów uprawnień w systemie Windows. Jeśli musisz użyć określonego katalogu jako katalogu wejściowego, może być konieczne przyznanie uprawnień usługi docker. - Nie zmieniaj kolejności argumentów, chyba że znasz kontenery platformy Docker.
- Jeśli używasz innego systemu operacyjnego, użyj poprawnej konsoli/terminalu, składni folderu dla montowania oraz znaku kontynuacji wiersza odpowiedniego dla twojego systemu. W tych przykładach przyjęto założenie, że konsola systemu Windows ma znak kontynuacji wiersza
^
. Ponieważ kontener jest systemem operacyjnym Linux, punkt montowania docelowego używa składni folderów stosowanej w systemie Linux.
To polecenie:
- Uruchamia kontener z obrazu LUIS
- Ładuje aplikację LUIS z punktu montowania danych wejściowych w C:\input na hoście kontenera.
- Przydziela dwa rdzenie procesora CPU i 4 gigabajty pamięci (GB)
- Uwidacznia port TCP 5000 i przydziela pseudo-TTY dla kontenera
- Zapisuje dzienniki kontenera i usługi LUIS w celu zainstalowania danych wyjściowych w lokalizacji C:\output znajdującej się na hoście kontenera
- Automatycznie usuwa kontener po jego wyjściu. Obraz kontenera jest nadal dostępny na komputerze hosta.
Dostępnych jest więcej przykładówdocker run
polecenia.
Ważne
Aby uruchomić kontener, należy określić opcje Eula
, Billing
i ApiKey
; w przeciwnym razie kontener nie zostanie uruchomiony. Aby uzyskać więcej informacji, zobacz Rozliczenia.
Wartość ApiKey jest kluczem ze strony Zasoby platformy Azure w portalu usługi LUIS i jest również dostępna na stronie Klucze zasobów platformy Azure Azure AI services
.
Uruchamianie wielu kontenerów na tym samym hoście
Jeśli zamierzasz uruchomić wiele kontenerów z otwartymi portami, upewnij się, że każdy kontener ma inny otwarty port. Na przykład uruchom pierwszy kontener na porcie 5000 i drugi kontener na porcie 5001.
Ten kontener i inny kontener usług Azure AI mogą być uruchomione razem na hoście. Możesz także uruchomić wiele kontenerów tej samej usługi Azure AI.
Obsługiwane przez kontener API punktów końcowych
Zarówno wersje API V2, jak i V3 są dostępne w kontenerze.
Wykonywanie zapytania dotyczącego punktu końcowego przewidywania kontenera
Kontener udostępnia REST-owe API punktów końcowych przewidywania zapytań. Punkty końcowe dla opublikowanych (przejściowych lub produkcyjnych) aplikacji mają inną trasę niż punkty końcowe dla aplikacji z wersjami.
Użyj hosta http://localhost:5000
dla interfejsów API kontenera.
Typ pakietu | Czasownik HTTP | Marszruta | Parametry zapytania |
---|---|---|---|
Opublikowany | POBIERZ, OPUBLIKUJ |
/luis/v3.0/apps/{appId}/slots/{slotName}/predict?
/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?
|
query={query} [ &verbose ][ &log ][ &show-all-intents ] |
Wersjonowane | POBIERZ, OPUBLIKUJ |
/luis/v3.0/apps/{appId}/versions/{versionId}/predict?
/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict
|
query={query} [ &verbose ][ &log ][ &show-all-intents ] |
Parametry zapytania umożliwiają skonfigurowanie sposobu i wartości zwracanych w odpowiedzi zapytania:
Parametr zapytania | Typ | Przeznaczenie |
---|---|---|
query |
sznurek | Wypowiedź użytkownika. |
verbose |
typ logiczny (boolowski) | Wartość logiczna wskazująca, czy zwracać wszystkie metadane dla przewidywanych modeli. Wartość domyślna to „false”. |
log |
typ logiczny (boolowski) | Rejestruje zapytania, które mogą być później używane do aktywnego uczenia. Wartość domyślna to „false”. |
show-all-intents |
typ logiczny (boolowski) | Wartość boolowska wskazująca, czy zwrócić wszystkie zamierzenia, czy tylko to najwyżej oceniane. Wartość domyślna to „false”. |
Zadawanie pytań do aplikacji LUIS
Przykładowe polecenie CURL służące do wykonywania zapytań dotyczących kontenera dla opublikowanej aplikacji to:
Aby wysłać zapytanie do modelu w slocie, użyj następującego API:
curl -G \
-d verbose=false \
-d log=true \
--data-urlencode "query=turn the lights on" \
"http://localhost:5000/luis/v3.0/apps/{APP_ID}/slots/production/predict"
Aby wykonywać zapytania w środowisku Staging, zastąp ciąg production
w ścieżce ciągiem staging
:
http://localhost:5000/luis/v3.0/apps/{APP_ID}/slots/staging/predict
Aby utworzyć zapytanie dotyczące wersji modelu, użyj następującego interfejsu API:
curl -G \
-d verbose=false \
-d log=false \
--data-urlencode "query=turn the lights on" \
"http://localhost:5000/luis/v3.0/apps/{APP_ID}/versions/{APP_VERSION}/predict"
Importowanie dzienników punktów końcowych na potrzeby aktywnego uczenia
Jeśli dla kontenera usługi LUIS określono punkt instalacji wyjściowej, pliki dziennika zapytań aplikacji są zapisywane w katalogu wyjściowym, gdzie {INSTANCE_ID}
jest identyfikatorem kontenera. Dziennik zapytań aplikacji zawiera zapytania, odpowiedź i znaczniki czasu dla każdego zapytania przewidywania przesłanego do kontenera usługi LUIS.
Poniższa lokalizacja przedstawia zagnieżdżoną strukturę katalogów dla plików dziennika kontenera.
/output/luis/{INSTANCE_ID}/
W portalu LUIS wybierz aplikację, a następnie wybierz pozycję Importuj dzienniki punktów końcowych aby zaimportować te dzienniki.
Po przekazaniu dziennika przejrzyj wypowiedzi punktu końcowego w portalu usługi LUIS.
Sprawdzanie, czy kontener jest uruchomiony
Istnieje kilka sposobów sprawdzania, czy kontener jest uruchomiony.
Znajdź zewnętrzny adres IP i uwidoczniony port danego kontenera i otwórz ulubioną przeglądarkę internetową. Użyj poniższych różnych adresów URL żądań, aby sprawdzić, czy kontener jest uruchomiony. Przykładowe adresy URL żądań wymienione w tym miejscu to http://localhost:5000
, ale określony kontener może się różnić. Upewnij się, że korzystasz z zewnętrznego adresu IP kontenera i ujawnionego portu.
Adres URL żądania | Przeznaczenie |
---|---|
http://localhost:5000/ |
Kontener zawiera stronę główną. |
http://localhost:5000/ready |
Żądany przy użyciu polecenia GET ten adres URL zapewnia weryfikację, że kontener jest gotowy do akceptowania zapytania względem modelu. To żądanie może być używane do sond żywotności i gotowości platformy Kubernetes. |
http://localhost:5000/status |
Ten adres URL, żądany również metodą GET, sprawdza, czy klucz API używany do uruchamiania kontenera jest prawidłowy, bez wywoływania zapytania do interfejsu API. To żądanie może być używane do sond żywotnoś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. |
Uruchamianie kontenera odłączonego od Internetu
Aby użyć tego kontenera odłączonego od Internetu, musisz najpierw zażądać dostępu, wypełniając aplikację i kupując plan zobowiązania. Aby uzyskać więcej informacji, zobacz Use Docker containers in disconnected environments (Używanie kontenerów platformy Docker w środowiskach bez połączenia).
Jeśli masz zgodę na uruchomienie kontenera odłączonego od Internetu, użyj poniższego przykładu pokazującego formatowanie polecenia docker run
, które użyjesz, z wartościami zastępczymi. Zastąp te wartości zastępcze własnymi wartościami.
Parametr DownloadLicense=True
w poleceniu docker run
pobierze plik licencji, który umożliwi uruchomienie kontenera platformy Docker, gdy nie jest połączony z Internetem. Zawiera również datę wygaśnięcia, po której plik licencji będzie nieprawidłowy do uruchomienia kontenera. Możesz używać pliku licencji tylko z odpowiednim kontenerem, do którego masz autoryzację. Na przykład nie można użyć pliku licencji dla kontenera przekształcania mowy na tekst z wykorzystaniem kontenera analizy dokumentów.
Element zastępczy | Wartość | Formatowanie lub przykład |
---|---|---|
{IMAGE} |
Obraz kontenera, którego chcesz użyć. | mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice |
{LICENSE_MOUNT} |
Ścieżka, na której zostanie pobrana i zamontowana licencja. | /host/license:/path/to/license/directory |
{ENDPOINT_URI} |
Punkt końcowy do uwierzytelniania żądania obsługi. Możesz go znaleźć na stronie Klucz i punkt końcowy zasobu w portalu Azure. | https://<your-custom-subdomain>.cognitiveservices.azure.com |
{API_KEY} |
Klucz dla Twojego zasobu analizy tekstu. Możesz go znaleźć na stronie Klucz i punkt końcowy zasobu w portalu Azure. | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
{CONTAINER_LICENSE_DIRECTORY} |
Lokalizacja folderu licencji w lokalnym systemie plików kontenera. | /path/to/license/directory |
docker run --rm -it -p 5000:5000 \
-v {LICENSE_MOUNT} \
{IMAGE} \
eula=accept \
billing={ENDPOINT_URI} \
apikey={API_KEY} \
DownloadLicense=True \
Mounts:License={CONTAINER_LICENSE_DIRECTORY}
Po pobraniu pliku licencji można uruchomić kontener w środowisku odłączonym. W poniższym przykładzie pokazano formatowanie polecenia docker run
, którego będziesz używać, wraz z wartościami zastępczymi. Zastąp te wartości zastępcze własnymi wartościami.
Wszędzie tam, gdzie kontener jest uruchamiany, plik licencji musi być zainstalowany w kontenerze, a lokalizacja folderu licencji w lokalnym systemie plików kontenera musi być określona za pomocą Mounts:License=
polecenia . Należy również określić punkt montowania wyjściowego, aby można było zapisywać dane zużycia do rozliczeń.
Element zastępczy | Wartość | Formatowanie lub przykład |
---|---|---|
{IMAGE} |
Obraz kontenera, którego chcesz użyć. | mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice |
{MEMORY_SIZE} |
Odpowiedni rozmiar pamięci do przydzielenia dla kontenera. | 4g |
{NUMBER_CPUS} |
Odpowiednia liczba CPU do przydzielenia na kontener. | 4 |
{LICENSE_MOUNT} |
Ścieżka, na której będzie znajdować się i instalowana licencja. | /host/license:/path/to/license/directory |
{OUTPUT_PATH} |
Ścieżka wyjściowa do rejestrowania danych o użyciu. | /host/output:/path/to/output/directory |
{CONTAINER_LICENSE_DIRECTORY} |
Lokalizacja folderu licencji w lokalnym systemie plików kontenera. | /path/to/license/directory |
{CONTAINER_OUTPUT_DIRECTORY} |
Lokalizacja folderu wyjściowego w lokalnym systemie plików kontenera. | /path/to/output/directory |
docker run --rm -it -p 5000:5000 --memory {MEMORY_SIZE} --cpus {NUMBER_CPUS} \
-v {LICENSE_MOUNT} \
-v {OUTPUT_PATH} \
{IMAGE} \
eula=accept \
Mounts:License={CONTAINER_LICENSE_DIRECTORY}
Mounts:Output={CONTAINER_OUTPUT_DIRECTORY}
Zatrzymaj kontener
Aby zamknąć kontener, w środowisku wiersza polecenia, w którym jest uruchomiony kontener, naciśnij Ctrl+C.
Rozwiązywanie problemów
Jeśli uruchamiasz kontener z montowaniem danych wyjściowych i włączonym rejestrowaniem, kontener generuje pliki dziennika, które są pomocne w rozwiązywaniu problemów występujących podczas uruchomienia lub pracy kontenera.
Wskazówka
Aby uzyskać więcej informacji na temat rozwiązywania problemów i wskazówek, zobacz Często zadawane pytania dotyczące kontenerów usługi Azure AI.
Jeśli masz problem z uruchomieniem kontenera usług Azure AI, możesz spróbować użyć kontenera diagnostyki firmy Microsoft. Ten kontener służy do diagnozowania typowych błędów w środowisku wdrażania, które mogą uniemożliwić działanie kontenerów usługi Azure AI zgodnie z oczekiwaniami.
Aby uzyskać kontener, użyj następującego docker pull
polecenia:
docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic
Następnie uruchom kontener. Zastąp {ENDPOINT_URI}
swoim punktem końcowym oraz zastąp {API_KEY}
swoim kluczem do zasobu:
docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}
Kontener będzie testować łączność sieciową z punktem końcowym rozliczeń.
Fakturowanie
Kontener usługi LUIS wysyła informacje rozliczeniowe na platformę Azure przy użyciu zasobu usług Azure AI na koncie platformy Azure.
Zapytania do kontenera są rozliczane w warstwie cenowej zasobu platformy Azure używanego dla parametru ApiKey
.
Kontenery usług AI platformy Azure nie są licencjonowane do uruchamiania bez połączenia z punktem końcowym pomiaru użytkowania ani rozliczeń. Należy zezwolić kontenerom na komunikowanie informacji rozliczeniowych z punktem końcowym rozliczeń przez cały czas. Kontenery usług AI platformy Azure nie wysyłają do firmy Microsoft danych klientów, takich jak obraz lub tekst analizowany.
Łączenie się z platformą Azure
Aby uruchomić kontener, potrzebne są wartości argumentów dotyczących rozliczeń. 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ług AI platformy Azure, aby uzyskać przykład informacji wysyłanych do firmy Microsoft na potrzeby rozliczeń.
Argumenty dotyczące fakturowania
Polecenie docker run
uruchomi kontener, gdy wszystkie trzy z następujących opcji są dostarczane z prawidłowymi wartościami:
Opcja | Opis |
---|---|
ApiKey |
Klucz API usługi Azure AI służący do śledzenia informacji o rozliczeniach. Wartość tej opcji musi być ustawiona na klucz interfejsu API dla zaaprowizowanego zasobu określonego w pliku Billing . |
Billing |
Punkt końcowy zasobu usług Azure AI używany do śledzenia informacji rozliczeniowych. Wartość tej opcji musi być ustawiona na URI punktu końcowego aprowizowanego zasobu 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
W tym artykule przedstawiono pojęcia i przepływ pracy dotyczące pobierania, instalowania i uruchamiania kontenerów usługi Language Understanding (LUIS). Podsumowanie:
- Usługa Language Understanding (LUIS) udostępnia jeden kontener systemu Linux dla platformy Docker zapewniający przewidywanie zapytań punktu końcowego wypowiedzi.
- Obrazy kontenerów są pobierane z usługi Microsoft Container Registry (MCR).
- Obrazy kontenerów działają w Dockerze.
- Interfejs API REST umożliwia wykonywanie zapytań dotyczących punktów końcowych kontenera przez określenie identyfikatora URI hosta kontenera.
- Podczas tworzenia kontenera należy określić informacje o rozliczeniach.
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.
Następne kroki
- Zapoznaj się z artykułem Konfigurowanie kontenerów pod kątem ustawień konfiguracji.
- Zobacz ograniczenia kontenera LUIS dla znanych ograniczeń funkcji.
- Zapoznaj się z artykułem Rozwiązywanie problemów, aby rozwiązać problemy związane z funkcją usługi LUIS.
- Korzystanie z większej liczby kontenerów sztucznej inteligencji platformy Azure