Docker-tárolók telepítése és futtatása LUIS-hoz

  • Cikk

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.

Feljegyzés

A tároló lemezképének helye nemrég megváltozott. Ez a cikk a tároló frissített helyének megtekintéséhez olvassa el.

A tárolók lehetővé teszik a LUIS használatát a saját környezetében. A tárolók kiválóan alkalmasak adott biztonsági és adatszabályozási követelményekhez. Ebben a cikkben megtudhatja, hogyan tölthet le, telepíthet és futtathat LUIS-tárolót.

A Language Understanding (LUIS) tároló betölti a betanított vagy közzétett Language Understanding-modellt. LUIS-alkalmazásként a Docker-tároló hozzáférést biztosít a tároló API-végpontjaiból származó lekérdezési előrejelzésekhez. A lekérdezési naplókat összegyűjtheti a tárolóból, és feltöltheti őket a Language Understanding alkalmazásba az alkalmazás előrejelzési pontosságának javítása érdekében.

Az alábbi videó a tároló használatát mutatja be.

Container demonstration for Azure AI services

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

Előfeltételek

A LUIS-tároló futtatásához vegye figyelembe az alábbi előfeltételeket:

  • A Docker telepítve van egy gazdagépen. A Dockert úgy kell konfigurálni, hogy a tárolók kapcsolódhassanak és számlázási adatokat küldjenek az Azure-ba.
    • Windows rendszeren a Dockert úgy is konfigurálnia kell, hogy támogassa a Linux-tárolókat.
    • Ismernie kell a Docker alapfogalmait.
  • Luis-erőforrás ingyenes (F0) vagy standard (S) tarifacsomaggal.
  • Betanított vagy közzétett alkalmazás, amely csatlakoztatott bemenetként van csomagolva a tárolóhoz a hozzá tartozó alkalmazásazonosítóval. A csomagolt fájlt a LUIS-portálról vagy a Szerzői API-kból szerezheti be. Ha luis csomagolt alkalmazást kap a szerzői API-któl, szüksége lesz a szerzői kulcsra is.

A szükséges paraméterek összegyűjtése

Három elsődleges paraméter szükséges az összes Azure AI-tárolóhoz. A Microsoft szoftverlicenc-feltételeinek elfogadási értékkel kell rendelkeznie. Végponti URI- és API-kulcsra is szükség van.

Végpont URI-ja

Az {ENDPOINT_URI} érték a megfelelő Azure AI-szolgáltatási erőforrás Azure Portal áttekintési oldalán érhető el. Lépjen az Áttekintés lapra, mutasson a végpont fölé, és megjelenik egy Másolás vágólapra ikon. Szükség esetén másolja és használja a végpontot.

Screenshot that shows gathering the endpoint URI for later use.

Kulcsok

Az {API_KEY} érték a tároló elindítására szolgál, és elérhető a megfelelő Azure AI-szolgáltatási erőforrás Kulcsok lapján. Lépjen a Kulcsok lapra, és válassza a Vágólapra másolás ikont.

Screenshot that shows getting one of the two keys for later use.

Fontos

Ezek az előfizetési kulcsok az Azure AI-szolgáltatások API-ját használják. Ne ossza meg a kulcsait. Biztonságosan tárolja őket. Használja például az Azure Key Vaultot. Azt is javasoljuk, hogy ezeket a kulcsokat rendszeresen újragenerálja. API-hívás létrehozásához csak egy kulcs szükséges. Az első kulcs újragenerálása után a második kulcsot használhatja a szolgáltatáshoz való folyamatos hozzáféréshez.

Alkalmazásazonosító {APP_ID}

Ez az azonosító az alkalmazás kiválasztására szolgál. Az alkalmazásazonosítót a LUIS-portálon a képernyő tetején található Kezelés gombra kattintva találja meg, majd Gépház.

The screen for finding your app ID.

Szerzői kulcs {AUTHORING_KEY}

Ezzel a kulccsal lekérheti a csomagolt alkalmazást a felhőbeli LUIS szolgáltatásból, és feltöltheti a lekérdezési naplókat a felhőbe. A cikk későbbi részében ismertetett REST API használatával történő exportáláshoz szüksége lesz a szerzői kulcsra.

