Snabbstart: Skapa din app i LUIS-portalen

I den här snabbstarten skapar du en LUIS-app med hjälp av den fördefinierade domänen för hemautomatisering för att släcka lampor och sätta på och stänga av apparater. Den fördefinierade domänen ger dig avsikter, entiteter och exempelyttranden. Prova sedan att anpassa din app genom att lägga till fler avsikter och entiteter. När du är klar har du en LUIS-slutpunkt som körs i molnet.

Logga in på LUIS-portalen

En ny användare till LUIS måste följa den här proceduren:

1. Logga in på LUIS-portalen,välj land/region och godkänn användningsvillkoren. Om du ser Mina appar i stället finns det redan en LUIS-resurs och du bör gå vidare och skapa en app. Om inte kan du börja med att använda en Azure-resurs. På så sätt kan du länka ditt LUIS-konto till en ny eller befintlig Azure-redigeringsresurs.

2. I fönstret Välj en redigering som visas hittar du din Azure-prenumeration och LUIS-redigeringsresursen. Om du inte har någon resurs kan du skapa en ny.

   

   När du skapar en ny redigeringsresurs anger du följande information:

   • Klientnamn – den klientorganisation som din Azure-prenumeration är associerad med.
   • Azure-prenumerationsnamn – den prenumeration som debiteras för resursen.
   • Namn på Azure-resursgrupp – ett anpassat resursgruppsnamn som du väljer eller skapar. Med resursgrupper kan du gruppera Azure-resurser för åtkomst och hantering.
   • Azure-resursnamn – ett anpassat namn som du väljer och som används som en del av URL:en för dina redigerings- och förutsägelseslutpunktsfrågor.
   • Prisnivå – prisnivån avgör den maximala transaktionen per sekund och månad.

Välj prenumeration och redigering av resurs

När du väljer en speciell prenumeration och skapar resurs visas en lista över appar som är kopplade till den.

Skapa en ny app

Du kan skapa och hantera dina appar på Mina appar.

Skapa ett program

Skapa ett program genom att klicka på + Ny app.

Ange följande information i fönstret som visas:

Välj Klar.

Lägga till fördefinierad domän

LUIS erbjuder en uppsättning fördefinierade domäner som kan hjälpa dig att komma igång med ditt program. En förbyggd domänapp är redan ifylld med avsikterna, entiteter och yttranden.

1. I det vänstra navigeringsfönstret väljer du Fördefinierade domäner.

2. Sök efter HomeAutomation.

3. Välj Lägg till domän på kortet HomeAutomation.

   

   När domänen har lagts till visar rutan för den fördefinierade domänen knappen Remove domain (Ta bort domän).

Kolla in avsikter och entiteter

1. Välj Avsikter i den vänstra navigeringsmenyn för att se domänavsikterna för HomeAutomation. Den har exempelyttranden, till exempel HomeAutomation.QueryState och HomeAutomation.SetDevice .

   Anteckning

   None (Ingen) är en avsikt som tillhandahålls av alla LUIS-appar. Du kan använda den till att hantera yttranden som inte motsvarar funktioner som finns i din app.

2. Välj avsikten HomeAutomation.TurnOff (stänga av). Avsikten innehåller en lista över exempelyttranden som är märkta med entiteter.

   

3. Om du vill visa entiteterna för appen väljer du Entiteter. Om du klickar på en av entiteterna, till exempel HomeAutomation.DeviceName, visas en lista med värden som är associerade med den.

   

Träna LUIS-appen

När programmet har fyllts i med avsikter, entiteter och yttranden; du måste träna programmet så att de ändringar du har gjort kan återspeglas.

1. I den övre högra delen av webbplatsen LUIS väljer du knappen träna .

   

2. Träningen är klar när status indikatorn på knappen träna är grön.

Testa appen

När du har tränat appen kan du testa den.

1. Välj Test i det övre högra navigeringsfönstret.

2. Skriv ett testyttrande i det interaktiva testfönstret och tryck på Retur. Till exempel, Stäng av lamporna.

   I det här exemplet identifieras Släck lamporna korrekt som avsikten med högst poäng för HomeAutomation.TurnOff.

   

3. Välj Inspektera för att visa mer information om förutsägelsen.

   

4. Stäng testfönstret.

Anpassa ditt program

Förutom de fördefinierade domänerna kan du med LUIS skapa egna anpassade program eller anpassa ovanpå de fördefinierade.

Skapa avsikter

Lägga till fler avsikter i din app

1. Välj Intents (Avsikter) i den vänstra navigeringsmenyn.
2. Välj Skapa
3. Ange avsiktsnamnet, HomeAutomation.AddDeviceAlias , och välj sedan Klar.

Skapa entiteter

Lägga till fler entiteter i din app

1. Välj Entiteter i den vänstra navigeringsmenyn.
2. Välj Skapa
3. Ange entitetsnamnet, HomeAutomation.DeviceAlias , välj maskininlärd från typ och välj sedan Skapa.

Lägga till exempelyttranden

Exempelyttranden är text som en användare anger i en chattrobot eller ett annat klientprogram. De mappar avsikten med användarens text till en LUIS-avsikt.

På sidan Intents (Avsikter) HomeAutomation.AddDeviceAlias för lägger du till följande exempelyttranden under Exempelyttrande,

Se till att exempelyttrandena varierar på följande sätt för bästa resultat:

• Ta upp längd
• Skiljetecken
• Ordval
• Verbtense (är, var, kommer att vara)
• Ordordning

Exempelyttranden för etiketter

Du behöver märka dina yttranden eftersom du har lagt till en ML entitet. Etikettering används av ditt program för att lära dig hur du extraherar de ML som du har skapat.

För att märka dina yttranden har du två alternativ: Etikett för entitetspalett och infogade etiketter.

Etikettning av entitetspalett

När du klickar på @ ikonen längst upp till höger öppnas entitetspaletten till höger på sidan.

1. Välj den entitet som du vill börja etikettera.

   

2. Markera den text som du vill märka med den här entiteten.

   

Infogade etiketter

1. Markera den text som du vill märka upp.

2. Välj den entitet som du vill märka texten med från menyn som visas.

   

Skapa förutsägelseresurs

Nu har du slutfört redigeringen av programmet. Du måste skapa en förutsägelseresurs för att publicera ditt program för att kunna ta emot förutsägelser i en chattrobot eller ett annat klientprogram via förutsägelseslutpunkten

Så här skapar du en förutsägelseresurs från LUIS-portalen

1. Gå till fliken Hantera i ditt program.

2. I det vänstra navigeringsfönstret väljer du Azure-resurser.

3. klicka på knappen Lägg till förutsägelseresurs.

   

   Om du redan har en förutsägelseresurs lägger du till den. Annars väljer du Skapa en ny förutsägelseresurs.

   

Publicera appen för att få slutpunkts-URL

För att kunna ta emot en LUIS förutsägelse i en chatt-robot eller något annat klient program måste du publicera appen till förutsägelse slut punkten.

1. Välj publicera i det övre högra navigerings fältet.

   

2. Välj produktions plats och välj sedan Slutför.

   

3. Välj åtkomst till dina slut punkts-URL: er i meddelandet för att gå till sidan Azure-resurser . Du kommer bara att kunna se URL: erna om du har en förutsägelse resurs som är kopplad till appen. Du kan också hitta sidan Azure-resurser genom att klicka på Hantera.

   

Fråga V3 API-slutpunkten för förutsägelse

1. I LUIS-portalen i avsnittet Hantera (översta högra menyn) på sidan Azure-resurser (menyn till vänster) på fliken förutsägelse resurser , kopierar du exempel frågan längst ned på sidan. URL: en har ditt app-ID, nyckel och plats namn. Slutpunkts-URL: en för v3-förutsägelse har formatet: 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

   

   Klistra in webb adressen i en ny flik i webbläsaren. Om du inte ser webb adressen har du ingen förutsägelse resurs och behöver skapa en.

2. Kontrollera att följande värden finns i URL:en för frågesträngen i webbläsarens adressfält. Om de inte finns i frågesträngen lägger du till dem:

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

3. I webbläsarens adressfält går du till slutet av URL:en och anger inaktiverar glödlampan för frågesträngen och trycker på Retur.

   {
       "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"
                           ]
                       }
                   ]
               }
           }
       }
   }
   

Läs mer om V3-slutpunkten för förutsägelse.

Rensa resurser

Ta bort LUIS-appen när den inte längre behövs. Det gör du genom att välja My apps (Mina appar) på menyn längst upp till vänster. Välj ellipsen (... _) till höger om namnet på appen i listan appar väljer du _ ta bort. På popup-dialogrutan Delete app? (Ta bort appen?) väljer du Ok.

Nästa steg

• Iterativ apputformning
• Bästa praxis