Installera och kör Docker-behållare för LUISInstall and run Docker containers for LUIS

Anteckning

Behållar avbildningens plats har nyligen ändrats.The container image location has recently changed. Läs den här artikeln om du vill se den uppdaterade platsen för den här behållaren.Read this article to see the updated location for this container.

Med behållare kan du använda LUIS i din egen miljö.Containers enable you to use LUIS in your own environment. Containrar är bra för specifika säkerhets- och datastyrningskrav.Containers are great for specific security and data governance requirements. I den här artikeln får du lära dig hur du hämtar, installerar och kör en LUIS-behållare.In this article you'll learn how to download, install, and run a LUIS container.

Behållaren Language Understanding (LUIS) läser in din utbildade eller publicerade Language Understanding modell.The Language Understanding (LUIS) container loads your trained or published Language Understanding model. Som en Luis-appger Docker-behållaren åtkomst till frågan förutsägelser från BEHÅLLAREns API-slutpunkter.As a LUIS app, the docker container provides access to the query predictions from the container's API endpoints. Du kan samla in loggar från behållaren och överföra tillbaka dem till Language Understanding-appen för att förbättra appens förutsägelse noggrannhet.You can collect query logs from the container and upload them back to the Language Understanding app to improve the app's prediction accuracy.

Följande video visar hur du använder den här behållaren.The following video demonstrates using this container.

Demonstration av behållare för Cognitive ServicesContainer demonstration for Cognitive Services

Om du inte har någon Azure-prenumeration kan du skapa ett kostnadsfritt konto innan du börjar.If you don't have an Azure subscription, create a free account before you begin.

FörutsättningarPrerequisites

Observera följande krav för att köra LUIS-behållaren:To run the LUIS container, note the following prerequisites:

KrävsRequired SyftePurpose
Docker-motornDocker Engine Du behöver Docker-motorn installerad på en värddator.You need the Docker Engine installed on a host computer. Docker innehåller paket som konfigurerar Docker-miljön på macOS, Windows och Linux.Docker provides packages that configure the Docker environment on macOS, Windows, and Linux. En introduktion till grunderna för Docker och containrar finns i Docker-översikt.For a primer on Docker and container basics, see the Docker overview.

Docker måste konfigureras för att tillåta att behållarna ansluter till och skicka fakturerings data till Azure.Docker must be configured to allow the containers to connect with and send billing data to Azure.

I Windowsmåste Docker också konfigureras för att stödja Linux-behållare.On Windows, Docker must also be configured to support Linux containers.

Bekant med DockerFamiliarity with Docker Du bör ha grundläggande kunskaper om Docker-koncept, t. ex. register, databaser, behållare och behållar avbildningar, samt kunskaper om grundläggande docker kommandon.You should have a basic understanding of Docker concepts, like registries, repositories, containers, and container images, as well as knowledge of basic docker commands.
Azure Cognitive Services Resource och Luis paketerad app -filAzure Cognitive Services resource and LUIS packaged app file För att du ska kunna använda behållaren måste du ha:In order to use the container, you must have:

* En Cognitive Services Azure-resurs och den associerade fakturerings nyckeln för fakturerings slut punktens URI.* A Cognitive Services Azure resource and the associated billing key the billing endpoint URI. Båda värdena är tillgängliga på sidorna översikt och nycklar för resursen och krävs för att starta behållaren.Both values are available on the Overview and Keys pages for the resource and are required to start the container.
* En utbildad eller publicerad app paketeras som monterad inström till behållaren med dess associerade app-ID.* A trained or published app packaged as a mounted input to the container with its associated App ID. Du kan hämta den paketerade filen från LUIS-portalen eller redigera-API: er.You can get the packaged file from the LUIS portal or the Authoring APIs. Om du får LUIS paketerad app från redigerings-API: er, behöver du också din redigerings nyckel.If you are getting LUIS packaged app from the authoring APIs, you will also need your Authoring Key.

Dessa krav används för att skicka kommando rads argument till följande variabler:These requirements are used to pass command-line arguments to the following variables:

{AUTHORING_KEY}: den här nyckeln används för att hämta den paketerade appen från Luis-tjänsten i molnet och ladda upp frågan loggar tillbaka till molnet.{AUTHORING_KEY}: This key is used to get the packaged app from the LUIS service in the cloud and upload the query logs back to the cloud. Formatet är xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.The format is xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

{APP_ID}: detta ID används för att välja appen.{APP_ID}: This ID is used to select the App. Formatet är xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.The format is xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

{Api_key}: den här nyckeln används för att starta behållaren.{API_KEY}: This key is used to start the container. Du kan hitta slut punkts nyckeln på två platser.You can find the endpoint key in two places. Det första är Azure Portal i Cognitive Services resursens nyckel lista.The first is the Azure portal within the Cognitive Services resource's keys list. Slut punkts nyckeln är också tillgänglig i LUIS-portalen på sidan nycklar och inställningar för slut punkt.The endpoint key is also available in the LUIS portal on the Keys and Endpoint settings page. Använd inte start nyckeln.Do not use the starter key.

{ENDPOINT_URI}: slut punkten enligt vad som anges på översikts sidan.{ENDPOINT_URI}: The endpoint as provided on the Overview page.

Redigerings nyckeln och slut punkts nyckeln har olika syfte.The authoring key and endpoint key have different purposes. Använd dem inte interoförändrade.Do not use them interchangeably.

Nödvändiga parametrar samlas inGathering required parameters

Det finns tre primära parametrar för alla Cognitive Services behållare som krävs.There are three primary parameters for all Cognitive Services' containers that are required. Licens avtalet för slutanvändare (EULA) måste vara närvarande med värdet accept .The end-user license agreement (EULA) must be present with a value of accept. Dessutom behövs både en slut punkts-URL och API-nyckel.Additionally, both an Endpoint URL and API Key are needed.

Slut punkts-URI {ENDPOINT_URI}Endpoint URI {ENDPOINT_URI}

URI-värdet för slut punkten är tillgängligt på sidan Azure Portal Översikt för motsvarande kognitiva tjänst resurs.The Endpoint URI value is available on the Azure portal Overview page of the corresponding Cognitive Service resource. Gå till sidan Översikt , Hovra över slut punkten och en Copy to clipboard ikon visas.Navigate to the Overview page, hover over the Endpoint, and a Copy to clipboard icon will appear. Kopiera och använd vid behov.Copy and use where needed.

Samla in slut punkts-URI för senare användning

Nyckel {API_KEY}Keys {API_KEY}

Den här nyckeln används för att starta behållaren och är tillgänglig på sidan Azure Portals nycklar för motsvarande kognitiva tjänst resurser.This key is used to start the container, and is available on the Azure portal's Keys page of the corresponding Cognitive Service resource. Gå till sidan nycklar och klicka på Copy to clipboard ikonen.Navigate to the Keys page, and click on the Copy to clipboard icon.

Hämta en av de två nycklarna för senare användning

Viktigt

Dessa prenumerations nycklar används för att få åtkomst till ditt kognitiva tjänst-API.These subscription keys are used to access your Cognitive Service API. Dela inte dina nycklar.Do not share your keys. Lagra dem på ett säkert sätt, till exempel med hjälp av Azure Key Vault.Store them securely, for example, using Azure Key Vault. Vi rekommenderar också att du återskapar nycklarna regelbundet.We also recommend regenerating these keys regularly. Endast en nyckel krävs för att göra ett API-anrop.Only one key is necessary to make an API call. När du återskapar den första nyckeln kan du använda den andra nyckeln för fortsatt åtkomst till tjänsten.When regenerating the first key, you can use the second key for continued access to the service.

Redigera API: er för paketfilAuthoring APIs for package file

Redigera API: er för paketerade appar:Authoring APIs for packaged apps:

VärddatornThe host computer

Värden är en x64-baserad dator som kör Docker-behållaren.The host is a x64-based computer that runs the Docker container. Det kan vara en dator på din lokala dator eller en Docker-värd tjänst i Azure, till exempel:It can be a computer on your premises or a Docker hosting service in Azure, such as:

Krav och rekommendationer för behållareContainer requirements and recommendations

I tabellen nedan visas de lägsta och rekommenderade värdena för behållar värden.The below table lists minimum and recommended values for the container host. Dina krav kan ändras beroende på trafik volym.Your requirements may change depending on traffic volume.

ContainerContainer MinimumMinimum RekommenderasRecommended TPSTPS
(Minimum, maximum)(Minimum, Maximum)
LUISLUIS 1 kärna, 2 GB minne1 core, 2-GB memory 1 kärna, 4 GB minne1 core, 4-GB memory 20, 4020, 40
  • Varje kärna måste vara minst 2,6 gigahertz (GHz) eller snabbare.Each core must be at least 2.6 gigahertz (GHz) or faster.
  • TPS-transaktioner per sekundTPS - transactions per second

Core och minne motsvarar --cpus --memory inställningarna och som används som en del av docker run kommandot.Core and memory correspond to the --cpus and --memory settings, which are used as part of the docker run command.

Hämta behållar avbildningen med docker pullGet the container image with docker pull

Använd docker pull kommandot för att ladda ned en behållar avbildning från mcr.microsoft.com/azure-cognitive-services/language/luis lagrings platsen:Use the docker pull command to download a container image from the mcr.microsoft.com/azure-cognitive-services/language/luis repository:

docker pull mcr.microsoft.com/azure-cognitive-services/language/luis:latest

En fullständig beskrivning av tillgängliga taggar, till exempel som latest används i föregående kommando, finns i Luis på Docker Hub.For a full description of available tags, such as latest used in the preceding command, see LUIS on Docker Hub.

Tips

Du kan använda kommandot Docker images för att visa en lista över hämtade behållar avbildningar.You can use the docker images command to list your downloaded container images. Följande kommando visar till exempel ID, lagrings plats och tagg för varje Hämtad behållar avbildning, formaterad som en tabell:For example, the following command lists the ID, repository, and tag of each downloaded container image, formatted as a table:

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

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

Använda behållarenHow to use the container

När behållaren är på värddatornanvänder du följande process för att arbeta med behållaren.Once the container is on the host computer, use the following process to work with the container.

Process för att använda Language Understanding-behållare (LUIS)

  1. Exportera paket för container från Luis-portalen eller Luis-API: er.Export package for container from LUIS portal or LUIS APIs.
  2. Flytta paket filen till den nödvändiga indatafilenvärddatorn.Move package file into the required input directory on the host computer. Byt inte namn på, ändra, Skriv över eller expandera LUIS-paketfilen.Do not rename, alter, overwrite, or decompress the LUIS package file.
  3. Kör behållarenmed nödvändiga inställningar för montering och fakturering av indatakälla .Run the container, with the required input mount and billing settings. Fler exempeldocker run kommandot är tillgängliga.More examples of the docker run command are available.
  4. Fråga efter behållarens förutsägelse slut punkt.Querying the container's prediction endpoint.
  5. När du är färdig med behållaren importerar du slut punkts loggarna från utmatnings monteringen i Luis-portalen och stoppar behållaren.When you are done with the container, import the endpoint logs from the output mount in the LUIS portal and stop the container.
  6. Använd LUIS-portalens aktiva utbildning på sidan Granska slut punkt yttranden för att förbättra appen.Use LUIS portal's active learning on the Review endpoint utterances page to improve the app.

Appen som körs i behållaren kan inte ändras.The app running in the container can't be altered. För att kunna ändra appen i behållaren måste du ändra appen i LUIS-tjänsten med hjälp av Luis -portalen eller använda Luis- redigerings-API: erna.In order to change the app in the container, you need to change the app in the LUIS service using the LUIS portal or use the LUIS authoring APIs. Träna och/eller publicera och hämta sedan ett nytt paket och kör behållaren igen.Then train and/or publish, then download a new package and run the container again.

LUIS-appen i behållaren kan inte exporteras tillbaka till LUIS-tjänsten.The LUIS app inside the container can't be exported back to the LUIS service. Endast fråga loggar kan överföras.Only the query logs can be uploaded.

Exportera paketerad app från LUISExport packaged app from LUIS

LUIS-containern kräver en utbildad eller publicerad LUIS-app för att besvara förutsägelse frågor för användar yttranden.The LUIS container requires a trained or published LUIS app to answer prediction queries of user utterances. För att hämta LUIS-appen använder du antingen det utbildade eller publicerade paket-API: et.In order to get the LUIS app, use either the trained or published package API.

Standard platsen är input under katalogen i relation till den plats där du kör docker run kommandot.The default location is the input subdirectory in relation to where you run the docker run command.

Placera paket filen i en katalog och referera till den här katalogen som indata-montering när du kör Docker-behållaren.Place the package file in a directory and reference this directory as the input mount when you run the docker container.

Paket typerPackage types

Monterings katalogen för indatamängden kan innehålla produktions-, mellanlagrings-och versions modeller för appen samtidigt.The input mount directory can contain the Production, Staging, and Versioned models of the app simultaneously. Alla paket är monterade.All the packages are mounted.

Typ av paketPackage Type API för frågans slut punktQuery Endpoint API Tillgänglighet för frågaQuery availability Paketets fil namns formatPackage filename format
VersionsVersioned HÄMTA, PUBLICERAGET, POST Endast behållareContainer only {APP_ID}_v{APP_VERSION}.gz
MellanlagringStaging HÄMTA, PUBLICERAGET, POST Azure och containerAzure and container {APP_ID}_STAGING.gz
ProduktionProduction HÄMTA, PUBLICERAGET, POST Azure och containerAzure and container {APP_ID}_PRODUCTION.gz

Viktigt

Byt inte namn på, ändra, Skriv över eller expandera LUIS-paketfilerna.Do not rename, alter, overwrite, or decompress the LUIS package files.

Förpacknings kravPackaging prerequisites

Innan du packar ett LUIS-program måste du ha följande:Before packaging a LUIS application, you must have the following:

Förpacknings kravPackaging Requirements InformationDetails
Resurs instans för Azure Cognitive ServicesAzure Cognitive Services resource instance Regioner som stöds ärSupported regions include

USA, västra ( westus )West US (westus)
Västeuropa ( westeurope )West Europe (westeurope)
Östra Australien ( australiaeast )Australia East (australiaeast)
Tränad eller publicerad LUIS-appTrained or published LUIS app Utan stödda beroenden.With no unsupported dependencies.
Åtkomst till värd datornsfil systemAccess to the host computer's file system Värddatorn måste tillåta en indata-montering.The host computer must allow an input mount.

Exportera appaket från LUIS-portalenExport app package from LUIS portal

LUIS- portalen ger möjlighet att exportera den utbildade eller publicerade appens paket.The LUIS portal provides the ability to export the trained or published app's package.

Exportera den publicerade appens paket från LUIS-portalenExport published app's package from LUIS portal

Den publicerade appens paket är tillgängligt från List sidan Mina appar .The published app's package is available from the My Apps list page.

  1. Logga in på LUIS- portalen.Sign on to the LUIS portal.
  2. Markera kryss rutan till vänster om appens namn i listan.Select the checkbox to the left of the app name in the list.
  3. Välj Exportera objekt från kontext verktygsfältet ovanför listan.Select the Export item from the contextual toolbar above the list.
  4. Välj export for container (gzip).Select Export for container (GZIP).
  5. Välj miljö för produktions plats eller mellanlagringsplats.Select the environment of Production slot or Staging slot.
  6. Paketet laddas ned från webbläsaren.The package is downloaded from the browser.

Exportera det publicerade paketet för behållaren från App-sidans export meny

Exportera den versions bara appens paket från LUIS-portalenExport versioned app's package from LUIS portal

Den versions bara appens paket är tillgängligt på sidan versions lista.The versioned app's package is available from the Versions list page.

  1. Logga in på LUIS- portalen.Sign on to the LUIS portal.
  2. Välj appen i listan.Select the app in the list.
  3. Välj Hantera i appens navigerings fält.Select Manage in the app's navigation bar.
  4. Välj versioner i det vänstra navigerings fältet.Select Versions in the left navigation bar.
  5. Markera kryss rutan till vänster om versions namnet i listan.Select the checkbox to the left of the version name in the list.
  6. Välj Exportera objekt från kontext verktygsfältet ovanför listan.Select the Export item from the contextual toolbar above the list.
  7. Välj export for container (gzip).Select Export for container (GZIP).
  8. Paketet laddas ned från webbläsaren.The package is downloaded from the browser.

Exportera det utbildade paketet för behållaren från sidan Exportera på versioner-menyn

Exportera den publicerade appens paket från APIExport published app's package from API

Använd följande REST API metod för att paketera en LUIS-app som du redan har publicerat.Use the following REST API method, to package a LUIS app that you've already published. Ersätt dina egna lämpliga värden för plats hållarna i API-anropet med hjälp av tabellen under HTTP-specifikationen.Substituting your own appropriate values for the placeholders in the API call, using the table below the HTTP specification.

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}
PlatshållarePlaceholder VärdeValue
{APP_ID}{APP_ID} Program-ID för den publicerade LUIS-appen.The application ID of the published LUIS app.
{SLOT_NAME}{SLOT_NAME} Den publicerade LUIS-appens miljö.The environment of the published LUIS app. Använd något av följande värden:Use one of the following values:
PRODUCTION
STAGING
{AUTHORING_KEY}{AUTHORING_KEY} Redigerings nyckeln för LUIS-kontot för den publicerade LUIS-appen.The authoring key of the LUIS account for the published LUIS app.
Du kan hämta din redigerings nyckel från sidan användar inställningar på Luis-portalen.You can get your authoring key from the User Settings page on the LUIS portal.
{AZURE_REGION}{AZURE_REGION} Lämplig Azure-region:The appropriate Azure region:

westus – Västra USAwestus - West US
westeurope – Västeuropawesteurope - West Europe
australiaeast – Australien, östaustraliaeast - Australia East

Information om hur du hämtar det publicerade paketet finns i API-dokumentationen här.To download the published package, refer to the API documentation here. Om det har hämtats är svaret en LUIS-paketfil.If successfully downloaded, the response is a LUIS package file. Spara filen på den lagrings plats som angetts för behållaren för indata-montering.Save the file in the storage location specified for the input mount of the container.

Exportera det versions bara programmets paket från APIExport versioned app's package from API

Använd följande REST API metod för att paketera ett LUIS-program som du redan har tränat.Use the following REST API method, to package a LUIS application that you've already trained. Ersätt dina egna lämpliga värden för plats hållarna i API-anropet med hjälp av tabellen under HTTP-specifikationen.Substituting your own appropriate values for the placeholders in the API call, using the table below the HTTP specification.

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}
PlatshållarePlaceholder VärdeValue
{APP_ID}{APP_ID} Program-ID för den tränade LUIS-appen.The application ID of the trained LUIS app.
{APP_VERSION}{APP_VERSION} Program versionen av den tränade LUIS-appen.The application version of the trained LUIS app.
{AUTHORING_KEY}{AUTHORING_KEY} Redigerings nyckeln för LUIS-kontot för den publicerade LUIS-appen.The authoring key of the LUIS account for the published LUIS app.
Du kan hämta din redigerings nyckel från sidan användar inställningar på Luis-portalen.You can get your authoring key from the User Settings page on the LUIS portal.
{AZURE_REGION}{AZURE_REGION} Lämplig Azure-region:The appropriate Azure region:

westus – Västra USAwestus - West US
westeurope – Västeuropawesteurope - West Europe
australiaeast – Australien, östaustraliaeast - Australia East

Information om hur du hämtar det versions bara paketet finns i API-dokumentationen här.To download the versioned package, refer to the API documentation here. Om det har hämtats är svaret en LUIS-paketfil.If successfully downloaded, the response is a LUIS package file. Spara filen på den lagrings plats som angetts för behållaren för indata-montering.Save the file in the storage location specified for the input mount of the container.

Kör behållaren med docker runRun the container with docker run

Använd kommandot Docker Run för att köra behållaren.Use the docker run command to run the container. Läs om hur du samlar in nödvändiga parametrar för information om hur du hämtar {ENDPOINT_URI} och- {API_KEY} värden.Refer to gathering required parameters for details on how to get the {ENDPOINT_URI} and {API_KEY} values.

Exempeldocker run kommandot är tillgängliga.Examples of the docker run command are available.

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}
  • I det här exemplet används katalogen utanför C: enheten för att undvika eventuella behörighets konflikter i Windows.This example uses the directory off the C: drive to avoid any permission conflicts on Windows. Om du behöver använda en speciell katalog som indatalistan kan du behöva ge Docker-tjänstens behörighet.If you need to use a specific directory as the input directory, you may need to grant the docker service permission.
  • Ändra inte ordningen på argumenten om du inte är bekant med Docker-behållare.Do not change the order of the arguments unless you are familiar with docker containers.
  • Om du använder ett annat operativ system använder du rätt konsol/Terminal, kommandosyntax för montering och linje fortsättnings text för systemet.If you are using a different operating system, use the correct console/terminal, folder syntax for mounts, and line continuation character for your system. Dessa exempel förutsätter en Windows-konsol med ett linje fortsättnings steg ^ .These examples assume a Windows console with a line continuation character ^. Eftersom behållaren är ett Linux-operativsystem använder mål-Mount en syntax för en mappvy i Linux-typ.Because the container is a Linux operating system, the target mount uses a Linux-style folder syntax.

Det här kommandot:This command:

  • Kör en behållare från LUIS container imageRuns a container from the LUIS container image
  • Läser in LUIS-appen från indataports montering vid C:\input, som finns på behållar värdenLoads LUIS app from input mount at C:\input, located on container host
  • Allokerar två processor kärnor och 4 GB minneAllocates two CPU cores and 4 gigabytes (GB) of memory
  • Exponerar TCP-port 5000 och allokerar en pseudo-TTY för behållarenExposes TCP port 5000 and allocates a pseudo-TTY for the container
  • Sparar behållaren och LUIS loggar för att mata ut montering vid C:\output, som finns på behållar värdenSaves container and LUIS logs to output mount at C:\output, located on container host
  • Tar automatiskt bort behållaren när den har avslut ATS.Automatically removes the container after it exits. Behållar avbildningen är fortfarande tillgänglig på värddatorn.The container image is still available on the host computer.

Fler exempeldocker run kommandot är tillgängliga.More examples of the docker run command are available.

Viktigt

EulaAlternativen, Billing och ApiKey måste anges för att köra behållaren, annars startar inte behållaren.The Eula, Billing, and ApiKey options must be specified to run the container; otherwise, the container won't start. Mer information finns i fakturering.For more information, see Billing. ApiKey-värdet är nyckeln från sidan Azure-resurser på Luis-portalen och finns också på sidan med Azures Cognitive Services resurs nycklar.The ApiKey value is the Key from the Azure Resources page in the LUIS portal and is also available on the Azure Cognitive Services resource keys page.

Kör flera behållare på samma värdRun multiple containers on the same host

Om du tänker köra flera behållare med exponerade portar ska du se till att köra varje behållare med en annan exponerad port.If you intend to run multiple containers with exposed ports, make sure to run each container with a different exposed port. Kör till exempel den första behållaren på port 5000 och den andra behållaren på port 5001.For example, run the first container on port 5000 and the second container on port 5001.

Du kan ha den här behållaren och en annan Azure Cognitive Services-behållare som körs på värden tillsammans.You can have this container and a different Azure Cognitive Services container running on the HOST together. Du kan också ha flera behållare av samma Cognitive Services-behållare som kör.You also can have multiple containers of the same Cognitive Services container running.

Slut punkts-API: er som stöds av behållarenEndpoint APIs supported by the container

Både v2-och v3 -versioner av API: et är tillgängliga med behållaren.Both V2 and V3 versions of the API are available with the container.

Köra frågor mot containerns förutsägelseslutpunktQuery the container's prediction endpoint

Containern innehåller REST-baserade slutpunkts-API:er för frågeförutsägelse.The container provides REST-based query prediction endpoint APIs. Slut punkter för publicerade appar (mellanlagring eller produktion) har en annan väg än slut punkter för versions program.Endpoints for published (staging or production) apps have a different route than endpoints for versioned apps.

Använd värden, http://localhost:5000, för container-API:er.Use the host, http://localhost:5000, for container APIs.

PakettypPackage type HTTP-verbHTTP verb VägRoute FrågeparametrarQuery parameters
PubliceradPublished HÄMTA, PUBLICERAGET, POST /luis/v3.0/apps/{appId}/slots/{slotName}/predict? query={query}
[&verbose][&verbose]
[&log][&log]
[&show-all-intents][&show-all-intents]
VersionsVersioned HÄMTA, PUBLICERAGET, POST /luis/v3.0/apps/{appId}/versions/{versionId}/predict? query={query}
[&verbose][&verbose]
[&log][&log]
[&show-all-intents][&show-all-intents]

Frågeparametrarna konfigurerar hur och vad som returneras i svaret för frågan:The query parameters configure how and what is returned in the query response:

FrågeparameterQuery parameter TypType SyftePurpose
query strängstring Användarens uttryck.The user's utterance.
verbose booleanboolean Ett booleskt värde som anger om alla metadata ska returneras för de förväntade modellerna.A boolean value indicating whether to return all the metadata for the predicted models. Standardvärdet är false.Default is false.
log booleanboolean Loggar frågor som kan användas senare för aktiv inlärning.Logs queries, which can be used later for active learning. Standardvärdet är false.Default is false.
show-all-intents booleanboolean Ett booleskt värde som anger om alla intentor eller den översta bedömnings metoden ska returneras.A boolean value indicating whether to return all the intents or the top scoring intent only. Standardvärdet är false.Default is false.

Fråga LUIS-appenQuery the LUIS app

Ett exempel på en spiral-kommando för att skicka frågor till behållaren för en publicerad app är:An example CURL command for querying the container for a published app is:

Om du vill fråga en modell på en plats använder du följande API:To query a model in a slot, use the following 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"

Om du vill göra frågor till mellanlagrings miljön ersätter du production i vägen med staging :To make queries to the Staging environment, replace production in the route with staging:

http://localhost:5000/luis/v3.0/apps/{APP_ID}/slots/staging/predict

Om du vill fråga en versions modell använder du följande API:To query a versioned model, use the following 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"

Importera slut punkts loggarna för aktiv inlärningImport the endpoint logs for active learning

Om en utgående montering har angetts för LUIS-behållaren, sparas i utdatakatalogen, där {INSTANCE_ID} är behållar-ID.If an output mount is specified for the LUIS container, app query log files are saved in the output directory, where {INSTANCE_ID} is the container ID. Appens fråga logg innehåller frågan, svaret och tidsstämplar för varje förutsägelse fråga som skickats till behållaren LUIS.The app query log contains the query, response, and timestamps for each prediction query submitted to the LUIS container.

Följande plats visar den kapslade katalog strukturen för behållarens loggfiler.The following location shows the nested directory structure for the container's log files.

/output/luis/{INSTANCE_ID}/

Välj din app från LUIS-portalen och välj sedan Importera slut punkts loggar för att ladda upp loggarna.From the LUIS portal, select your app, then select Import endpoint logs to upload these logs.

Importera behållarens loggfiler för aktiv inlärning

När loggen har laddats upp granskar du slut punkts yttranden i Luis-portalen.After the log is uploaded, review the endpoint utterances in the LUIS portal.

Verifiera att en behållare körsValidate that a container is running

Det finns flera sätt att verifiera att behållaren körs.There are several ways to validate that the container is running. Leta reda på den externa IP- adressen och den exponerade porten för den aktuella behållaren och öppna din favorit webbläsare.Locate the External IP address and exposed port of the container in question, and open your favorite web browser. Använd de olika URL: erna för begäran nedan för att verifiera att behållaren körs.Use the various request URLs below to validate the container is running. URL: erna för exempel begär Anden som anges nedan är http://localhost:5000 , men din speciella behållare kan variera.The example request URLs listed below are http://localhost:5000, but your specific container may vary. Tänk på att du är beroende av behållarens externa IP -adress och exponerad port.Keep in mind that you're to rely on your container's External IP address and exposed port.

URL för begäranRequest URL SyftePurpose
http://localhost:5000/ Containern tillhandahåller en startsida.The container provides a home page.
http://localhost:5000/ready Begärd med GET, detta ger en verifiering av att behållaren är redo att acceptera en fråga mot modellen.Requested with GET, this provides a verification that the container is ready to accept a query against the model. Den här begäran kan användas för Kubernetes Live och beredskaps avsökningar.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/status Begärd med GET, kontrollerar detta om den API-nyckel som används för att starta behållaren är giltig utan att orsaka en slut punkts fråga.Also requested with GET, this verifies if the api-key used to start the container is valid without causing an endpoint query. Den här begäran kan användas för Kubernetes Live och beredskaps avsökningar.This request can be used for Kubernetes liveness and readiness probes.
http://localhost:5000/swagger Containern tillhandahåller en fullständig uppsättning dokumentation för slutpunkterna samt en Prova-funktion.The container provides a full set of documentation for the endpoints and a Try it out feature. Med den här funktionen kan du ange dina inställningar i ett webbaserat HTML-formulär och göra frågan utan att behöva skriva någon kod.With this feature, you can enter your settings into a web-based HTML form and make the query without having to write any code. När frågan returnerar visas ett exempel på ett spiral kommando som visar de HTTP-rubriker och det text format som krävs.After the query returns, an example CURL command is provided to demonstrate the HTTP headers and body format that's required.

Behållarens start sida

Stoppa containernStop the container

Om du vill stänga av behållaren trycker du på CTRL + Ci den kommando rads miljö där behållaren körs.To shut down the container, in the command-line environment where the container is running, press Ctrl+C.

FelsökningTroubleshooting

Om du kör behållaren med en utgående montering och loggning aktive rad genererar behållaren loggfiler som är till hjälp vid fel sökning av problem som inträffar när du startar eller kör behållaren.If you run the container with an output mount and logging enabled, the container generates log files that are helpful to troubleshoot issues that happen while starting or running the container.

Tips

Mer felsöknings information och vägledning finns i Cognitive Services behållare vanliga frågor och svar.For more troubleshooting information and guidance, see Cognitive Services containers frequently asked questions (FAQ).

FaktureringBilling

LUIS-behållaren skickar fakturerings information till Azure med hjälp av en Cognitive Services resurs på ditt Azure-konto.The LUIS container sends billing information to Azure, using a Cognitive Services resource on your Azure account.

Frågor till behållaren debiteras enligt pris nivån för den Azure-resurs som används för ApiKey .Queries to the container are billed at the pricing tier of the Azure resource that's used for the ApiKey.

Azure Cognitive Services-behållare är inte licensierade för att köras utan att vara anslutna till avläsnings-/fakturerings slut punkten.Azure Cognitive Services containers aren't licensed to run without being connected to the metering / billing endpoint. Du måste göra det möjligt för behållarna att kommunicera fakturerings information med fakturerings slut punkten hela tiden.You must enable the containers to communicate billing information with the billing endpoint at all times. Cognitive Services behållare skickar inte kund information, till exempel den bild eller text som analyseras, till Microsoft.Cognitive Services containers don't send customer data, such as the image or text that's being analyzed, to Microsoft.