A szerzői kulcsot a LUIS-portálról szerezheti be az alkalmazás képernyőjének tetején található Kezelés, majd az Azure Resources elemre kattintva.

The screen for finding your authoring resource key.

API-k létrehozása csomagfájlhoz

API-k létrehozása csomagolt alkalmazásokhoz:

A gazdaszámítógép

A gazdagép egy x64-alapú számítógép, amely a Docker-tárolót futtatja. Ez lehet egy számítógép a helyszínen vagy egy Docker-üzemeltetési szolgáltatás az Azure-ban, például:

Tárolókövetelmények és javaslatok

Az alábbi táblázat a tárológazda minimális és ajánlott értékeit sorolja fel. A követelmények a forgalom mennyiségétől függően változhatnak.

Tároló Minimum Ajánlott TPS
(Minimum, Maximum)
LUIS 1 magos, 2 GB-os memória 1 magos, 4 GB-os memória 20, 40
  • Minden magnak legalább 2,6 gigahertzesnek (GHz) vagy gyorsabbnak kell lennie.
  • TPS – másodpercenkénti tranzakciók

A mag és a memória megfelel a --cpus parancs részeként használt beállításoknak és --memory beállításoknak docker run .

A tároló lemezképének lekérése docker pull

A LUIS-tároló lemezképe a mcr.microsoft.com tárolóregisztrációs adatbázis szindikátumán található. Az adattárban azure-cognitive-services/language található, és neve luis. A teljes tárolórendszerkép neve: mcr.microsoft.com/azure-cognitive-services/language/luis.

A tároló legújabb verziójának használatához használhatja a címkét latest . Az MCR-en a címkék teljes listája is megtalálható.

docker pull A parancs használatával töltse le a tárolólemezképet az mcr.microsoft.com/azure-cognitive-services/language/luis adattárból:

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

Az elérhető címkék, például latest az előző parancsban használt teljes leírásáért tekintse meg a Docker Hubon található LUIS-t .

Tipp.

A docker images paranccsal listázhatja a letöltött tárolólemezképeket. Az alábbi parancs például az egyes letöltött tárolólemezképek azonosítóját, adattárát és címkéjét sorolja fel táblázatként formázva:

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

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

A tároló használata

Ha a tároló a gazdaszámítógépen van, az alábbi eljárással dolgozhat a tárolóval.

Process for using Language Understanding (LUIS) container

  1. Tároló csomagjának exportálása LUIS-portálról vagy LUIS API-ból.
  2. Helyezze át a csomagfájlt a gazdaszámítógép szükséges bemeneti könyvtárába. Ne nevezze át, ne módosítsa, ne írja felül és ne bontsa le a LUIS-csomagfájlt.
  3. Futtassa a tárolót a szükséges bemeneti csatlakoztatási és számlázási beállításokkal. További példák a docker run parancsra.
  4. A tároló előrejelzési végpontjának lekérdezése.
  5. Ha végzett a tárolóval, importálja a végpontnaplókat a LUIS-portál kimeneti csatlakoztatásából, és állítsa le a tárolót.
  6. Az alkalmazás továbbfejlesztéséhez használja a LUIS Portal aktív tanulását a Végponti kimondott szövegek áttekintése lapon.

A tárolóban futó alkalmazás nem módosítható. Az alkalmazás tárolóban való módosításához módosítania kell az alkalmazást a LUIS szolgáltatásban a LUIS-portál használatával, vagy a LUIS szerzői API-jait kell használnia. Ezután betanítsa és/vagy közzétegye, majd töltsön le egy új csomagot, és futtassa újra a tárolót.

A tárolón belüli LUIS-alkalmazás nem exportálható vissza a LUIS szolgáltatásba. Csak a lekérdezési naplók tölthetők fel.

Csomagolt alkalmazás exportálása a LUIS-ból

A LUIS-tárolóhoz betanított vagy közzétett LUIS-alkalmazás szükséges a felhasználói kimondott szövegek előrejelzési lekérdezéseinek megválaszolásához. A LUIS-alkalmazás beszerzéséhez használja a betanított vagy közzétett csomag API-t.

Az alapértelmezett hely az input alkönyvtár a parancs futtatásának docker run helyéhez viszonyítva.

Helyezze a csomagfájlt egy könyvtárba, és hivatkozzon erre a könyvtárra bemeneti csatlakoztatásként a Docker-tároló futtatásakor.

