A Language Understanding Docker-tárolók konfigurálása
Fontos
A LUIS 2025. október 1-jén megszűnik, és 2023. április 1-től nem hozhat létre új LUIS-erőforrásokat. Javasoljuk, hogy a LUIS-alkalmazásokat a beszélgetési nyelv megértésére migrálja, hogy kihasználhassa a terméktámogatás és a többnyelvű képességek előnyeit.
A Language Understanding (LUIS) tároló futtatókörnyezete a docker run parancsargumentumok használatával van konfigurálva. A LUIS számos kötelező beállítással és néhány választható beállítással rendelkezik. A parancsra számos példa érhető el. A tárolóspecifikus beállítások a bemeneti csatlakoztatási beállítások és a számlázási beállítások.
Konfigurációs beállítások
Ez a tároló a következő konfigurációs beállításokkal rendelkezik:
| Szükséges | Beállítás | Cél |
|---|---|---|
| Igen | ApiKey | A számlázási adatok nyomon követésére szolgál. |
| Nem | ApplicationInsights | Lehetővé teszi Azure-alkalmazás Elemzések telemetriai támogatás hozzáadását a tárolóhoz. |
| Igen | Számlázás | Az Azure-beli szolgáltatáserőforrás végponti URI-ját adja meg. |
| Igen | Eula | Azt jelzi, hogy elfogadta a tároló licencét. |
| Nem | Fluentd | Napló- és metrikaadatok írása fluentd-kiszolgálóra. |
| Nem | Http-proxy | HTTP-proxy konfigurálása kimenő kérések végrehajtásához. |
| Nem | Logging | ASP.NET Alapvető naplózási támogatást biztosít a tárolóhoz. |
| Igen | Tartók | Adatok olvasása és írása gazdaszámítógépről tárolóra, tárolóról tárolóról gazdaszámítógépre. |
Fontos
A ApiKeyrendszer együtt használja a , Billingés Eula a beállításokat, és mind a háromhoz érvényes értékeket kell megadnia; ellenkező esetben a tároló nem indul el. A tárolók példányosításához a konfigurációs beállítások használatával kapcsolatos további információkért lásd a Számlázás című témakört.
ApiKey-beállítás
A ApiKey beállítás megadja a tároló számlázási adatainak nyomon követéséhez használt Azure-erőforráskulcsot. Meg kell adnia egy értéket az ApiKey számára, és az értéknek érvényes kulcsnak kell lennie a konfigurációs beállításhoz megadott Azure AI-szolgáltatások erőforrásához Billing .
Ez a beállítás a következő helyeken található:
- Azure Portal: Azure AI-szolgáltatások erőforrás-kezelése a Kulcsok területen
- LUIS-portál: Kulcsok és végpontbeállítások lap.
Ne használja a kezdőkulcsot vagy a szerzői kulcsot.
Alkalmazás Elemzések beállítás
A ApplicationInsights beállítással Azure-alkalmazás Elemzések telemetriai támogatást adhat a tárolóhoz. Az alkalmazás Elemzések a tároló részletes monitorozását biztosítja. A tárolót egyszerűen monitorozhatja a rendelkezésre állás, a teljesítmény és a használat szempontjából. Emellett gyorsan azonosíthatja és diagnosztizálhatja a tároló hibáit.
Az alábbi táblázat a szakaszban támogatott ApplicationInsights konfigurációs beállításokat ismerteti.
| Szükséges | Name | Adattípus | Leírás |
|---|---|---|---|
| Nem | InstrumentationKey |
Sztring | Az alkalmazás eszközkulcsa Elemzések példány, amelyre a tároló telemetriai adatait küldi. További információ: Application Elemzések for ASP.NET Core. Példa: InstrumentationKey=123456789 |
Számlázási beállítás
A Billing beállítás megadja a tároló számlázási adatainak mérésére használt Azure AI-szolgáltatási erőforrás végponti URI-ját az Azure-ban. Meg kell adnia egy értéket ehhez a konfigurációs beállításhoz, és az értéknek érvényes végponti URI-nak kell lennie egy Azure AI-szolgáltatási erőforráshoz az Azure-ban. A tároló körülbelül 10–15 percenként jelenti a használatot.
Ez a beállítás a következő helyeken található:
- Azure Portal: Az Azure AI-szolgáltatások áttekintése, címkézett
Endpoint - LUIS-portál: Kulcsok és végpontbeállítások lap a végpont URI részeként.
| Szükséges | Name | Adattípus | Leírás |
|---|---|---|---|
| Igen | Billing |
sztring | Számlázási végpont URI-ja. A számlázási URI beszerzéséről további információt a szükséges paraméterek összegyűjtése című témakörben talál. További információkért és a regionális végpontok teljes listájáért tekintse meg az Azure AI-szolgáltatások egyéni altartományneveit. |
Eula beállítás
A Eula beállítás azt jelzi, hogy elfogadta a tároló licencét. Ehhez a konfigurációs beállításhoz meg kell adnia egy értéket, az értéknek pedig a következőre acceptkell lennie.
| Szükséges | Name | Adattípus | Leírás |
|---|---|---|---|
| Igen | Eula |
Sztring | Licenc elfogadása Példa: Eula=accept |
Az Azure AI-szolgáltatások tárolóinak licencelése az Ön szerződése alapján, az Azure használatára vonatkozik. Ha nem rendelkezik az Azure használatára vonatkozó meglévő szerződéssel, elfogadja, hogy az Azure használatára vonatkozó szerződése a Microsoft Online Előfizetési Szerződés, amely tartalmazza az online szolgáltatási feltételeket. Az előzetes verziók esetében ön elfogadja a Microsoft Azure Előzetes verzióra vonatkozó kiegészítő használati feltételeket is. A tároló használatával elfogadja ezeket a feltételeket.
Fluentd-beállítások
A Fluentd egy nyílt forráskódú adatgyűjtő az egységes naplózáshoz. A Fluentd beállítások kezelik a tároló fluentd-kiszolgálóhoz való kapcsolatát. A tároló tartalmaz egy Fluentd naplózási szolgáltatót, amely lehetővé teszi, hogy a tároló naplókat írjon, és opcionálisan metrikaadatokat írjon egy Fluentd-kiszolgálóra.
Az alábbi táblázat a szakaszban támogatott Fluentd konfigurációs beállításokat ismerteti.
| Név | Adattípus | Leírás |
|---|---|---|
Host |
Sztring | A Fluentd-kiszolgáló IP-címe vagy DNS-állomásneve. |
Port |
Egész | A Fluentd-kiszolgáló portja. Az alapértelmezett érték 24224. |
HeartbeatMs |
Egész | A szívverési időköz ezredmásodpercben. Ha az időköz lejárta előtt nem küldött eseményforgalmat, a rendszer szívverést küld a Fluentd-kiszolgálónak. Az alapértelmezett érték 60000 ezredmásodperc (1 perc). |
SendBufferSize |
Egész | A küldési műveletekhez lefoglalt hálózati pufferterület bájtban. Az alapértelmezett érték 32768 bájt (32 kilobájt). |
TlsConnectionEstablishmentTimeoutMs |
Egész | Ezredmásodpercben az időtúllépés a Fluentd-kiszolgálóval létesített SSL-/TLS-kapcsolat létrehozásához. Az alapértelmezett érték 10000 ezredmásodperc (10 másodperc). Ha UseTLS hamis értékre van állítva, a rendszer figyelmen kívül hagyja ezt az értéket. |
UseTLS |
Logikai | Azt jelzi, hogy a tárolónak SSL/TLS protokollt kell-e használnia a Fluentd-kiszolgálóval való kommunikációhoz. Az alapértelmezett érték: hamis. |
HTTP-proxy hitelesítő adatainak beállításai
Ha HTTP-proxyt kell konfigurálnia a kimenő kérések végrehajtásához, használja az alábbi két argumentumot:
| Név | Adattípus | Leírás |
|---|---|---|
| HTTP_PROXY | sztring | A használni kívánt proxy, például: http://proxy:8888<proxy-url> |
| HTTP_PROXY_CREDS | sztring | A proxyn való hitelesítéshez szükséges hitelesítő adatok, például username:password. Ennek az értéknek kisbetűsnek kell lennie. |
<proxy-user> |
sztring | A proxy felhasználója. |
<proxy-password> |
sztring | A proxyhoz <proxy-user> társított jelszó. |
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> \
Naplózási beállítások
A Logging beállítások kezelik a tároló ASP.NET Core naplózási támogatását. Ugyanazokat a konfigurációs beállításokat és értékeket használhatja a tárolóhoz, amelyeket egy ASP.NET Core-alkalmazáshoz használ.
A tároló a következő naplózási szolgáltatókat támogatja:
| Provider | Cél |
|---|---|
| Console | A ASP.NET Core Console naplózási szolgáltató. A naplózási szolgáltató összes ASP.NET alapkonfigurációs beállítása és alapértelmezett értéke támogatott. |
| Debug | A ASP.NET Core Debug naplózási szolgáltató. A naplózási szolgáltató összes ASP.NET alapkonfigurációs beállítása és alapértelmezett értéke támogatott. |
| Disk | A JSON-naplózási szolgáltató. Ez a naplózási szolgáltató naplóadatokat ír a kimeneti csatlakoztatáshoz. |
Ez a tárolóparancs JSON formátumban tárolja a naplózási adatokat a kimeneti csatlakoztatáshoz:
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
Ez a tárolóparancs a hibakeresési információkat jeleníti meg, a tároló futása közben előtaggal dbug:
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
Lemeznaplózás
A Disk naplózási szolgáltató a következő konfigurációs beállításokat támogatja:
| Név | Adattípus | Leírás |
|---|---|---|
Format |
Sztring | A naplófájlok kimeneti formátuma. Megjegyzés: Ezt az értéket úgy kell beállítani, hogy json engedélyezze a naplózási szolgáltatót. Ha ez az érték anélkül van megadva, hogy kimeneti csatlakoztatást is megad a tároló példányosítása közben, hiba történik. |
MaxFileSize |
Egész | A naplófájl maximális mérete megabájtban (MB). Ha az aktuális naplófájl mérete eléri vagy meghaladja ezt az értéket, a naplózási szolgáltató elindít egy új naplófájlt. Ha -1 van megadva, a naplófájl méretét csak a kimeneti csatlakoztatás maximális fájlmérete korlátozza. Az alapértelmezett érték 1. |
A ASP.NET Core naplózási támogatásának konfigurálásáról további információt Gépház fájlkonfigurációban talál.
Csatlakoztatási beállítások
A kötés csatlakoztatásával adatokat olvashat és írhat a tárolóba és onnan. A docker-futtatási --mount parancs beállításának megadásával bemeneti csatlakoztatást vagy kimeneti csatlakoztatást is megadhat.
A LUIS-tároló nem használ bemeneti vagy kimeneti csatlakoztatásokat a betanítási vagy szolgáltatási adatok tárolására.
A gazdagép csatlakoztatási helyének pontos szintaxisa a gazdagép operációs rendszerétől függően változik. Emellett előfordulhat, hogy a gazdaszámítógép csatlakoztatási helye nem érhető el a Docker szolgáltatásfiók által használt engedélyek és a gazdagép csatlakoztatási helyének engedélyei közötti ütközés miatt.
Az alábbi táblázat a támogatott beállításokat ismerteti.
| Szükséges | Name | Adattípus | Leírás |
|---|---|---|---|
| Igen | Input |
Sztring | A bemeneti csatlakoztatás célja. The default value is /input. Ez a LUIS-csomagfájlok helye. Példa: --mount type=bind,src=c:\input,target=/input |
| Nem | Output |
Sztring | A kimeneti csatlakoztatás célja. The default value is /output. Ez a naplók helye. Ide tartoznak a LUIS-lekérdezési naplók és a tárolónaplók. Példa: --mount type=bind,src=c:\output,target=/output |
Példa Docker-futtatási parancsok
Az alábbi példák a konfigurációs beállításokkal szemléltetik a parancsok írását és használatát docker run . A futtatás után a tároló addig fut, amíg le nem állítja .
- Ezek a példák a meghajtón kívüli könyvtárat használják az
C:engedélyütközések elkerülése érdekében a Windowson. Ha egy adott könyvtárat kell használnia bemeneti könyvtárként, előfordulhat, hogy engedélyt kell adnia a Docker szolgáltatásnak. - Ne módosítsa az argumentumok sorrendjét, hacsak nem ismeri a Docker-tárolókat.
- Ha másik operációs rendszert használ, használja a megfelelő konzolt/terminált, a csatlakoztatások mappaszintaxisát és a vonal folytatási karakterét a rendszer számára. Ezek a példák azt feltételezik, hogy egy Windows-konzol vonal folytatási karakterrel rendelkezik
^. Mivel a tároló Linux operációs rendszer, a cél csatlakoztatása Linux-stílusú mappaszintaxist használ.
A(z) {argument_name} helyére írja be a saját értékeit:
| Helyőrző | Érték | Formátum vagy példa |
|---|---|---|
| {API_KEY} | Az erőforrás végpontkulcsa az LUIS Azure LUIS Keys lapon. |
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx |
| {ENDPOINT_URI} | A számlázási végpont értéke az Azure LUIS Áttekintés oldalán érhető el. |
Az explicit példákhoz tekintse meg a szükséges paraméterek gyűjtését. |
Megjegyzés:
A 2019. július 1. után létrehozott új erőforrások egyéni altartományneveket fognak használni. További információkért és a regionális végpontok teljes listájáért tekintse meg az Azure AI-szolgáltatások egyéni altartományneveit.
Fontos
A Eulatároló futtatásához meg kell adni a , Billingés ApiKey a beállításokat, ellenkező esetben a tároló nem indul el. További információ: Számlázás.
Az ApiKey-érték a LUIS-portál Kulcsok és végpontok lapján található kulcs , és az Azure-erőforráskulcsok Azure AI services oldalán is elérhető.
Egyszerű példa
Az alábbi példában a tároló futtatására a lehető legkevesebb argumentum használható:
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}
Alkalmazás Elemzések példa
Az alábbi példa beállítja az Alkalmazás Elemzések argumentumot, hogy telemetriát küldjön az Alkalmazás Elemzések a tároló futtatása közben:
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}
Példa naplózásra
Az alábbi parancs beállítja a naplózási szintet, Logging:Console:LogLevelhogy a naplózási szintet a következőre konfigurálja 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
További lépések
- Tárolók telepítésének és futtatásának áttekintése
- A LUIS-funkciókkal kapcsolatos problémák megoldásához tekintse meg a hibaelhárítást.
- További Azure AI-tárolók használata