A Language Understanding Docker-tárolók konfigurálása

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:

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.

ApplicationInsights-beállítás

A ApplicationInsights beállítás lehetővé teszi Azure-alkalmazás Insights telemetriai támogatás hozzáadását a tárolóhoz. Az Application Insights részletes monitorozást biztosít a tárolóról. 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á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.

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.

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.

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:

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:

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:

A ASP.NET Core naplózási támogatásának konfigurálásáról további információt a Beállítások fájlkonfiguráció című témakörben 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.

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élyeznie kell a Docker-szolgáltatás engedélyét.
• 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:

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}

ApplicationInsights-példa

Az alábbi példa az ApplicationInsights argumentumot úgy állítja be, hogy telemetriát küldjön az Application Insightsnak, miközben a tároló fut:

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

Következő 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