Quickstart: Uw app bouwen in de LUIS-portal

In deze quickstart maakt u een LUIS-app met behulp van het vooraf gebouwde domein voor huisautomatisering voor het in- en uitschakelen van lampen en apparaten. Dit vooraf gemaakte domein biedt u intenties, entiteiten voorbeelden van utterances. Probeer vervolgens uw app aan te passen door meer intenties en entiteiten toe te voegen. Wanneer u klaar bent, hebt u een LUIS-eindpunt in de cloud.

Aanmelden bij de LUIS-portal

Een nieuwe gebruiker van LUIS moet deze procedure volgen:

1. Meld u aan bij de LUIS-portal, selecteer uw land/regio en ga akkoord met de gebruiksvoorwaarden. Als u in plaats daarvan Mijn apps ziet, bestaat er al een LUIS-resource en kunt u verdergaan met het maken van een app. Zo niet, begin dan met het gebruik van een Azure-resource. Hiermee kunt u uw LUIS-account koppelen aan een nieuwe of bestaande Azure Authoring-resource.

2. Zoek in het venster Een creatie kiezen dat verschijnt uw Azure-abonnement en LUIS-creatieresource. Als u geen resource hebt, kunt u een nieuwe maken.

   

   Geef bij het maken van een nieuwe ontwerpresource de volgende informatie op:

   • Tenantnaam: de tenant waaraan uw Azure-abonnement is gekoppeld.
   • Azure-abonnementsnaam: het abonnement dat wordt gefactureerd voor de resource.
   • Azure-resourcegroepsnaam: een aangepaste resourcegroepnaam die u kiest of maakt. Met resourcegroepen kunt u Azure-resources groeperen voor toegang en beheer.
   • Azure-resourcenaam: een door u gekozen aangepaste naam die wordt gebruikt als onderdeel van de URL voor uw ontwerp- en voorspellingseindpuntquery's.
   • Prijscategorie: de prijscategorie bepaalt de maximale transactie per seconde en maand.

Abonnement en ontwerpresource selecteren

Wanneer u een specifiek abonnement en een specifieke ontwerpresource selecteert, wordt er een lijst weergegeven met de apps die eraan zijn gekoppeld.

Een nieuwe app maken

U kunt uw toepassingen maken en beheren in Mijn apps.

Een app maken

Als u een app wilt maken, klikt u op + Nieuwe app.

Typ de volgende informatie in het venster dat daarna wordt weergegeven:

Selecteer Gereed.

Vooraf gemaakt domein toevoegen

LUIS biedt een set vooraf gebouwde domeinen die u kunnen helpen aan de slag te gaan met uw toepassing. Een vooraf gebouwde domein-app is al gevuld met intenties, entiteiten en utterances.

1. Selecteer Vooraf gemaakte domeinen in het navigatiedeelvenster links.

2. Zoek naar HomeAutomation.

3. Selecteer Domein toevoegen op de kaart HomeAutomation.

   

   Wanneer het vooraf gemaakte domein is toegevoegd, wordt in het vak met vooraf gemaakte domeinen de knop Remove domain weergegeven.

Intenties en entiteiten controleren

1. Selecteer Intenties in het navigatiedeelvenster aan de linkerkant om de intenties van het domein 'HomeAutomation' weer te geven. Het bevat voorbeelden van utterances, zoals HomeAutomation.QueryState en HomeAutomation.SetDevice.

   Notitie

   None is een intentie die door alle LUIS-apps wordt geboden. U kunt deze gebruiken voor het afhandelen van utterances die niet overeenkomen met de functionaliteit die uw app biedt.

2. Selecteer de intentie HomeAutomation.TurnOff. De intentie bevat een lijst met voorbeelduitingen die zijn gelabeld met entiteiten.

   

3. Als u de entiteiten voor de app wilt weergeven, selecteert u Entiteiten. Als u op een van de entiteiten klikt, zoals HomeAutomation.DeviceName ziet u een lijst met waarden die eraan zijn gekoppeld.

   

LUIS-app trainen

Nadat uw toepassing is gevuld met intenties, entiteiten en utterances; u moet de toepassing trainen zodat de wijzigingen die u hebt aangebracht, kunnen worden doorgevoerd.

1. Selecteer rechts bovenaan op de LUIS-website de knop Train.

   

2. De training is voltooid wanneer de statusindicator op de Train groen is.

Uw app testen

Nadat u uw app hebt getraind, kunt u deze testen.

1. Selecteer Testen in de navigatiebalk rechtsboven.

2. Typ een testuiting in het interactieve testvenster en druk op Enter. Bijvoorbeeld: de lichten uitschakelen.

   In dit voorbeeld wordt De lichten uitschakelen correct geïdentificeerd als de best scorende intentie van HomeAutomation.TurnOff.

   

3. Selecteer Inspecteren om meer informatie over de voorspelling weer te geven.

   

4. Sluit het testvenster.

Uw toepassing aanpassen

