Rövid útmutató: Alkalmazás létrehozása a LUIS-portálon

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.

Ebben a rövid útmutatóban hozzon létre egy LUIS-alkalmazást az előre összeállított otthoni automatizálási tartomány használatával a lámpák és berendezések be- és kikapcsolásához. Ez az előre összeállított tartomány szándékokat, entitásokat és kimondott szövegek példáit tartalmazza. Ezután próbálja testre szabni az alkalmazást további szándékok és entitások hozzáadásával. Amikor végzett, egy felhőben futó LUIS-végponttal fog rendelkezni.

Bejelentkezés a LUIS portálra

A LUIS-nak új felhasználónak a következő eljárást kell követnie:

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 ehelyett Saját alkalmazások jelenik meg, egy LUIS-erőforrás már létezik, és érdemes továbblépnie egy alkalmazás létrehozásához. Ha nem, először egy Azure-erőforrás használatával kapcsolhatja össze LUIS-fiókját egy új vagy meglévő Azure Authoring-erőforrással.

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 azure-előfizetése van társítva.
   • Azure-előfizetés neve – az erőforrásért kiszámlázott előfizetés.
   • Azure-erőforráscsoport neve – a vá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ásnév – egy ön által választott egyéni név, amelyet a szerzői és előrejelzési végpont lekérdezéseinek URL-címeként használ.
   • Tarifacsomag – a tarifacsomag határozza meg a másodpercenkénti és havi tranzakció maximális értékét.

Előfizetés és szerzői erőforrás kiválasztása

Amikor kiválaszt egy adott előfizetést és szerzői erőforrást, megjelenik a hozzá társított alkalmazások listája.

Új alkalmazás létrehozása

A My Apps (Saját alkalmazások) lapon hozhatja létre és kezelheti az alkalmazásokat.

Alkalmazás létrehozása

Alkalmazás létrehozásához kattintson az + Új alkalmazás gombra.

A megjelenő ablakban adja meg a következő adatokat:

Név	Leírás
Név	Az alkalmazás neve. Például: "otthoni automatizálás".
Kulturális környezet	Az alkalmazás által megértett és beszélt nyelv.
Leírás	Az alkalmazás leírása.
Előrejelzési erőforrás	A lekérdezéseket fogadó előrejelzési erőforrás.

Válassza a Kész lehetőséget.

Feljegyzés

A kulturális környezet az alkalmazás létrehozása után nem módosítható.

Előre összeállított tartomány hozzáadása

A LUIS előre összeállított tartományokat kínál, amelyek segíthetnek az alkalmazás használatának megkezdésében. Egy előre összeállított tartományi alkalmazás már fel van töltve szándékokkal, entitásokkal és kimondott szövegekkel.

1. A bal oldali navigációs sávon válassza az Előre összeállított tartományok lehetőséget.

2. Keresse meg a HomeAutomation szolgáltatást.

3. Válassza a Tartomány hozzáadása lehetőséget a HomeAutomation kártyán.

   

   A tartomány sikeres hozzáadása után az előre összeállított tartomány mezőben megjelenik egy Remove domain (Tartomány eltávolítása) gomb.

Szándékok és entitások ellenőrzése

1. Válassza a Bal oldali navigációs menü Szándékok elemét a HomeAutomation tartomány szándékainak megtekintéséhez. Példa kimondott szövegekkel rendelkezik, például HomeAutomation.QueryState és HomeAutomation.SetDevice.

   Feljegyzés

   A None (Nincs) az összes LUIS-alkalmazásban szereplő szándék. Olyan kimondott szövegek kezelésére szolgál, amelyek nem felelnek meg az alkalmazás által nyújtott funkcióknak.

2. Válassza a HomeAutomation.TurnOff szándékot. A szándék entitásokkal címkézett példaszövegeket tartalmaz.

   

3. Ha meg szeretné tekinteni az alkalmazás entitását, válassza az Entitások lehetőséget. Ha kiválaszt egy entitást( például HomeAutomation.DeviceName ), megjelenik a hozzá társított értékek listája.

   

A LUIS-alkalmazás betanítása

Miután az alkalmazás szándékokkal, entitásokkal és kimondott szövegekkel lett feltöltve, be kell tanítania az alkalmazást, hogy a végrehajtott módosítások megjelenjenek.

1. A LUIS-webhely jobb felső részén válassza a Betanítása gombot.

   

2. A betanítás akkor fejeződik be, ha a Betanítás gomb le van tiltva.

Az alkalmazás tesztelése

Miután betanította az alkalmazását, tesztelheti is.

1. A jobb felső navigációs sávon válassza a Tesztelés lehetőséget.

2. Írjon be egy kimondott szöveget az interaktív tesztpanelre, és nyomja le az Enter billentyűt. Kapcsolja ki például a lámpákat.

   Ebben a példában a rendszer helyesen azonosítja a fények kikapcsolását a HomeAutomation.TurnOff fő pontozási szándékaként.

   

3. Válassza a Vizsgálat lehetőséget az előrejelzés további információinak megtekintéséhez.

   

4. Zárja be a tesztpanelt.

Az alkalmazás testreszabása

Az előre összeállított tartományokon kívül a LUIS lehetővé teszi saját egyéni alkalmazások létrehozását vagy az előre összeállított alkalmazások testreszabását.

Szándékok létrehozása

További szándékok hozzáadása az alkalmazáshoz

1. Válassza a szándékokat a bal oldali navigációs menüben.
2. Válassza a Létrehozás elemet
3. Adja meg a szándék nevét, HomeAutomation.AddDeviceAliasmajd válassza a Kész lehetőséget.

Entitások létrehozása

További entitások hozzáadása az alkalmazáshoz

1. Válassza az Entitások lehetőséget a bal oldali navigációs menüben.
2. Válassza a Létrehozás elemet
3. Adja meg az entitás nevét, HomeAutomation.DeviceAliasválassza ki a típusból tanult gépet, majd válassza a Létrehozás lehetőséget.

Példa kimondott szövegek hozzáadása

A kimondott szövegek például olyan szövegek, amelyeket egy felhasználó egy csevegőrobotban vagy más ügyfélalkalmazásban ír be. A felhasználó szövegének szándékát LUIS-szándékra képezik le.

A Szándékok lapon HomeAutomation.AddDeviceAliasadja hozzá a következő kimondott példaszövegeket a Kimondott példa alatt,

#	Példák kimondott szövegekre
0	Add alias to my fan to be wind machine
2	Alias lights to illumination
3	nickname living room speakers to our speakers a new fan
4	rename living room tv to main tv

A legjobb eredmény érdekében győződjön meg arról, hogy a példaszövegek a következő módokon változnak:

• Kimondott szöveg hossza
• központozás
• Word-választás
• Ige feszült (is, volt, lesz)
• Szórend

Kimondott szövegek címkézése

A kimondott szövegek címkézésére azért van szükség, mert hozzáadott egy ML-entitást. Az alkalmazás címkézést használ a létrehozott ML-entitások kinyeréséhez.

A kimondott szövegek címkézéséhez két lehetősége van: entitáspaletta-címkézés és beágyazott címkézés.

Entitáskatalógus címkézése

Amikor kiválasztja a @ jobb felső ikont, megnyílik az entitáspaletta a lap jobb oldalán.

1. Jelölje ki a címkézni kívánt entitást.

   

2. Jelölje ki az entitással címkézni kívánt szöveget.

   

Beágyazott címkézés

1. Jelölje ki a címkézni kívánt szöveget.

2. Jelölje ki azt az entitást, amellyel fel szeretné címkézni a szöveget az előugró menüből.

   

Előrejelzési erőforrás létrehozása

Ezen a ponton befejezte az alkalmazás szerkesztését. Létre kell hoznia egy előrejelzési erőforrást az alkalmazás közzétételéhez, hogy előrejelzéseket fogadhasson egy csevegőrobotban vagy más ügyfélalkalmazásban az előrejelzési végponton keresztül

Előrejelzési erőforrás létrehozása a LUIS-portálról

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.

   

Az alkalmazás közzététele a végpont URL-címének lekéréshez

Ahhoz, hogy LUIS-előrejelzést kapjon egy csevegőrobotban vagy más ügyfélalkalmazásban, közzé kell tennie az alkalmazást az előrejelzési végponton.

1. A jobb felső navigációs sávon válassza a Közzététel lehetőséget.

   

2. Válassza ki az éles pontot, majd válassza a Kész lehetőséget.

   

3. Válassza a Végpont URL-címeinek elérése lehetőséget az értesítésben az Azure-erőforrások lapra való ugráshoz. Csak akkor láthatja az URL-címeket, ha egy előrejelzési erőforrás van társítva az alkalmazáshoz. Az Azure-erőforrások lap a Kezelés gombra kattintva is megtalálható.

   

A V3 API előrejelzési végpontjának lekérdezése

1. A LUIS-portál Kezelés szakaszában (jobb felső menü), az Azure-erőforrások lap (bal oldali menü) Előrejelzési erőforrások lapján másolja a lap alján található Példa lekérdezést. Az URL-cím az alkalmazás azonosítójával, kulcsával és pontnevével rendelkezik. A V3 előrejelzési végpont URL-címe a következő: https://YOUR-RESOURCE-NAME.api.cognitive.microsoft.com/luis/prediction/v3.0/apps/APP-ID/slots/SLOT-NAME/predict?subscription-key=YOUR-PREDICTION-KEY&<optional-name-value-pairs>&query=YOUR_QUERY_HERE

   

   Illessze be az URL-címet egy új böngészőlapra. Ha nem látja az URL-címet, nem rendelkezik előrejelzési erőforrással, és létre kell hoznia egyet.

2. A böngésző címsorában a lekérdezési sztring esetében győződjön meg arról, hogy az alábbi értékek szerepelnek az URL-címben. Ha nem szerepelnek a lekérdezési sztringben, adja hozzá őket:

   • verbose=true
   • show-all-intents=true

3. A böngésző címsorában lépjen az URL-cím végére, és kapcsolja ki a nappali fényét a lekérdezési sztringhez, majd nyomja le az Enter billentyűt.

   {
       "query": "turn off the living room light",
       "prediction": {
           "topIntent": "HomeAutomation.TurnOff",
           "intents": {
               "HomeAutomation.TurnOff": {
                   "score": 0.969448864
               },
               "HomeAutomation.QueryState": {
                   "score": 0.0122336326
               },
               "HomeAutomation.TurnUp": {
                   "score": 0.006547436
               },
               "HomeAutomation.TurnDown": {
                   "score": 0.0050634006
               },
               "HomeAutomation.SetDevice": {
                   "score": 0.004951761
               },
               "HomeAutomation.TurnOn": {
                   "score": 0.00312553928
               },
               "None": {
                   "score": 0.000552945654
               }
           },
           "entities": {
               "HomeAutomation.Location": [
                   "living room"
               ],
               "HomeAutomation.DeviceName": [
                   [
                       "living room light"
                   ]
               ],
               "HomeAutomation.DeviceType": [
                   [
                       "light"
                   ]
               ],
               "$instance": {
                   "HomeAutomation.Location": [
                       {
                           "type": "HomeAutomation.Location",
                           "text": "living room",
                           "startIndex": 13,
                           "length": 11,
                           "score": 0.902181149,
                           "modelTypeId": 1,
                           "modelType": "Entity Extractor",
                           "recognitionSources": [
                               "model"
                           ]
                       }
                   ],
                   "HomeAutomation.DeviceName": [
                       {
                           "type": "HomeAutomation.DeviceName",
                           "text": "living room light",
                           "startIndex": 13,
                           "length": 17,
                           "modelTypeId": 5,
                           "modelType": "List Entity Extractor",
                           "recognitionSources": [
                               "model"
                           ]
                       }
                   ],
                   "HomeAutomation.DeviceType": [
                       {
                           "type": "HomeAutomation.DeviceType",
                           "text": "light",
                           "startIndex": 25,
                           "length": 5,
                           "modelTypeId": 5,
                           "modelType": "List Entity Extractor",
                           "recognitionSources": [
                               "model"
                           ]
                       }
                   ]
               }
           }
       }
   }
   

Az erőforrások eltávolítása

Ha már nincs rá szükség, törölje a LUIS-alkalmazást. Ehhez válassza a My apps (Saját alkalmazások) elemet a bal oldali felső menüben. Válassza az alkalmazáslistában az alkalmazás neve mellett jobbra található három pontot (...), majd a Delete (Törlés) lehetőséget. A Delete app? (Törli az alkalmazást?) előugró párbeszédpanelen válassza az OK lehetőséget.

Következő lépések

• Iteratív alkalmazástervezés
• Ajánlott eljárások