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 already has intents and entities provided for you. When you're finished, you'll have a LUIS endpoint running in the cloud.
For this article, you need a free LUIS account in order to author your LUIS application.
- To use Microsoft Cognitive Service APIs, you first need to create a Cognitive Services API account in the Azure portal.
- If you don't have an Azure subscription, create a free account before you begin.
Create a new app
You can create and manage your applications on My Apps page of LUIS.
Click Create new app.
In the dialog box, name your application "Home Automation".
Choose your application culture (for this Home Automation app, choose English), and then click Done.
The culture cannot be changed once the application is created.
LUIS creates the Home Automation app.
Add prebuilt domain
Click on Prebuilt domains in the left-side navigation pane. Then search for "Home". Click on Add domain.
When the domain is successfully added, the prebuilt domain box displays a Remove domain button.
Intents and entities
Click on Intents in the left-side navigation pane to review the HomeAutomation domain intents.
Each intent has sample utterances.
None is an intent provided by all LUIS apps. You use it to handle utterances that don't correspond to functionality your app provides.
Click on the HomeAutomation.TurnOff intent. You can see that the intent contains a list of utterances that are labeled with entities.
Train your app
Click on Train in the top navigation.
Test your app
Once you've trained your app, you can test it. Click 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."
Click Test again to collapse the test pane.
Publish your app
Select Publish from the top navigation.
Select the Production slot and the Publish button.
The green notification bar at the top indicates the app successfully published.
After you've successfully published, you can use the endpoint URL displayed in the Publish app page.
Use your app
You can test your published endpoint in a browser using the generated URL. Open this URL in your browser, set the URL parameter "&q" to your test query. For example, add
turn off the living room light to the end of your URL, and then press Enter. The browser displays the JSON response of your HTTP endpoint.
Clean up resources
When no longer needed, delete the LUIS app. To do so, select the ellipsis (...) button to the right of the app name in the app list, select Delete. On the pop-up dialog Delete app?, select Ok.
You can call the endpoint from code: