Konfigurera Language Understanding Docker-containrar
Viktigt!
LUIS dras tillbaka den 1 oktober 2025 och från och med den 1 april 2023 kommer du inte att kunna skapa nya LUIS-resurser. Vi rekommenderar att du migrerar dina LUIS-program till förståelse för konversationsspråk för att dra nytta av fortsatt produktsupport och flerspråkiga funktioner.
Luis-containerkörningsmiljön (Language Understanding) konfigureras med hjälp av kommandoargumentendocker run. LUIS har flera obligatoriska inställningar, tillsammans med några valfria inställningar. Det finns flera exempel på kommandot. De containerspecifika inställningarna är indatamonteringsinställningarna och faktureringsinställningarna.
Konfigurationsinställningar
Den här containern har följande konfigurationsinställningar:
| Obligatoriskt | Inställning | Syfte |
|---|---|---|
| Ja | ApiKey | Används för att spåra faktureringsinformation. |
| Nej | ApplicationInsights | Gör att du kan lägga till telemetristöd för Azure Application Insights i containern. |
| Ja | Billing | Anger slutpunkts-URI för tjänstresursen i Azure. |
| Ja | Eula | Anger att du har godkänt licensen för containern. |
| Nej | Fluentd | Skriv logg och, om du vill, måttdata till en Fluentd-server. |
| Nej | Http-proxy | Konfigurera en HTTP-proxy för att göra utgående begäranden. |
| Nej | Loggning | Tillhandahåller ASP.NET Core-loggningsstöd för din container. |
| Ja | Fästen | Läsa och skriva data från värddatorn till containern och från containern tillbaka till värddatorn. |
Viktigt!
ApiKeyInställningarna , Billingoch Eula används tillsammans och du måste ange giltiga värden för alla tre. Annars startar inte containern. Mer information om hur du använder dessa konfigurationsinställningar för att instansiera en container finns i Fakturering.
ApiKey-inställning
Inställningen ApiKey anger den Azure-resursnyckel som används för att spåra faktureringsinformation för containern. Du måste ange ett värde för ApiKey och värdet måste vara en giltig nyckel för den Azure AI-tjänstresurs som angetts för konfigurationsinställningen Billing .
Den här inställningen finns på följande platser:
- Azure-portalen: Resurshantering för Azure AI-tjänster under Nycklar
- LUIS-portalen: Sidan För nycklar och slutpunktsinställningar .
Använd inte startnyckeln eller redigeringsnyckeln.
ApplicationInsights-inställning
Med ApplicationInsights inställningen kan du lägga till telemetristöd för Azure Application Insights i containern. Application Insights ger djupgående övervakning av din container. Du kan enkelt övervaka din container för tillgänglighet, prestanda och användning. Du kan också snabbt identifiera och diagnostisera fel i containern.
I följande tabell beskrivs de konfigurationsinställningar som stöds i avsnittet ApplicationInsights .
| Obligatoriskt | Namn | Datatyp | beskrivning |
|---|---|---|---|
| Nej | InstrumentationKey |
String | Instrumentationsnyckeln för Application Insights-instansen som telemetridata för containern skickas till. Mer information finns i Application Insights för ASP.NET Core. Exempel: InstrumentationKey=123456789 |
Faktureringsinställning
Inställningen Billing anger slutpunkts-URI för Azure AI-tjänstresurseni Azure som används för att mäta faktureringsinformation för containern. Du måste ange ett värde för den här konfigurationsinställningen och värdet måste vara en giltig slutpunkts-URI för en Azure AI-tjänstresurs i Azure. Containern rapporterar användning var 10:e till 15:e minut.
Den här inställningen finns på följande platser:
- Azure-portalen: Översikt över Azure AI-tjänster , märkt
Endpoint - LUIS-portalen: Sidan För nycklar och slutpunktsinställningar som en del av slutpunkts-URI:n.
| Obligatoriskt | Namn | Datatyp | beskrivning |
|---|---|---|---|
| Ja | Billing |
sträng | URI för faktureringsslutpunkt. Mer information om hur du hämtar fakturerings-URI finns i samla in obligatoriska parametrar. Mer information och en fullständig lista över regionala slutpunkter finns i Anpassade underdomännamn för Azure AI-tjänster. |
Eula-inställning
Inställningen Eula anger att du har godkänt licensen för containern. Du måste ange ett värde för den här konfigurationsinställningen och värdet måste vara inställt på accept.
| Obligatoriskt | Namn | Datatyp | beskrivning |
|---|---|---|---|
| Ja | Eula |
String | Godkännande av licens Exempel: Eula=accept |
Azure AI-tjänstcontainrar licensieras enligt ditt avtal som styr din användning av Azure. Om du inte har ett befintligt avtal som styr din användning av Azure godkänner du att ditt avtal som styr användningen av Azure är Microsoft Online-prenumerationsavtalet, som innehåller villkoren för onlinetjänster. För förhandsversioner godkänner du även de kompletterande användningsvillkoren för Förhandsversioner av Microsoft Azure. Genom att använda containern godkänner du dessa villkor.
Inställningar för Fluentd
Fluentd är en datainsamlare med öppen källkod för enhetlig loggning. Fluentd Inställningarna hanterar containerns anslutning till en Fluentd-server. Containern innehåller en Fluentd-loggningsprovider som gör att din container kan skriva loggar och, om du vill, mätdata till en Fluentd-server.
I följande tabell beskrivs de konfigurationsinställningar som stöds i avsnittet Fluentd .
| Namn | Datatyp | beskrivning |
|---|---|---|
Host |
String | IP-adressen eller DNS-värdnamnet för Fluentd-servern. |
Port |
Integer | Porten för Fluentd-servern. Standardvärdet är 24224. |
HeartbeatMs |
Integer | Pulsslagsintervallet i millisekunder. Om ingen händelsetrafik har skickats innan det här intervallet upphör att gälla skickas ett pulsslag till Fluentd-servern. Standardvärdet är 6 0000 millisekunder (1 minut). |
SendBufferSize |
Integer | Nätverksbuffertutrymmet, i byte, allokerat för sändningsåtgärder. Standardvärdet är 32 768 byte (32 kilobyte). |
TlsConnectionEstablishmentTimeoutMs |
Integer | Tidsgränsen i millisekunder för att upprätta en SSL/TLS-anslutning med Fluentd-servern. Standardvärdet är 1 0000 millisekunder (10 sekunder). Om UseTLS värdet är inställt på false ignoreras det här värdet. |
UseTLS |
Booleskt | Anger om containern ska använda SSL/TLS för kommunikation med Fluentd-servern. Standardvärdet är "false". |
Inställningar för HTTP-proxyautentiseringsuppgifter
Om du behöver konfigurera en HTTP-proxy för att göra utgående begäranden använder du följande två argument:
| Namn | Datatyp | beskrivning |
|---|---|---|
| HTTP_PROXY | sträng | Proxyn som ska användas, till exempel http://proxy:8888<proxy-url> |
| HTTP_PROXY_CREDS | sträng | Eventuella autentiseringsuppgifter som krävs för att autentisera mot proxyn, username:passwordtill exempel . Det här värdet måste vara i gemener. |
<proxy-user> |
sträng | Användaren för proxyn. |
<proxy-password> |
sträng | Lösenordet som är associerat med <proxy-user> för proxyn. |
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
HTTP_PROXY=<proxy-url> \
HTTP_PROXY_CREDS=<proxy-user>:<proxy-password> \
Loggningsinställningar
Logging Inställningarna hanterar ASP.NET Core-loggningsstöd för din container. Du kan använda samma konfigurationsinställningar och värden för din container som du använder för ett ASP.NET Core-program.
Följande loggningsproviders stöds av containern:
| Provider | Syfte |
|---|---|
| Konsol | ASP.NET Core-loggningsprovidern Console . Alla ASP.NET Core-konfigurationsinställningar och standardvärden för den här loggningsprovidern stöds. |
| Debug | ASP.NET Core-loggningsprovidern Debug . Alla ASP.NET Core-konfigurationsinställningar och standardvärden för den här loggningsprovidern stöds. |
| Disk | JSON-loggningsprovidern. Den här loggningsprovidern skriver loggdata till utdatamonteringen. |
Det här containerkommandot lagrar loggningsinformation i JSON-format till utdatamonteringen:
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
--mount type=bind,src=/home/azureuser/output,target=/output \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Disk:Format=json \
Mounts:Output=/output
Det här containerkommandot visar felsökningsinformation, prefixet med dbug, medan containern körs:
docker run --rm -it -p 5000:5000 \
--memory 2g --cpus 1 \
<registry-location>/<image-name> \
Eula=accept \
Billing=<endpoint> \
ApiKey=<api-key> \
Logging:Console:LogLevel:Default=Debug
Diskloggning
Loggningsprovidern Disk stöder följande konfigurationsinställningar:
| Namn | Datatyp | beskrivning |
|---|---|---|
Format |
String | Utdataformatet för loggfiler. Obs! Det här värdet måste anges för att json aktivera loggningsprovidern. Om det här värdet anges utan att ange en utdatamontering vid instansiering av en container uppstår ett fel. |
MaxFileSize |
Integer | Den maximala storleken i mb för en loggfil. När storleken på den aktuella loggfilen uppfyller eller överskrider det här värdet startas en ny loggfil av loggningsprovidern. Om -1 anges begränsas loggfilens storlek endast av den maximala filstorleken, om någon, för utdatamonteringen. Standardvärdet är 1. |
Mer information om hur du konfigurerar ASP.NET Core-loggningsstöd finns i Inställningar filkonfiguration.
Monteringsinställningar
Använd bindningsmonteringar för att läsa och skriva data till och från containern. Du kan ange en indatamontering eller utdatamontering genom att --mount ange alternativet i kommandot docker run .
LUIS-containern använder inte indata- eller utdatamonteringar för att lagra tränings- eller tjänstdata.
Den exakta syntaxen för värdmonteringsplatsen varierar beroende på värdoperativsystemet. Dessutom kanske värddatorns monteringsplats inte är tillgänglig på grund av en konflikt mellan behörigheter som används av Docker-tjänstkontot och värdmonteringsplatsbehörigheterna.
I följande tabell beskrivs de inställningar som stöds.
| Obligatoriskt | Namn | Datatyp | beskrivning |
|---|---|---|---|
| Ja | Input |
String | Målet för indatamonteringen. Standardvärdet är /input. Det här är platsen för LUIS-paketfilerna. Exempel: --mount type=bind,src=c:\input,target=/input |
| Nej | Output |
String | Målet för utdatamonteringen. Standardvärdet är /output. Det här är platsen för loggarna. Detta inkluderar LUIS-frågeloggar och containerloggar. Exempel: --mount type=bind,src=c:\output,target=/output |
Exempel på docker-körningskommandon
I följande exempel används konfigurationsinställningarna för att illustrera hur du skriver och använder docker run kommandon. När containern körs fortsätter den att köras tills du stoppar den.
- I de här exemplen används katalogen utanför
C:enheten för att undvika eventuella behörighetskonflikter i Windows. Om du behöver använda en specifik katalog som indatakatalog kan du behöva bevilja docker-tjänsten behörighet. - Ändra inte ordningen på argumenten om du inte är mycket bekant med Docker-containrar.
- Om du använder ett annat operativsystem använder du rätt konsol/terminal, mappsyntax för monteringar och radfortsättningstecken för systemet. Dessa exempel förutsätter en Windows-konsol med ett radfortsättningstecken
^. Eftersom containern är ett Linux-operativsystem använder målmonteringen en mappsyntax i Linux-stil.
Ersätt {argument_name} med dina egna värden:
| Platshållare | Värde | Format eller exempel |
|---|---|---|
| {API_KEY} | Slutpunktsnyckeln för resursen LUIS på sidan Azure LUIS Keys. |
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| {ENDPOINT_URI} | Värdet för faktureringsslutpunkten är tillgängligt på sidan Översikt över Azure LUIS . |
Se samla in obligatoriska parametrar för explicita exempel. |
Kommentar
Nya resurser som skapats efter den 1 juli 2019 använder anpassade underdomännamn. Mer information och en fullständig lista över regionala slutpunkter finns i Anpassade underdomännamn för Azure AI-tjänster.
Viktigt!
Alternativen Eula, Billingoch ApiKey måste anges för att köra containern. Annars startar inte containern. Mer information finns i Fakturering.
ApiKey-värdet är nyckeln från sidan Nycklar och slutpunkter i LUIS-portalen och är också tillgängligt på sidan Azure-resursnycklar Azure AI services .
Grundläggande exempel
I följande exempel finns det minst möjliga argument för att köra containern:
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/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY}
ApplicationInsights-exempel
I följande exempel anges argumentet ApplicationInsights för att skicka telemetri till Application Insights medan containern körs:
docker run --rm -it -p 5000:5000 --memory 6g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY} ^
InstrumentationKey={INSTRUMENTATION_KEY}
Loggningsexempel
Följande kommando anger loggningsnivån, , Logging:Console:LogLevelför att konfigurera loggningsnivån till Information.
docker run --rm -it -p 5000:5000 --memory 6g --cpus 2 ^
--mount type=bind,src=c:\input,target=/input ^
--mount type=bind,src=c:\output,target=/output ^
mcr.microsoft.com/azure-cognitive-services/luis:latest ^
Eula=accept ^
Billing={ENDPOINT_URL} ^
ApiKey={API_KEY} ^
Logging:Console:LogLevel:Default=Information
Nästa steg
- Läs Installera och köra containrar
- Se Felsökning för att lösa problem som rör LUIS-funktioner.
- Använda fler Azure AI-containrar