LUIS-erőforrások létrehozása és kezelése

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.

Ebből a cikkből megtudhatja, hogy milyen típusú Azure-erőforrások használhatók a LUIS-jal, és hogyan kezelheti őket.

Erőforrás készítése

A szerzői erőforrások lehetővé teszik az alkalmazások létrehozását, kezelését, betanítását, tesztelését és közzétételét. Egy tarifacsomag érhető el a LUIS szerzői erőforráshoz – az ingyenes (F0) szinthez, amely a következőt nyújtja:

• 1 millió szerzői tranzakció
• Havonta 1000 tesztelési előrejelzési végpontkérés.

A 3.0-s verziójú LUIS programozott API-kkal kezelheti a szerzői erőforrásokat.

Előrejelzési erőforrás

Az előrejelzési erőforrás lehetővé teszi az előrejelzési végpont lekérdezését a szerzői erőforrás által megadott 1000 kérésen túl. Az előrejelzési erőforráshoz két tarifacsomag érhető el:

• Az ingyenes (F0) előrejelzési erőforrás, amely havonta 10 000 előrejelzési végpontkérést biztosít.
• Standard (S0) előrejelzési erőforrás, amely a fizetős szint.

Az előrejelzési erőforrások kezeléséhez használhatja a 3.0-s verziójú LUIS Endpoint API-t .

Feljegyzés

• Többszolgáltatásos erőforrással is beszerezhet egyetlen végpontot, amelyet több Azure AI-szolgáltatáshoz is használhat.
• A LUIS kétféle F0 típusú (ingyenes szintű) erőforrást biztosít: egyet tranzakciók készítéséhez, egyet pedig előrejelzési tranzakciókhoz. Ha elfogy az ingyenes kvóta az előrejelzési tranzakciókhoz, győződjön meg arról, hogy az F0 előrejelzési erőforrást használja, amely havonta 10 000 ingyenes tranzakciót biztosít, és nem a szerzői erőforrást, amely havonta 1000 előrejelzési tranzakciót biztosít.
• Luis-alkalmazásokat kell létrehoznia azokban a régiókban , ahol közzé szeretné tenni és lekérdezni.

LUIS-erőforrások létrehozása

LUIS-erőforrások létrehozásához használhatja a LUIS-portált, az Azure Portalt vagy az Azure CLI-t. Miután létrehozta az erőforrásokat, hozzá kell rendelnie őket az általuk használni kívánt alkalmazásokhoz.

LUIS-portál

LUIS-szerzői erőforrás létrehozása a LUIS-portál használatával

1. Jelentkezzen be a LUIS portálra, válassza ki országát/régióját, és fogadja el a használati feltételeket. Ha megjelenik a portál Saját alkalmazások szakasza, már létezik LUIS-erőforrás, és kihagyhatja a következő lépést.

2. A Megjelenő szerzői lehetőség kiválasztása ablakban keresse meg az Azure-előfizetést és a LUIS szerzői erőforrást. Ha nincs erőforrása, létrehozhat egy újat.

   

   Új szerzői erőforrás létrehozásakor adja meg a következő információkat:

   • Bérlő neve: az a bérlő, amelyhez az Azure-előfizetés társítva van.
   • Azure-előfizetés neve: az erőforrásért számlázott előfizetés.
   • Azure-erőforráscsoport neve: a kiválasztott vagy létrehozott egyéni erőforráscsoport neve. Az erőforráscsoportok lehetővé teszik az Azure-erőforrások hozzáférésre és felügyeletre való csoportosítását.
   • Azure-erőforrás neve: a szerzői és előrejelzési végpont lekérdezéseinek URL-címe részeként választott egyéni név.
   • Tarifacsomag: a tarifacsomag határozza meg a másodpercenkénti és havi maximális tranzakciót.

LUIS-előrejelzési erőforrás létrehozása a LUIS-portál használatával

1. Lépjen az alkalmazás Kezelés lapjára.

2. A bal oldali navigációs sávon válassza az Azure-erőforrások lehetőséget.

3. válassza az Előrejelzési erőforrás hozzáadása gombot.

   

   Ha már rendelkezik előrejelzési erőforrással, adja hozzá. Ellenkező esetben válassza az Új előrejelzési erőforrás létrehozása lehetőséget.

   

LUIS-portál nélkül