Csomagtípusok

A bemeneti csatlakoztatási könyvtár egyszerre tartalmazhatja az alkalmazás éles, átmeneti és verziószámozott modelljeit. Az összes csomag csatlakoztatva van.

Csomag típusa Query Endpoint API Lekérdezések rendelkezésre állása Csomagfájlnév formátuma
Verziószámozott GET, POST Csak tároló {APP_ID}_v{APP_VERSION}.gz
Előkészítés GET, POST Azure és tároló {APP_ID}_STAGING.gz
Termelés GET, POST Azure és tároló {APP_ID}_PRODUCTION.gz

Fontos

Ne nevezze át, ne módosítsa, ne írja felül és ne bontsa ki a LUIS-csomagfájlokat.

Csomagolási előfeltételek

A LUIS-alkalmazások csomagolása előtt a következőknek kell rendelkeznie:

Csomagolási követelmények Részletek
Azure Azure AI-szolgáltatások erőforráspéldánya Támogatott régiók:

USA nyugati régiója (westus)
Nyugat-Európa (westeurope)
Kelet-Ausztrália (australiaeast)
Betanított vagy közzétett LUIS-alkalmazás Nem támogatott függőségek nélkül.
Hozzáférés a gazdaszámítógép fájlrendszeréhez A gazdaszámítógépnek engedélyeznie kell a bemeneti csatlakoztatást.

Alkalmazáscsomag exportálása a LUIS-portálról

A LUIS-portál lehetővé teszi a betanított vagy közzétett alkalmazáscsomag exportálását.

Közzétett alkalmazás csomagjának exportálása a LUIS-portálról

A közzétett alkalmazás csomagja a Saját alkalmazások listaoldalról érhető el.

  1. Jelentkezzen be a LUIS-portálra.
  2. Jelölje be az alkalmazásnév bal oldalán található jelölőnégyzetet a listában.
  3. Válassza ki az Exportálás elemet a lista feletti környezetfüggő eszköztárból.
  4. Válassza az Exportálás tárolóhoz (GZIP) lehetőséget.
  5. Válassza ki az éles vagy az előkészítési pontkörnyezetét.
  6. A csomag letöltődik a böngészőből.

Export the published package for the container from the App page's Export menu

Verziószámozott alkalmazás csomagjának exportálása a LUIS-portálról

A verziószámozott alkalmazás csomagja a Verziók listaoldalon érhető el.

  1. Jelentkezzen be a LUIS-portálra.
  2. Válassza ki az alkalmazást a listában.
  3. Válassza a Kezelés lehetőséget az alkalmazás navigációs sávján.
  4. Válassza a Verziók lehetőséget a bal oldali navigációs sávon.
  5. Jelölje be a lista verziónevének bal oldalán található jelölőnégyzetet.
  6. Válassza ki az Exportálás elemet a lista feletti környezetfüggő eszköztárból.
  7. Válassza az Exportálás tárolóhoz (GZIP) lehetőséget.
  8. A csomag letöltődik a böngészőből.

Export the trained package for the container from the Versions page's Export menu

Közzétett alkalmazás csomagjának exportálása API-ból

A következő REST API-metódussal csomagoljon be egy már közzétett LUIS-alkalmazást. Az API-hívás helyőrzőinek saját megfelelő értékeinek helyettesítése a HTTP-specifikáció alatti táblázat használatával.

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}
Helyőrző Érték
{APP_ID} A közzétett LUIS-alkalmazás alkalmazásazonosítója.
{SLOT_NAME} A közzétett LUIS-alkalmazás környezete. Használja az alábbi értékek egyikét:
PRODUCTION
STAGING
{AUTHORING_KEY} A közzétett LUIS-alkalmazás LUIS-fiókjának szerzői kulcsa.
A szerzői kulcsot a LUIS-portál Felhasználói Gépház lapján szerezheti be.
{AZURE_REGION} A megfelelő Azure-régió:

westus - USA nyugati régiója
westeurope - Nyugat-Európa
australiaeast - Kelet-Ausztrália

A közzétett csomag letöltéséhez tekintse meg az API dokumentációját. Ha sikeresen letöltötte, a válasz egy LUIS-csomagfájl. Mentse a fájlt a tároló bemeneti csatlakoztatásához megadott tárolási helyre.

Verziószámozott alkalmazás csomagjának exportálása API-ból

A következő REST API-metódussal csomagoljon be egy már betanított LUIS-alkalmazást. Az API-hívás helyőrzőinek saját megfelelő értékeinek helyettesítése a HTTP-specifikáció alatti táblázat használatával.

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}
Helyőrző Érték
{APP_ID} A betanított LUIS-alkalmazás alkalmazásazonosítója.
{APP_VERSION} A betanított LUIS-alkalmazás alkalmazásverziója.
{AUTHORING_KEY} A közzétett LUIS-alkalmazás LUIS-fiókjának szerzői kulcsa.
A szerzői kulcsot a LUIS-portál Felhasználói Gépház lapján szerezheti be.
{AZURE_REGION} A megfelelő Azure-régió:

westus - USA nyugati régiója
westeurope - Nyugat-Európa
australiaeast - Kelet-Ausztrália

A verziószámozott csomag letöltéséhez tekintse meg itt az API dokumentációját. Ha sikeresen letöltötte, a válasz egy LUIS-csomagfájl. Mentse a fájlt a tároló bemeneti csatlakoztatásához megadott tárolási helyre.

A tároló futtatása a következővel: docker run

A tároló futtatásához használja a docker-futtatási parancsot. Az adatok és {API_KEY} értékek lekérésének részleteiért tekintse meg a {ENDPOINT_URI} szükséges paramétereket.

Példák a docker run parancsra.

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}
  • Ez a példa a meghajtón kívüli könyvtárat használja az C: engedélyütközések elkerülése érdekében a Windows rendszeren. 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 parancs a következőket hajtja végre:

  • Tároló futtatása a LUIS-tároló lemezképéből
  • A LUIS-alkalmazás betöltése a bemeneti csatlakoztatásból a tároló gazdagépen található C:\input helyen
  • Két processzormag és 4 gigabájt (GB) memória lefoglalása
  • Az 5000-s TCP-portot teszi elérhetővé, és pszeudo-TTY-t foglal le a tárolóhoz
  • Tároló- és LUIS-naplók mentése a tároló gazdagépen található C:\output kimeneti csatlakoztatásához
  • A tárolót a kilépés után automatikusan eltávolítja. A tárolólemezkép továbbra is elérhető a gazdaszámítógépen.

További példák a docker run parancsra.

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 Azure-erőforrások lapján található kulcs, és az Azure-erőforráskulcsok Azure AI services oldalán is elérhető.

Több tároló futtatása ugyanazon a gazdagépen

Ha több tárolót szeretne futtatni közzétett portokkal, mindenképpen futtassa az egyes tárolókat egy másik közzétett porttal. Futtassa például az első tárolót az 5000-s porton, a másodikat pedig az 5001-s porton.

Ezt a tárolót és egy másik Azure AI-szolgáltatási tárolót együtt futtathatja a GAZDAGÉPen. Több tároló is futtatható ugyanabból az Azure AI-szolgáltatási tárolóból.

A tároló által támogatott végponti API-k

Az API V2 és V3 verziói is elérhetők a tárolóval.

A tároló előrejelzési végpontjának lekérdezése

A tároló REST-alapú lekérdezés-előrejelzési végpont API-kat nyújt. A közzétett (előkészítési vagy éles) alkalmazások végpontjai más útvonalon futnak, mint a verziószámozott alkalmazások végpontjai.

A tároló API-khoz használja a gazdagépet (http://localhost:5000).

Csomag típusa HTTP-parancs Útvonal Paraméterek lekérdezése
Kiadás dátuma GET, POST /luis/v3.0/apps/{appId}/slots/{slotName}/predict? /luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict? query={query}
[&verbose]
[&log]
[&show-all-intents]
Verziószámozott GET, POST /luis/v3.0/apps/{appId}/versions/{versionId}/predict? /luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict query={query}
[&verbose]
[&log]
[&show-all-intents]

A lekérdezési paraméterek konfigurálják, hogyan és mit ad vissza a lekérdezési válasz:

Lekérdezési paraméter Típus Alkalmazás célja
query húr A felhasználó kimondott szövege.
verbose Logikai Logikai érték, amely azt jelzi, hogy az előrejelzett modellek összes metaadatait vissza kell-e adni. Az alapértelmezett érték a false (hamis).
log Logikai Naplózza a lekérdezéseket, amelyek később aktív tanuláshoz használhatók. Az alapértelmezett érték a false (hamis).
show-all-intents Logikai Logikai érték, amely azt jelzi, hogy az összes szándékot vagy csak a legfelső pontozási szándékot adja vissza. Az alapértelmezett érték a false (hamis).

A LUIS-alkalmazás lekérdezése

Egy közzétett alkalmazás tárolójának lekérdezésére szolgáló CURL-parancs például a következő:

Egy modell pontban való lekérdezéséhez használja a következő API-t:

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"

Ha lekérdezéseket szeretne végezni az átmeneti környezetbe, cserélje le production az útvonalon a következőre staging:

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

Verziószámozott modell lekérdezéséhez használja a következő API-t:

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"

Az aktív tanulás végpontnaplóinak importálása

Ha kimeneti csatlakoztatás van megadva a LUIS-tárolóhoz, az alkalmazás lekérdezési naplófájljai a kimeneti könyvtárba lesznek mentve, ahol {INSTANCE_ID} a tároló azonosítója található. Az alkalmazás lekérdezési naplója tartalmazza a LUIS-tárolóba küldött összes előrejelzési lekérdezés lekérdezését, válaszát és időbélyegét.

Az alábbi helyen a tároló naplófájljainak beágyazott könyvtárszerkezete látható.

/output/luis/{INSTANCE_ID}/

A LUIS-portálon válassza ki az alkalmazást, majd válassza a Végpontnaplók importálása lehetőséget a naplók feltöltéséhez.

Import container's log files for active learning

A napló feltöltése után tekintse át a végpont kimondott szövegeit a LUIS-portálon.

Ellenőrizze, hogy fut-e egy tároló

A tároló futásának ellenőrzésére többféleképpen is van lehetőség. Keresse meg a szóban forgó tároló külső IP-címét és közzétett portját, és nyissa meg a kedvenc webböngészőt. A tároló futásának ellenőrzéséhez használja az alábbi kérési URL-címeket. Az itt felsorolt példakérési URL-címek eltérőek http://localhost:5000lehetnek, de az adott tároló eltérő lehet. Ügyeljen arra, hogy a tároló külső IP-címére és közzétett portjára támaszkodjon.

Kérelem URL-címe Cél
http://localhost:5000/ A tároló egy kezdőlappal rendelkezik.
http://localhost:5000/ready A GET használatával kért URL-cím ellenőrzi, hogy a tároló készen áll-e egy lekérdezés elfogadására a modellen. Ez a kérés használható a Kubernetes-beli élő- és készültségi mintavételekhez.
http://localhost:5000/status A GET szolgáltatással is kért, ez az URL-cím ellenőrzi, hogy a tároló elindításához használt API-kulcs érvényes-e végpontlekérdezés nélkül. Ez a kérés használható a Kubernetes-beli élő- és készültségi mintavételekhez.
http://localhost:5000/swagger A tároló átfogó dokumentációval is rendelkezik a végpontokhoz, valamint egy kipróbálás funkcióval is. Ezzel a funkcióval beírhatja a beállításokat egy webes HTML-űrlapba, és kódírás nélkül is elvégezheti a lekérdezést. A lekérdezés visszatérése után megjelenik egy példa CURL-parancs, amely bemutatja a szükséges HTTP-fejléceket és törzsformátumot.

Container's home page

Az internetről leválasztott tároló futtatása

Az internetről leválasztott tároló használatához először hozzáférést kell kérnie egy alkalmazás kitöltésével és egy kötelezettségvállalási terv megvásárlásával. További információ: Docker-tárolók használata leválasztott környezetekben .

Ha engedélyezte, hogy az internetről leválasztott tárolót futtassa, az alábbi példában a használni kívánt parancs formázása docker run látható helyőrző értékekkel. Cserélje le ezeket a helyőrző értékeket a saját értékeire.

A DownloadLicense=True parancs paramétere docker run letölt egy licencfájlt, amely lehetővé teszi a Docker-tároló futtatását, ha nincs internetkapcsolata. Emellett egy lejárati dátumot is tartalmaz, amely után a licencfájl érvénytelen lesz a tároló futtatásához. Csak a megfelelő tárolóval rendelkező licencfájlt használhatja. Például nem használhat licencfájlt egy beszéd-szöveg tárolóhoz dokumentumintelligencia-tárolóval.

Helyőrző Érték Formátum vagy példa
{IMAGE} A használni kívánt tárolórendszerkép. mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice
{LICENSE_MOUNT} A licenc letöltési és csatlakoztatási útvonala. /host/license:/path/to/license/directory
{ENDPOINT_URI} A szolgáltatáskérés hitelesítésének végpontja. Az erőforrás kulcs- és végpontoldalán , az Azure Portalon található. https://<your-custom-subdomain>.cognitiveservices.azure.com
{API_KEY} A Text Analytics-erőforrás kulcsa. Az erőforrás kulcs- és végpontoldalán , az Azure Portalon található. xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
{CONTAINER_LICENSE_DIRECTORY} A licencmappa helye a tároló helyi fájlrendszerében. /path/to/license/directory 
docker run --rm -it -p 5000:5000 \ 
-v {LICENSE_MOUNT} \
{IMAGE} \
eula=accept \
billing={ENDPOINT_URI} \
apikey={API_KEY} \
DownloadLicense=True \
Mounts:License={CONTAINER_LICENSE_DIRECTORY}

A licencfájl letöltése után a tárolót leválasztott környezetben futtathatja. Az alábbi példa a használni kívánt parancs formázását docker run mutatja be helyőrző értékekkel. Cserélje le ezeket a helyőrző értékeket a saját értékeire.

Bárhol is fut a tároló, a licencfájlt csatlakoztatni kell a tárolóhoz, és meg kell adni Mounts:License=a tároló helyi fájlrendszerében lévő licencmappa helyét. Kimeneti csatlakoztatást is meg kell adni, hogy meg lehessen írni a számlázási használati rekordokat.

Helyőrző Érték Formátum vagy példa
{IMAGE} A használni kívánt tárolórendszerkép. mcr.microsoft.com/azure-cognitive-services/form-recognizer/invoice
{MEMORY_SIZE} A tárolóhoz lefoglalandó memória mérete. 4g
{NUMBER_CPUS} A tárolóhoz lefoglalandó cpu-k megfelelő száma. 4
{LICENSE_MOUNT} Az elérési út, ahol a licenc található és csatlakoztatva lesz. /host/license:/path/to/license/directory
{OUTPUT_PATH} A használati rekordok naplózásának kimeneti elérési útja. /host/output:/path/to/output/directory
{CONTAINER_LICENSE_DIRECTORY} A licencmappa helye a tároló helyi fájlrendszerében. /path/to/license/directory
{CONTAINER_OUTPUT_DIRECTORY} A kimeneti mappa helye a tároló helyi fájlrendszerén. /path/to/output/directory 
docker run --rm -it -p 5000:5000 --memory {MEMORY_SIZE} --cpus {NUMBER_CPUS} \ 
-v {LICENSE_MOUNT} \ 
-v {OUTPUT_PATH} \
{IMAGE} \
eula=accept \
Mounts:License={CONTAINER_LICENSE_DIRECTORY}
Mounts:Output={CONTAINER_OUTPUT_DIRECTORY}

A tároló leállítása

A tároló leállításához a tárolót futtató parancssori környezetben nyomja le a Ctrl+C billentyűkombinációt.

Hibaelhárítás

Ha a tárolót kimeneti csatlakoztatással és naplózással futtatja, a tároló olyan naplófájlokat hoz létre, amelyek segítenek elhárítani a tároló indításakor vagy futtatásakor felmerülő problémákat.

Tipp.

További hibaelhárítási információkért és útmutatásért tekintse meg az Azure AI-tárolókkal kapcsolatos gyakori kérdéseket (GYIK).

Ha problémákat tapasztal egy Azure AI-szolgáltatástároló futtatásával, próbálja meg használni a Microsoft diagnosztikai tárolóját. Ezzel a tárolóval diagnosztizálhatja az üzembehelyezési környezetben előforduló gyakori hibákat, amelyek megakadályozhatják, hogy az Azure AI-tárolók a várt módon működjenek.

A tároló lekéréséhez használja a következő docker pull parancsot:

docker pull mcr.microsoft.com/azure-cognitive-services/diagnostic

Ezután futtassa a tárolót. Cserélje le {ENDPOINT_URI} a végpontot, és cserélje le {API_KEY} az erőforrás kulcsára:

docker run --rm mcr.microsoft.com/azure-cognitive-services/diagnostic \
eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}

A tároló teszteli a számlázási végponthoz való hálózati kapcsolatot.

Számlázás

A LUIS-tároló számlázási adatokat küld az Azure-nak egy Azure AI-szolgáltatási erőforrás használatával az Azure-fiókjában.

A tárolóba irányuló lekérdezések számlázása a paraméterhez használt Azure-erőforrás tarifacsomagján ApiKey lesz.

Az Azure AI-szolgáltatások tárolói nem rendelkeznek licenceléssel anélkül, hogy a mérési vagy számlázási végponthoz csatlakozna. Engedélyeznie kell a tárolók számára, hogy mindig közöljék a számlázási adatokat a számlázási végponttal. Az Azure AI-szolgáltatások tárolói nem küldenek ügyféladatokat, például az elemezni kívánt képet vagy szöveget a Microsoftnak.

Csatlakozás az Azure szolgáltatáshoz

A tárolónak futtatnia kell a számlázási argumentum értékeit. Ezek az értékek lehetővé teszik, hogy a tároló csatlakozzon a számlázási végponthoz. A tároló körülbelül 10–15 percenként jelenti a használatot. Ha a tároló az engedélyezett időkereten belül nem csatlakozik az Azure-hoz, a tároló továbbra is fut, de nem szolgál ki lekérdezéseket, amíg vissza nem állítja a számlázási végpontot. A kapcsolat 10 alkalommal, 10–15 perces időintervallumban történik. Ha a 10 próbálkozáson belül nem tud csatlakozni a számlázási végponthoz, a tároló leállítja a kérések kiszolgálását. Tekintse meg az Azure AI-szolgáltatások tárolójának gyakori kérdéseit a Microsoftnak a számlázáshoz küldött információk példájáért.

Számlázási argumentumok

A docker run parancs akkor indítja el a tárolót, ha az alábbi lehetőségek közül mind a három érvényes értéket tartalmazza:

Lehetőség Leírás
ApiKey Az Azure AI-szolgáltatások erőforrásának API-kulcsa, amely a számlázási adatok nyomon követésére szolgál.
Ennek a beállításnak az értékét api-kulcsra kell állítani a kiépített erőforráshoz, amely a következőben Billingvan megadva: .
Billing Az Azure AI-szolgáltatások erőforrásának végpontja, amely a számlázási adatok nyomon követésére szolgál.
Ennek a beállításnak az értékét egy kiépített Azure-erőforrás végponti URI-jára kell állítani.
Eula Azt jelzi, hogy elfogadta a tároló licencét.
Ennek a beállításnak az értékét el kell fogadni.

Ezekről a lehetőségekről további információt a Tárolók konfigurálása című témakörben talál.

Összegzés

Ebben a cikkben megismerkedett a Language Understanding (LUIS) tárolók letöltésével, telepítésével és futtatásával kapcsolatos fogalmakkal és munkafolyamatokkal. Összegezve:

  • A Language Understanding (LUIS) egy Linux-tárolót biztosít a Docker számára, amely a kimondott szövegek végpontlekérdezési előrejelzéseit biztosítja.
  • A tárolólemezképek a Microsoft Container Registryből (MCR) töltődnek le.
  • A tárolólemezképek a Dockerben futnak.
  • A REST API-val lekérdezheti a tárolóvégpontokat a tároló gazdagépének URI-jának megadásával.
  • A tárolók példányosításakor meg kell adnia a számlázási adatokat.

Fontos

Az Azure AI-tárolók nem rendelkeznek licenceléssel anélkül, hogy az Azure-hoz csatlakozna mérési célokra. Az ügyfeleknek engedélyeznie kell a tárolóknak, hogy mindig közöljék a számlázási adatokat a mérési szolgáltatással. Az Azure AI-tárolók nem küldenek ügyféladatokat (például az elemzett képet vagy szöveget) a Microsoftnak.

Következő lépések