Snabbstart: Använda en färdig hemautomatiseringsappQuickstart: Use prebuilt Home automation app

I den här snabbstarten skapar du en LUIS-app som använder den fördefinierade domänen HomeAutomation för att släcka lampor och stänga av apparater.In this quickstart, create a LUIS app that uses the prebuilt domain HomeAutomation for turning lights and appliances on and off. Den fördefinierade domänen ger dig avsikter, entiteter och exempelyttranden.This prebuilt domain provides intents, entities, and example utterances for you. När du är klar har du en LUIS-slutpunkt som körs i molnet.When you're finished, you'll have a LUIS endpoint running in the cloud.

Logga in på LUIS-portalenSign in to LUIS portal

En ny användare av LUIS måste följa den här proceduren:A new user to LUIS needs to follow this procedure:

  1. Logga in på Luis-portalen, Välj land/region och godkänn användnings villkoren.Sign in to the LUIS portal, select your country/region and agree to the terms of use. Om du ser Mina appar i stället finns det redan en Luis-resurs och du bör gå vidare till skapa en app.If you see My Apps instead, a LUIS resource already exists and you should skip ahead to create an app. Du har två alternativ för att registrera dig:You will have two options signing up:

    • Med hjälp av en Azure-resurs (rekommenderas) – kan du länka ditt LUIS-konto till en ny eller befintlig Azure Authoring-resurs.Using an Azure resource (recommended) - allows you to link your LUIS account with a new or existing Azure Authoring resource. Detta motsvarar att registrera redan migrerat.This is equivalent to signing up already migrated. Du behöver inte gå igenom migreringsprocessen senare.You won't need to go through the migration process later on.

    • Använda en utvärderings nyckel.Using a trial key. På så sätt kan du logga in på LUIS med en utvärderings resurs som du inte behöver konfigurera.This allows you to sign in to LUIS with a trial resource that you don't need to set up. Om du väljer det här alternativet kommer du att behöva migrera ditt konto och länka dina program till en redigerings resurs.If you choose this option, you will eventually be required to migrate your account and link your applications to an authoring resource.

  2. I fönstret Välj ett redigerings fönster som visas letar du reda på din Azure-prenumeration och Luis Authoring-resurs.In the Choose an authoring window that appears, find your Azure subscription, and LUIS authoring resource. Om du inte har någon resurs kan du skapa en ny.If you don't have a resource, you can create a new one.

    Välj en typ av Language Understanding redigering av resurs.

    När du skapar en ny redigerings resurs anger du följande information:When you create a new authoring resource, provide the following information:

    • Klient organisations namn – klienten som din Azure-prenumeration är associerad med.Tenant name - the tenant your Azure subscription is associated with.
    • Namn på Azure-prenumeration – den prenumeration som ska faktureras för resursen.Azure subscription name - the subscription that will be billed for the resource.
    • Namn på Azure-resurs grupp – ett namn på en anpassad resurs grupp som du väljer eller skapar.Azure resource group name - a custom resource group name you choose or create. Med resurs grupper kan du gruppera Azure-resurser för åtkomst och hantering.Resource groups allow you to group Azure resources for access and management.
    • Azure-resurs namn – ett anpassat namn som du väljer, används som en del av URL: en för din redigerings-och förutsägelse slut punkts fråga.Azure resource name - a custom name you choose, used as part of the URL for your authoring and prediction endpoint queries.
    • Pris nivå – pris nivån avgör den högsta transaktionen per sekund och månad.Pricing tier - the pricing tier determines the maximum transaction per second and month.

Välj prenumeration och redigering av resursSelect subscription and authoring resource

När du väljer en speciell prenumeration och skapar resurs visas en lista över appar som är kopplade till den.When you select a specific subscription and authoring resource, you will see a list of apps associated with it.

Välj redigering av prenumeration och redigering av resurs

Skapa en ny appCreate a new app

Du kan skapa och hantera dina appar på Mina appar.You can create and manage your applications on My Apps.

Skapa ett programCreate an application

Om du vill skapa ett program klickar du på + ny app.To create an application, click + New app.

I fönstret som visas anger du följande information:In the window that appears, enter the following information:

NameName BeskrivningDescription
ANameAName Ett namn för din app.A name for the your app. Till exempel "Start automatisering".For example "home automation".
KulturCulture Det språk som din app förstår och pratar med.The language that your app understands and speaks.
DescriptionDescription En beskrivning av din app.A description for your app.
Förutsägelse resursPrediction resource Den förutsägelse resurs som tar emot frågor.The prediction resource that will receive queries.

Välj Klar.Select Done.

Anteckning

Kulturen kan inte ändras när appen har skapats.The culture cannot be changed once the application is created.

Lägga till fördefinierad domänAdd prebuilt domain

  1. I det vänstra navigerings fältet väljer du fördefinierade domäner.In the left navigation, select Prebuilt domains.

  2. Sök efter HomeAutomation.Search for HomeAutomation.

  3. Välj Lägg till domän på HomeAutomation-kortet.Select Add domain on the HomeAutomation card.

    Välj "förinställda domäner" och Sök efter "HomeAutomation".Select 'Prebuilt domains' then search for 'HomeAutomation'. Välj Lägg till domän på HomeAutomation-kortet.Select 'Add domain' on the HomeAutomation card.

    När domänen har lagts till visar rutan för den fördefinierade domänen knappen Remove domain (Ta bort domän).When the domain is successfully added, the prebuilt domain box displays a Remove domain button.

