Skip to content

Latest commit

 

History

History
107 lines (64 loc) · 4.85 KB

luis-get-started-create-app.md

File metadata and controls

107 lines (64 loc) · 4.85 KB
title titleSuffix description services author ms.custom manager ms.service ms.component ms.topic ms.date ms.author
Quickstart: create app
Language Understanding - Azure Cognitive Services
Create a LUIS app that uses the prebuilt domain `HomeAutomation` for turning lights and appliances on and off. This prebuilt domain provides intents, entities, and example utterances for you. When you're finished, you'll have a LUIS endpoint running in the cloud.
cognitive-services
diberry
seodec18
cgronlun
cognitive-services
language-understanding
quickstart
09/10/2018
diberry

Quickstart: Use prebuilt Home automation app

In this quickstart, create a LUIS app that uses the prebuilt domain HomeAutomation for turning lights and appliances on and off. This prebuilt domain provides intents, entities, and example utterances for you. When you're finished, you'll have a LUIS endpoint running in the cloud.

Prerequisites

For this article, you need a free LUIS account, created on the LUIS portal at https://www.luis.ai.

Create a new app

You can create and manage your applications on My Apps.

  1. Sign in to the LUIS portal.

  2. Select Create new app.

  3. In the dialog box, name your application "Home Automation".

  4. Choose your application culture. For this Home Automation app, choose English. Then select Done. LUIS creates the Home Automation app.

    [!NOTE] The culture cannot be changed once the application is created.

Add prebuilt domain

Select Prebuilt domains in the left-side navigation pane. Then search for "Home". Select Add domain.

When the domain is successfully added, the prebuilt domain box displays a Remove domain button.

Intents and entities

Select Intents in the left-side navigation pane to review the HomeAutomation domain intents. Each intent has sample utterances.

Note

None is an intent provided by all LUIS apps. You use it to handle utterances that don't correspond to functionality your app provides.

Select the HomeAutomation.TurnOff intent. You can see that the intent contains a list of utterances that are labeled with entities.

Train the LUIS app

[!INCLUDE LUIS How to Train steps]

Test your app

Once you've trained your app, you can test it. Select Test in the top navigation. Type a test utterance like "Turn off the lights" into the Interactive Testing pane, and press Enter.

Turn off the lights

Check that the top scoring intent corresponds to the intent you expected for each test utterance.

In this example, "Turn off the lights" is correctly identified as the top scoring intent of "HomeAutomation.TurnOff."

Select Test again to collapse the test pane.

Publish the app to get the endpoint URL

[!INCLUDE LUIS How to Publish steps]

Query the endpoint with a different utterance

  1. [!INCLUDE LUIS How to get endpoint first step]

  2. Go to the end of the URL in the address and enter turn off the living room light, and then press Enter. The browser displays the JSON response of your HTTP endpoint.

Clean up resources

[!INCLUDE LUIS How to clean up resources]

Next steps

You can call the endpoint from code:

[!div class="nextstepaction"] Call a LUIS endpoint using code