Anslut till AzureConnect to Azure

Containern behöver de fakturerings argument värden som ska köras.The container needs the billing argument values to run. Dessa värden tillåter att behållaren ansluter till fakturerings slut punkten.These values allow the container to connect to the billing endpoint. Behållar rapporteringen visar var 10 till 15: e minut.The container reports usage about every 10 to 15 minutes. Om behållaren inte ansluter till Azure inom den tillåtna tids perioden fortsätter behållaren att köras men hanterar inte frågor förrän fakturerings slut punkten återställs.If the container doesn't connect to Azure within the allowed time window, the container continues to run but doesn't serve queries until the billing endpoint is restored. Anslutnings försöket görs 10 gånger med samma tidsintervall 10 till 15 minuter.The connection is attempted 10 times at the same time interval of 10 to 15 minutes. Om den inte kan ansluta till fakturerings slut punkten inom 10 försök slutar behållaren att betjäna begär Anden.If it can't connect to the billing endpoint within the 10 tries, the container stops serving requests.

Fakturerings argumentBilling arguments

docker run Kommandot startar behållaren när alla tre av följande alternativ finns med giltiga värden :The docker run command will start the container when all three of the following options are provided with valid values:

AlternativOption BeskrivningDescription
ApiKey API-nyckeln för den Cognitive Services resurs som används för att spåra fakturerings information.The API key of the Cognitive Services resource that's used to track billing information.
Värdet för det här alternativet måste anges till en API-nyckel för den etablerade resurs som anges i Billing .The value of this option must be set to an API key for the provisioned resource that's specified in Billing.
Billing Slut punkten för den Cognitive Services resursen som används för att spåra fakturerings information.The endpoint of the Cognitive Services resource that's used to track billing information.
Värdet för det här alternativet måste anges till slut punkts-URI för en etablerad Azure-resurs.The value of this option must be set to the endpoint URI of a provisioned Azure resource.
Eula Anger att du har accepterat licensen för behållaren.Indicates that you accepted the license for the container.
Värdet för det här alternativet måste vara inställt på acceptera.The value of this option must be set to accept.

Mer information om dessa alternativ finns i Configure containers.For more information about these options, see Configure containers.

BlogginläggBlog posts

UtvecklarexempelDeveloper samples

Exempel på utvecklare finns på vår GitHub-lagringsplats.Developer samples are available at our GitHub repository.

Visa webb seminariumView webinar

Delta i webb seminarium för att lära dig mer om:Join the webinar to learn about:

  • Distribuera Cognitive Services till vilken dator som helst med hjälp av DockerHow to deploy Cognitive Services to any machine using Docker
  • Så här distribuerar du Cognitive Services till AKSHow to deploy Cognitive Services to AKS

SammanfattningSummary

I den här artikeln har du lärt dig begrepp och arbets flöde för att ladda ned, installera och köra Language Understanding-behållare (LUIS).In this article, you learned concepts and workflow for downloading, installing, and running Language Understanding (LUIS) containers. Sammanfattningsvis:In summary:

  • Language Understanding (LUIS) innehåller en Linux-behållare för Docker som tillhandahåller slut punkts frågan förutsägelser av yttranden.Language Understanding (LUIS) provides one Linux container for Docker providing endpoint query predictions of utterances.
  • Behållar avbildningar hämtas från Microsoft Container Registry (MCR).Container images are downloaded from the Microsoft Container Registry (MCR).
  • Behållar avbildningar körs i Docker.Container images run in Docker.
  • Du kan använda REST API för att fråga behållarens slut punkter genom att ange behållarens värd-URI.You can use REST API to query the container endpoints by specifying the host URI of the container.
  • Du måste ange fakturerings information när du instansierar en behållare.You must specify billing information when instantiating a container.

Viktigt

Cognitive Services behållare är inte licensierade att köras utan att vara anslutna till Azure för mätning.Cognitive Services containers are not licensed to run without being connected to Azure for metering. Kunderna behöver göra det möjligt för behållarna att kommunicera fakturerings information med mät tjänsten hela tiden.Customers need to enable the containers to communicate billing information with the metering service at all times. Cognitive Services behållare skickar inte kund information (till exempel den bild eller text som analyseras) till Microsoft.Cognitive Services containers do not send customer data (for example, the image or text that is being analyzed) to Microsoft.

Nästa stegNext steps