Language Understanding Docker-containers configureren
Belangrijk
LUIS wordt op 1 oktober 2025 buiten gebruik gesteld en vanaf 1 april 2023 kunt u geen nieuwe LUIS-resources maken. We raden u aan uw LUIS-toepassingen te migreren naar gesprekstaalbegrip om te profiteren van continue productondersteuning en meertalige mogelijkheden.
De Language Understanding-containerruntime-omgeving (LUIS) wordt geconfigureerd met behulp van de docker run opdrachtargumenten. LUIS heeft verschillende vereiste instellingen, samen met enkele optionele instellingen. Er zijn verschillende voorbeelden van de opdracht beschikbaar. De containerspecifieke instellingen zijn de instellingen voor invoerkoppeling en de factureringsinstellingen.
Configuratie-instellingen
Deze container heeft de volgende configuratie-instellingen:
| Vereist | Instelling | Purpose |
|---|---|---|
| Ja | ApiKey | Wordt gebruikt om factureringsgegevens bij te houden. |
| Nee | ApplicationInsights | Hiermee kunt u ondersteuning voor Azure-toepassing Insights-telemetrie toevoegen aan uw container. |
| Ja | Facturering | Hiermee geeft u de eindpunt-URI van de serviceresource in Azure op. |
| Ja | Overeenkomst | Geeft aan dat u de licentie voor de container hebt geaccepteerd. |
| Nee | Fluentd | Schrijf logboek en eventueel metrische gegevens naar een Fluentd-server. |
| Nee | Http-proxy | Configureer een HTTP-proxy voor het maken van uitgaande aanvragen. |
| Nee | Logboekregistratie | Biedt ondersteuning voor ASP.NET Core-logboekregistratie voor uw container. |
| Ja | Mounts | Gegevens lezen en schrijven van hostcomputer naar container en van container terug naar hostcomputer. |
Belangrijk
De ApiKey, Billingen Eula de instellingen worden samen gebruikt en u moet geldige waarden opgeven voor alle drie. Anders wordt de container niet gestart. Zie Facturering voor meer informatie over het gebruik van deze configuratie-instellingen om een container te instantiëren.
ApiKey-instelling
Met ApiKey de instelling geeft u de Azure-resourcesleutel op die wordt gebruikt om factureringsgegevens voor de container bij te houden. U moet een waarde opgeven voor de ApiKey en de waarde moet een geldige sleutel zijn voor de Azure AI-servicesresource die is opgegeven voor de Billing configuratie-instelling.
Deze instelling vindt u op de volgende plaatsen:
- Azure Portal: Resourcebeheer van Azure AI-services onder Sleutels
- LUIS-portal: pagina Sleutels en eindpuntinstellingen .
Gebruik de starterssleutel of de ontwerpsleutel niet.
ApplicationInsights-instelling
Met de ApplicationInsights instelling kunt u Azure-toepassing insights-telemetrieondersteuning toevoegen aan uw container. Application Insights biedt uitgebreide bewaking van uw container. U kunt uw container eenvoudig controleren op beschikbaarheid, prestaties en gebruik. U kunt ook snel fouten in uw container identificeren en diagnosticeren.
In de volgende tabel worden de configuratie-instellingen beschreven die worden ondersteund in de ApplicationInsights sectie.
| Vereist | Naam | Gegevenstype | Beschrijving |
|---|---|---|---|
| Nee | InstrumentationKey |
String | De instrumentatiesleutel van het Application Insights-exemplaar waarnaar telemetriegegevens voor de container worden verzonden. Zie Application Insights voor ASP.NET Core voor meer informatie. Voorbeeld: InstrumentationKey=123456789 |
Factureringsinstelling
De Billing instelling geeft de eindpunt-URI op van de Azure AI-servicesresource in Azure die wordt gebruikt om factureringsgegevens voor de container te meten. U moet een waarde opgeven voor deze configuratie-instelling en de waarde moet een geldige eindpunt-URI zijn voor een Azure AI-servicesresource in Azure. De container rapporteert ongeveer om de 10 tot 15 minuten het gebruik.
Deze instelling vindt u op de volgende plaatsen:
- Azure Portal: Overzicht van Azure AI-services , gelabeld
Endpoint - LUIS-portal: pagina Sleutels en eindpuntinstellingen , als onderdeel van de eindpunt-URI.
| Vereist | Naam | Gegevenstype | Beschrijving |
|---|---|---|---|
| Ja | Billing |
tekenreeks | Eindpunt-URI voor facturering. Zie de vereiste parameters verzamelen voor meer informatie over het verkrijgen van de facturerings-URI. Zie Aangepaste subdomeinnamen voor Azure AI-services voor meer informatie en een volledige lijst met regionale eindpunten. |
Eula-instelling
De Eula instelling geeft aan dat u de licentie voor de container hebt geaccepteerd. U moet een waarde opgeven voor deze configuratie-instelling en de waarde moet worden ingesteld op accept.
| Vereist | Naam | Gegevenstype | Beschrijving |
|---|---|---|---|
| Ja | Eula |
String | Licentie-acceptatie Voorbeeld: Eula=accept |
Azure AI-servicescontainers worden in licentie gegeven onder uw overeenkomst voor uw gebruik van Azure. Als u geen bestaande overeenkomst hebt voor uw gebruik van Azure, gaat u ermee akkoord dat uw overeenkomst voor het gebruik van Azure de Microsoft Online-abonnementsovereenkomst is, die de voorwaarden voor onlineservices bevat. Voor previews gaat u ook akkoord met de aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews. Door de container te gebruiken, gaat u akkoord met deze voorwaarden.
Fluentd-instellingen
Fluentd is een opensource-gegevensverzamelaar voor geïntegreerde logboekregistratie. De Fluentd instellingen beheren de verbinding van de container met een Fluentd-server . De container bevat een Fluentd-logboekregistratieprovider, waarmee uw container logboeken kan schrijven en, optioneel, metrische gegevens naar een Fluentd-server.
In de volgende tabel worden de configuratie-instellingen beschreven die worden ondersteund in de Fluentd sectie.
| Naam | Gegevenstype | Beschrijving |
|---|---|---|
Host |
String | Het IP-adres of de DNS-hostnaam van de Fluentd-server. |
Port |
Geheel getal | De poort van de Fluentd-server. De standaardwaarde is 24224. |
HeartbeatMs |
Geheel getal | Het heartbeatinterval, in milliseconden. Als er geen gebeurtenisverkeer is verzonden voordat dit interval verloopt, wordt een heartbeat verzonden naar de Fluentd-server. De standaardwaarde is 60000 milliseconden (1 minuut). |
SendBufferSize |
Geheel getal | De netwerkbufferruimte, in bytes, die is toegewezen voor verzendbewerkingen. De standaardwaarde is 32768 bytes (32 kilobytes). |
TlsConnectionEstablishmentTimeoutMs |
Geheel getal | De time-out, in milliseconden, om een SSL/TLS-verbinding tot stand te brengen met de Fluentd-server. De standaardwaarde is 10000 milliseconden (10 seconden). Als UseTLS deze waarde is ingesteld op false, wordt deze waarde genegeerd. |
UseTLS |
Booleaanse waarde | Geeft aan of de container SSL/TLS moet gebruiken voor communicatie met de Fluentd-server. De standaardwaarde is false. |
Instellingen voor HTTP-proxyreferenties
Als u een HTTP-proxy wilt configureren voor het maken van uitgaande aanvragen, gebruikt u deze twee argumenten:
| Naam | Gegevenstype | Beschrijving |
|---|---|---|
| HTTP_PROXY | tekenreeks | De proxy die moet worden gebruikt, bijvoorbeeld http://proxy:8888<proxy-url> |
| HTTP_PROXY_CREDS | tekenreeks | Referenties die nodig zijn voor verificatie bij de proxy, username:passwordbijvoorbeeld. Deze waarde moet in kleine letters staan. |
<proxy-user> |
tekenreeks | De gebruiker voor de proxy. |
<proxy-password> |
tekenreeks | Het wachtwoord dat is <proxy-user> gekoppeld aan de proxy. |
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> \
Instellingen voor logboekregistratie
De Logging instellingen beheren ASP.NET Core-logboekregistratieondersteuning voor uw container. U kunt dezelfde configuratie-instellingen en -waarden gebruiken voor uw container die u gebruikt voor een ASP.NET Core-toepassing.
De volgende providers voor logboekregistratie worden ondersteund door de container:
| Provider | Doel |
|---|---|
| Console | De ASP.NET Core-logboekregistratieprovider Console . Alle ASP.NET Core-configuratie-instellingen en standaardwaarden voor deze logboekregistratieprovider worden ondersteund. |
| Fouten opsporen | De ASP.NET Core-logboekregistratieprovider Debug . Alle ASP.NET Core-configuratie-instellingen en standaardwaarden voor deze logboekregistratieprovider worden ondersteund. |
| schijf | De JSON-logboekregistratieprovider. Deze logboekprovider schrijft logboekgegevens naar de uitvoerkoppeling. |
Met deze containeropdracht worden logboekgegevens opgeslagen in de JSON-indeling naar de uitvoerkoppeling:
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
Deze containeropdracht bevat informatie over foutopsporing, voorafgegaan door dbug, terwijl de container wordt uitgevoerd:
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
Schijflogboekregistratie
De Disk logboekregistratieprovider ondersteunt de volgende configuratie-instellingen:
| Naam | Gegevenstype | Beschrijving |
|---|---|---|
Format |
String | De uitvoerindeling voor logboekbestanden. Opmerking: deze waarde moet worden ingesteld om json de logboekregistratieprovider in te schakelen. Als deze waarde is opgegeven zonder ook een uitvoerkoppeling op te geven tijdens het instantiëren van een container, treedt er een fout op. |
MaxFileSize |
Geheel getal | De maximale grootte, in megabytes (MB), van een logboekbestand. Wanneer de grootte van het huidige logboekbestand aan deze waarde voldoet of overschrijdt, wordt er een nieuw logboekbestand gestart door de logboekregistratieprovider. Als -1 is opgegeven, wordt de grootte van het logboekbestand alleen beperkt door de maximale bestandsgrootte, indien aanwezig, voor de uitvoerkoppeling. De standaardwaarde is 1. |
Zie Configuratie van instellingenbestand voor meer informatie over het configureren van ASP.NET Core-logboekregistratieondersteuning.
Instellingen koppelen
Gebruik bindingskoppelingen om gegevens naar en van de container te lezen en te schrijven. U kunt een invoerkoppeling of uitvoerkoppeling opgeven door de --mount optie op te geven in de opdracht docker-run .
De LUIS-container gebruikt geen invoer- of uitvoerkoppelingen om trainingsgegevens of servicegegevens op te slaan.
De exacte syntaxis van de locatie van de hostkoppeling varieert afhankelijk van het hostbesturingssysteem. Daarnaast is de koppelingslocatie van de hostcomputer mogelijk niet toegankelijk vanwege een conflict tussen machtigingen die worden gebruikt door het docker-serviceaccount en de machtigingen voor de hostkoppelingslocatie.
In de volgende tabel worden de ondersteunde instellingen beschreven.
| Vereist | Naam | Gegevenstype | Beschrijving |
|---|---|---|---|
| Ja | Input |
String | Het doel van de invoerkoppeling. De standaardwaarde is /input. Dit is de locatie van de LUIS-pakketbestanden. Voorbeeld: --mount type=bind,src=c:\input,target=/input |
| Nee | Output |
String | Het doel van de uitvoerkoppeling. De standaardwaarde is /output. Dit is de locatie van de logboeken. Dit omvat LUIS-querylogboeken en containerlogboeken. Voorbeeld: --mount type=bind,src=c:\output,target=/output |
Voorbeeld van docker-uitvoeropdrachten
In de volgende voorbeelden worden de configuratie-instellingen gebruikt om te laten zien hoe u opdrachten schrijft en gebruikt docker run . Zodra de container wordt uitgevoerd, blijft de container actief totdat u deze stopt .
- In deze voorbeelden wordt de map van het
C:station gebruikt om machtigingsconflicten in Windows te voorkomen. Als u een specifieke map als invoermap moet gebruiken, moet u mogelijk de docker-servicemachtiging verlenen. - Wijzig de volgorde van de argumenten niet, tenzij u bekend bent met docker-containers.
- Als u een ander besturingssysteem gebruikt, gebruikt u de juiste console/terminal, de mapsyntaxis voor koppels en het regelvervolgteken voor uw systeem. In deze voorbeelden wordt ervan uitgegaan dat een Windows-console met een regelvervolgteken wordt gebruikt
^. Omdat de container een Linux-besturingssysteem is, maakt de doelkoppeling gebruik van de syntaxis van een map in Linux-stijl.
Vervang {argument_name} door uw eigen waarden:
| Tijdelijke aanduiding | Weergegeven als | Opmaak of voorbeeld |
|---|---|---|
| {API_KEY} | De eindpuntsleutel van de LUIS resource op de pagina Azure-sleutels LUIS . |
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| {ENDPOINT_URI} | De waarde van het factureringseindpunt is beschikbaar op de LUIS azure-overzichtspagina. |
Zie vereiste parameters verzamelen voor expliciete voorbeelden. |
Notitie
Nieuwe resources die zijn gemaakt na 1 juli 2019, hebben aangepaste subdomeinnamen. Zie Aangepaste subdomeinnamen voor Azure AI-services voor meer informatie en een volledige lijst met regionale eindpunten.
Belangrijk
De Eula, Billingen ApiKey opties moeten worden opgegeven om de container uit te voeren. Anders wordt de container niet gestart. Zie Facturering voor meer informatie.
De apiKey-waarde is de sleutel op de pagina Sleutels en eindpunten in de LUIS-portal en is ook beschikbaar op de pagina Azure-resourcesleutels Azure AI services .
Basisvoorbeeld
In het volgende voorbeeld zijn de minste argumenten mogelijk om de container uit te voeren:
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}
Voorbeeld van ApplicationInsights
In het volgende voorbeeld wordt het argument ApplicationInsights ingesteld om telemetrie te verzenden naar Application Insights terwijl de container wordt uitgevoerd:
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}
Voorbeeld van logboekregistratie
Met de volgende opdracht stelt u het logboekregistratieniveau in Logging:Console:LogLevelom het logboekregistratieniveau te configureren op 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
Volgende stappen
- Controleren hoe u containers installeert en uitvoert
- Raadpleeg Probleemoplossing om problemen met betrekking tot LUIS-functionaliteit op te lossen.
- Meer Azure AI-containers gebruiken