Avsikter och entiteterIntents and entities

  1. Välj avsikter i den vänstra navigerings menyn för att se HomeAutomation domän avsikter.Select Intents in the left navigation menu to see the HomeAutomation domain intents. Den har exempel yttranden, till exempel HomeAutomation.QueryState och HomeAutomation.SetDevice .It has example utterances, such as HomeAutomation.QueryState and HomeAutomation.SetDevice.

    Anteckning

    None (Ingen) är en avsikt som tillhandahålls av alla LUIS-appar.None is an intent provided by all LUIS apps. Du kan använda den till att hantera yttranden som inte motsvarar funktioner som finns i din app.You use it to handle utterances that don't correspond to functionality your app provides.

  2. Välj avsikten HomeAutomation.TurnOff (stänga av).Select the HomeAutomation.TurnOff intent. Avsikten innehåller en lista över exempel-yttranden som är märkta med entiteter.The intent contains a list of example utterances that are labeled with entities.

    Skärmbild av avsikten HomeAutomation.TurnOffScreenshot of HomeAutomation.TurnOff intent

  3. Om du vill visa entiteternas entiteter väljer du entiteter.If you want to view the entities for the app, select Entities. Om du klickar på en av entiteterna, till exempel HomeAutomation. enhets namn, visas en lista över värden som är kopplade till den.If you click on one of the entities, such as HomeAutomation.DeviceName you will see a list of values associated with it.

    Alternativ text för bild

Träna LUIS-appenTrain the LUIS app

  1. I den övre högra delen av webbplatsen LUIS väljer du knappen träna .In the top-right side of the LUIS website, select the Train button.

    Knappen Train (Träna)

  2. Träningen är klar när status indikatorn på knappen träna är grön.Training is complete when status indicator on the Train button is green.

Testa din appTest your app

När du har tränat appen kan du testa den.Once you've trained your app, you can test it.

  1. Välj test i det övre högra navigerings fönstret.Select Test from the top-right navigation.

  2. Skriv ett test-uttryck som Turn off the lights i det interaktiva test fönstret och tryck på RETUR.Type a test utterance like Turn off the lights into the interactive test pane, and press Enter. Stäng till exempel ljuset.For example, Turn off the lights.

    I det här exemplet Turn off the lights identifieras korrekt som det främsta bedömnings syftet för HomeAutomation. TurnOff.In this example, Turn off the lights is correctly identified as the top scoring intent of HomeAutomation.TurnOff.

    Skärmbild av testpanel med yttranden markerade

  3. Välj kontrol lera om du vill visa mer information om förutsägelsen.Select Inspect to view more information about the prediction.

    Skärm bild av test panelen med gransknings informationScreenshot of Test panel with inspection information

  4. Stäng test fönstret.Close the test pane.

Publicera appen för att få slutpunkts-URLPublish the app to get the endpoint 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.In order to receive a LUIS prediction in a chat bot or other client application, you need to publish the app to the prediction endpoint.

  1. Välj publicera i det övre högra hörnet i fönstret.Select Publish in the top-right corner of the window.

  2. Välj produktions plats och välj sedan Slutför.Select the Production slot, then select Done.

    Skärm bild av LUIS publicera till slut punktScreenshot of LUIS publish to endpoint

  3. Välj länken åtkomst till slut punkts-URL: er i meddelandet för att gå till sidan Azure-resurser .Select the Access your endpoint URLs link in the notification to go to the Azure Resources page. Slut punkts-URL: erna visas som exempel fråga.The endpoint URLs are listed as the Example Query.

Fråga v3 API förutsägelse-slutpunktenQuery the V3 API prediction endpoint

  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.In the LUIS portal, in the Manage section (top-right menu), on the Azure Resources page (left menu), on the Prediction Resources tab, copy the Example Query at the bottom of the page. URL: en har ditt app-ID, nyckel och plats namn.The URL has your app ID, key, and slot name. 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_HEREThe V3 prediction endpoint URL has the form of: 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

    exempel fråga i avsnittet förutsägelse resurser

    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.Paste the URL into a new browser tab. If you don't see the URL, you don't have a prediction resource and will need to create one.

  1. I adress fältet i webbläsaren kontrollerar du att följande namn och värde fält finns i URL: en för frågesträngen.In the browser address bar, for the query string, make sure the following name and value bars are in the URL. Om de inte finns i frågesträngen lägger du till dem:If they are not in the query string, add them:

    Namn/värde-parName/value pair
    verbose=true
    show-all-intents=true
  2. I webbläsarens Adress fält går du till slutet av URL: en och anger turn off the living room light värdet för fråga och trycker på RETUR.In the browser address bar, go to the end of the URL and enter turn off the living room light for the query value, then press 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"
                            ]
                        }
                    ]
                }
            }
        }
    }
    

    Läs mer om v3 förutsägelse slut punkten.Learn more about the V3 prediction endpoint.

Rensa resurserClean up resources

Ta bort LUIS-appen när den inte längre behövs.When no longer needed, delete the LUIS app. Det gör du genom att välja My apps (Mina appar) på menyn längst upp till vänster.To do so, select My apps from the top left menu. Välj ellipsen (...) till höger om namnet på appen i listan app och välj ta bort.Select the ellipsis (...) to the right of the app name in the app list, select Delete. På popup-dialogrutan Delete app? (Ta bort appen?) väljer du Ok.On the pop-up dialog Delete app?, select Ok.

Nästa stegNext steps

Du kan anropa slutpunkten via kod:You can call the endpoint from code: