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.
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.
Sign in to the LUIS portal.
Select Create new app.
In the dialog box, name your application "Home Automation".
Choose your application culture. For this Home Automation app, choose English. Then select Done. LUIS creates the Home Automation app.
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.
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
In the top right side of the LUIS website, select the Train button.
Training is complete when you see the green status bar at the top of the website confirming success.
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
In order to receive a LUIS prediction in a chat bot or other client application, you need to publish the app to the endpoint.
Select Publish in the top right navigation.
Select the Production slot and the Publish button.
Publishing is complete when you see the green status bar at the top of the website confirming success.
Select the endpoints link in the green status bar to go to the Keys and endpoints page. The endpoint URLs are listed at the bottom.
Query the endpoint with a different utterance
In the Manage section (top right menu), on the Keys and endpoints page (left menu), select the endpoint URL at the bottom of the page. This action opens another browser tab with the endpoint URL in the address bar.
The endpoint URL looks like
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
When no longer needed, delete the LUIS app. To do so, select My apps from the top left menu. Select the ellipsis (...) 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:
We would love to hear your thoughts. Choose the type you would like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.