Naast de vooraf gebouwde domeinen kunt u met LUIS uw eigen aangepaste toepassingen maken of aanpassen boven op vooraf gebouwde toepassingen.

Intenties maken

Meer intenties toevoegen aan uw app

1. Selecteer Intents in het linkernavigatiemenu.
2. Selecteer Maken
3. Voer de naam van de intentie HomeAutomation.AddDeviceAlias in, en selecteer vervolgens Done.

Entiteiten maken

Meer entiteiten toevoegen aan uw app

1. Selecteer Entiteiten in het linkernavigatiemenu.
2. Selecteer Maken
3. Voer de naam van de entiteit HomeAutomation.DeviceAlias in, selecteer machine learned van type en selecteer vervolgens Maken.

Voorbeelden van utterances toevoegen

Voorbeelduitingen zijn tekst die een gebruiker invoert in een chatbot of andere clienttoepassing. Ze stemmen de intentie van de gebruikerstekst af op een LUIS-intentie.

Voeg op de pagina Intenties voor HomeAutomation.AddDeviceAlias het volgende utterances-voorbeeld toe onder Voorbeelden van utterances.

Voor de beste resultaten moet u ervoor zorgen dat voorbeelduitingen op de volgende manieren variëren:

• Lengte van utterance
• interpunctie
• Woordkeuze
• Werkwoordsvorm (is, was, zal zijn)
• Woordorde

Voorbeelden van uitingen labelen

Het labelen van uw utterances is nodig omdat u een entiteit ML toegevoegd. Labelen wordt door uw toepassing gebruikt om te leren hoe u de ML u hebt gemaakt.

Als u uw utterances wilt labelen, hebt u twee opties: labelen van entiteitspalet en inline labelen.

Labeling van entiteitspalet

Wanneer u op het pictogram @ rechtsboven klikt, wordt het entiteitspalet aan de rechterkant van de pagina geopend.

1. Selecteer de entiteit die u wilt labelen.

   

2. Markeer de tekst die u wilt labelen met deze entiteit.

   

Inline labelen

1. Markeer de tekst die u wilt labelen.

2. Selecteer de entiteit met wie u de tekst wilt labelen in het menu dat wordt weergegeven.

   

Voorspellingsresource maken

Op dit moment hebt u het schrijven van uw toepassing voltooid. U moet een voorspellingsresource maken om uw toepassing te publiceren om voorspellingen te ontvangen in een chatbot of een andere clienttoepassing via het voorspellings-eindpunt

Een voorspellingsresource maken vanuit de LUIS-portal

1. Ga naar het tabblad Beheren in uw toepassing.

2. Selecteer Azure-resources in het linkernavigatievenster.

3. klik op de knop Voorspellingsresource toevoegen.

   

   Als u al een voorspellingsresource hebt, voegt u deze toe. Selecteer anders Een nieuwe voorspellingsresource maken.

   

App publiceren om eindpunt-URL op te vragen

Om een voorspelling van LUIS te ontvangen in een chatbot of een andere clienttoepassing, moet u de app publiceren naar het voorspellingseindpunt.

1. Selecteer Publiceren in de navigatiebalk rechtsboven.

   

2. Selecteer de Productiesite en selecteer vervolgens Gereed.

   

3. Selecteer Uw eindpunt-URL's openen in de melding om naar de pagina Azure-resources te gaan. U kunt de URL's alleen zien als u een voorspellingsresource hebt die aan de app is gekoppeld. U vindt de pagina Azure-resources ook door op Beheren te klikken.

   

Een query uitvoeren op het V3 API-voorspellingseindpunt

1. Kopieer de Voorbeeldquery aan de onderkant van de pagina in het LUIS-portaal, in de sectie Beheren (menu rechtsboven) op de pagina Azure-resources (linkermenu) op het tabblad Voorspellingsresources. De URL bevat uw app-ID, -sleutel en sitenaam. De URL voor het V3-voorspellingseindpunt heeft de volgende vorm: 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

   

   Plak de URL in een nieuw browsertabblad. Als u de URL niet ziet, hebt u geen voorspellingsresource en moet u er een maken.

2. Zorg ervoor dat in de adresbalk van de browser voor de queryreeks de volgende waarden in de URL staan. Als ze niet voorkomen in de queryreeks, voegt u deze toe:

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

3. Ga in de adresbalk van de browser naar het einde van de URL en voer het licht in de huisruimte uit voor de queryreeks en druk op Enter.

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

Meer informatie over het V3-voorspellingseindpunt.

Resources opschonen

Wanneer u de LUIS-app niet meer nodig hebt, kunt u deze verwijderen. Daarvoor selecteert u My apps in het menu linksboven. Selecteer het weglatingsteken (... _) rechts van de app-naam in de lijst met apps, en selecteer vervolgens _ Verwijderen. Selecteer in het pop-upvenster Delete app? de optie Ok.

Volgende stappen

• Interatief app-ontwerp
• Aanbevolen procedures