LUIS-erőforrások létrehozása a LUIS-portál használata nélkül

Az Azure CLI használatával egyenként hozhat létre minden erőforrást.

Tipp.

• A szerzői erőforrás kind a következő: LUIS.Authoring
• Az előrejelzési erőforrás kindLUIS

1. Jelentkezzen be az Azure CLI-be:

   az login
   

   Ez a parancs megnyitja a böngészőt, így kiválaszthatja a megfelelő fiókot, és megadhatja a hitelesítést.

2. Hozzon létre egy LUIS-tartalomkészítő erőforrást LUIS.Authoring, névvel elnevezve my-luis-authoring-resource. Hozza létre a régióhoz tartozó my-resource-group meglévő erőforráscsoportbanwestus.

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. Hozzon létre egy LUIS-előrejelzési végpont típusú LUISerőforrást , névvel elnevezve my-luis-prediction-resource. Hozza létre a régióhoz tartozó my-resource-group meglévő erőforráscsoportbanwestus. Ha nagyobb átviteli sebességet szeretne, mint amennyit az ingyenes szint biztosít, váltson a F0 következőre S0: . További információ a tarifacsomagokról és az átviteli sebességről.

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

LUIS-erőforrások hozzárendelése

Az erőforrások létrehozása nem feltétlenül jelenti azt, hogy használatba kell venni, azt hozzá kell rendelnie az alkalmazásokhoz. Egyetlen alkalmazáshoz vagy a LUIS összes alkalmazásához hozzárendelhet szerzői erőforrást.

LUIS-portál

Erőforrások hozzárendelése a LUIS-portál használatával

Szerzői erőforrás hozzárendelése az összes alkalmazáshoz

Az alábbi eljárás az összes alkalmazáshoz hozzárendeli a szerzői erőforrást.

1. Jelentkezzen be a LUIS-portálra.
2. A jobb felső sarokban válassza ki a felhasználói fiókját, majd válassza a Gépház.
3. A Felhasználó Gépház lapon válassza a Szerzői erőforrás hozzáadása lehetőséget, majd válasszon ki egy meglévő szerzői erőforrást. Válassza a Mentés lehetőséget.

Erőforrás hozzárendelése egy adott alkalmazáshoz

Az alábbi eljárás erőforrást rendel egy adott alkalmazáshoz.

1. Jelentkezzen be a LUIS-portálra. Válasszon ki egy alkalmazást a Saját alkalmazások listából.

2. Nyissa meg az Azure-erőforrások kezelését>:

   

3. Az Előrejelzési erőforrás vagy a Szerzői erőforrás lapon válassza az Előrejelzési erőforrás hozzáadása vagy a Szerzői erőforrás hozzáadása gombot.

4. Az űrlap mezőivel keresse meg a megfelelő erőforrást, majd válassza a Mentés lehetőséget.

LUIS-portál nélkül

Előrejelzési erőforrás hozzárendelése a LUIS-portál használata nélkül

Az olyan automatizált folyamatok esetében, mint a CI/CD-folyamatok, automatizálhatja egy LUIS-erőforrás luis-alkalmazáshoz való hozzárendelését az alábbi lépésekkel:

1. Szerezze be az Azure Resource Manager-jogkivonatot , amely egy karaktersorozat alfanumerikus sztringje. Ez a jogkivonat lejár, ezért használja azonnal. Az alábbi Azure CLI-parancsot is használhatja.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Használja a jogkivonatot a LUIS-futtatókörnyezeti erőforrások előfizetések közötti lekéréséhez. Az API-val lekérheti azt a LUIS Azure-fiókot , amelyhez a felhasználói fiókja rendelkezik hozzáféréssel.

   A POST API-nak a következő értékekre van szüksége:

   Fejléc	Érték
   Authorization	Az érték az AuthorizationBearer {token}. A jogkivonat értékét a szónak Bearer és a szóköznek kell megelőznie.
   Ocp-Apim-Subscription-Key	A szerzői kulcs.

   Az API JSON-objektumok tömböt ad vissza, amelyek a LUIS-előfizetéseket jelölik. A visszaadott értékek közé tartozik az előfizetés azonosítója, az erőforráscsoport és az erőforrás neve.AccountName Keresse meg azt az elemet a tömbben, amely a LUIS-alkalmazáshoz hozzárendelni kívánt LUIS-erőforrás.

3. Rendelje hozzá a jogkivonatot a LUIS-erőforráshoz a LUIS Azure-fiókok alkalmazás API-hoz való hozzárendelésével.

   A POST API-nak a következő értékekre van szüksége:

   Típus	Beállítás	Érték
   Fejléc	Authorization	Az érték az AuthorizationBearer {token}. A jogkivonat értékét a szónak Bearer és a szóköznek kell megelőznie.
   Fejléc	Ocp-Apim-Subscription-Key	A szerzői kulcs.
   Fejléc	Content-type	application/json
   Querystring	appid	A LUIS-app azonosítója.
   Törzs		{AzureSubscriptionId: Az előfizetés azonosítója, ResourceGroup: Az előrejelzési erőforrást tartalmazó erőforráscsoport neve, AccountName: Az előrejelzési erőforrás neve}

   Ha ez az API sikeres, az eredmény 201 - created status.

Erőforrás hozzárendelésének megszüntetése

Ha megszüntet egy erőforrás hozzárendelését, az nem törlődik az Azure-ból. Csak a LUIS-tól van leválasztva.

LUIS-portál

Erőforrások hozzárendelésének megszüntetése a LUIS-portál használatával

1. Jelentkezzen be a LUIS-portálra, majd válasszon ki egy alkalmazást a Saját alkalmazások listából.
2. Nyissa meg az Azure-erőforrások kezelését>.
3. Válassza az erőforrás hozzárendelésének megszüntetése gombot.

LUIS-portál nélkül

Előrejelzési erőforrás hozzárendelésének megszüntetése a LUIS-portál használata nélkül

1. Szerezze be az Azure Resource Manager-jogkivonatot , amely egy karaktersorozat alfanumerikus sztringje. Ez a jogkivonat lejár, ezért használja azonnal. Az alábbi Azure CLI-parancsot is használhatja.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Használja a jogkivonatot a LUIS-futtatókörnyezeti erőforrások előfizetések közötti lekéréséhez. Használja a LUIS Azure-fiókok lekérése API-t, amelyhez a felhasználói fiókja rendelkezik hozzáféréssel.

   A POST API-nak a következő értékekre van szüksége:

   Fejléc	Érték
   Authorization	Az érték az AuthorizationBearer {token}. A jogkivonat értékét a szónak Bearer és a szóköznek kell megelőznie.
   Ocp-Apim-Subscription-Key	A szerzői kulcs.

   Az API JSON-objektumok tömböt ad vissza, amelyek a LUIS-előfizetéseket jelölik. A visszaadott értékek közé tartozik az előfizetés azonosítója, az erőforráscsoport és az erőforrás neve.AccountName Keresse meg azt az elemet a tömbben, amely a LUIS-alkalmazáshoz hozzárendelni kívánt LUIS-erőforrás.

3. Rendelje hozzá a jogkivonatot a LUIS-erőforráshoz az alkalmazás API-ból származó LUIS Azure-fiók hozzárendelésének megszüntetése használatával.

   A DELETE API-nak a következő értékekre van szüksége:

   Típus	Beállítás	Érték
   Fejléc	Authorization	Az érték az AuthorizationBearer {token}. A jogkivonat értékét a szónak Bearer és a szóköznek kell megelőznie.
   Fejléc	Ocp-Apim-Subscription-Key	A szerzői kulcs.
   Fejléc	Content-type	application/json
   Querystring	appid	A LUIS-app azonosítója.
   Törzs		{AzureSubscriptionId: Az előfizetés azonosítója, ResourceGroup: Az előrejelzési erőforrást tartalmazó erőforráscsoport neve, AccountName: Az előrejelzési erőforrás neve}

   Ha ez az API sikeres, az eredmény 200 - OK status.

Erőforrás tulajdonjoga

Az Azure-erőforrások, például a LUIS-erőforrások az erőforrást tartalmazó előfizetés tulajdonában találhatók.

Egy erőforrás tulajdonjogának módosításához hajtsa végre az alábbi műveletek egyikét:

• Az előfizetés tulajdonjogának átadása.
• Exportálja a LUIS-alkalmazást fájlként, majd importálja az alkalmazást egy másik előfizetésbe. Az exportálás a LUIS-portál Saját alkalmazások lapján érhető el.

Erőforráskorlátok

Kulcslétrehozási korlátok létrehozása

Előfizetésenként régiónként legfeljebb 10 szerzői kulcsot hozhat létre. A közzétételi régiók eltérnek a szerzői régióktól. Győződjön meg arról, hogy a szerzői régióban olyan alkalmazást hoz létre, amely megfelel annak a közzétételi régiónak, ahol az ügyfélalkalmazást el szeretné helyezni. További információ arról, hogy a szerzői régiók hogyan képeznek le közzétételi régiókat: Szerzői és közzétételi régiók.

További információkért lásd: erőforrás-korlátozások.

A kulcshasználat korlátaival kapcsolatos hibák

A használati korlátok a tarifacsomagon alapulnak.

Ha túllépett a másodpercenkénti tranzakciók (TPS) kvótáján, HTTP 429-es hibaüzenetet kap. Ha túllépi a havi tranzakciónkénti (TPM-) kvótát, HTTP 403-ra vonatkozó hibaüzenet jelenik meg.

A tarifacsomag módosítása

1. Az Azure Portalon nyissa meg az Összes erőforrást , és válassza ki az erőforrást

   

2. A bal oldali menüben válassza a Tarifacsomag lehetőséget az elérhető tarifacsomagok megtekintéséhez

3. Válassza ki a kívánt tarifacsomagot, és a Módosítás mentéséhez kattintson a Kiválasztás gombra. Ha a díjszabás módosítása befejeződött, egy értesítés jelenik meg a jobb felső sarokban a tarifacsomag frissítésével.

Azure-erőforrásmetrikák megtekintése

Az Azure-erőforrások használatának összegzésének megtekintése

A LUIS használati adatait az Azure Portalon tekintheti meg. Az Áttekintés lapon egy összegzés látható, amely tartalmazza a legutóbbi hívásokat és hibákat. Ha LUIS-végpontkérelmet küld, legfeljebb öt percet hagyjon a módosítás megjelenésére.

Azure-erőforrás-használati diagramok testreszabása

A Metrikák lap részletesebb képet nyújt az adatokról. A metrikák diagramjait konfigurálhatja egy adott időszakra és metrikára.

Összes tranzakció küszöbértékére vonatkozó riasztás

Ha tudni szeretné, hogy mikor éri el egy bizonyos tranzakció küszöbértékét, például 10 000 tranzakciót, riasztást hozhat létre:

1. A bal oldali menüben válassza a Riasztások lehetőséget

2. A felső menüben válassza az Új riasztási szabály lehetőséget

   

3. Válassza a Feltétel hozzáadása lehetőséget

   

4. Az Összes hívás kiválasztása

   

5. Görgessen le a Riasztás logikai szakaszhoz, és állítsa be az attribútumokat a kívánt módon, majd kattintson a Kész gombra

   

6. Értesítések küldése vagy műveletek meghívása, amikor a riasztási szabály eseményindítói a Műveletek szakaszra kerülnek, és hozzáadják a műveletcsoportot.

   

Szerzői kulcs alaphelyzetbe állítása

Migrált szerzői erőforrás-alkalmazások esetén: Ha a szerzői kulcs sérült, állítsa alaphelyzetbe a kulcsot az Azure Portalon, a szerzői erőforrás Kulcsok lapján.

Nem migrált alkalmazások esetén: A kulcs alaphelyzetbe állítása az összes alkalmazásban a LUIS-portálon. Ha az alkalmazásokat a szerzői API-kon keresztül szerkeszti, az új kulcs értékét Ocp-Apim-Subscription-Key módosítania kell.

Azure-kulcs újragenerálása

Az Azure-kulcsokat az Azure Portal Kulcsok lapján hozhatja létre újra.

Alkalmazás tulajdonjoga, hozzáférése és biztonsága

Az alkalmazásokat az Azure-erőforrásai határozzák meg, amelyeket a tulajdonos előfizetése határoz meg.

Áthelyezheti a LUIS-alkalmazást. Ehhez használja az alábbi erőforrásokat az Azure Portal vagy az Azure CLI használatával:

• Erőforrás áthelyezése új erőforráscsoportba vagy előfizetésbe
• Erőforrás áthelyezése ugyanabban az előfizetésben vagy előfizetések között

Következő lépések

• Megtudhatja , hogyan vezérelheti a verziókat az alkalmazás életciklusának szabályozásához.