Quickstart: Getting a LUIS endpoint key

Prerequisites

Be sure you have the following items before you begin this tutorial:

  • A LUIS account. You can get one for free through the LUIS portal.

LUIS and speech

LUIS integrates with the Speech service to recognize intents from speech. You don't need a Speech service subscription, just LUIS.

LUIS uses three kinds of keys:

Key type Purpose
Authoring Lets you create and modify LUIS apps programmatically
Starter Lets you test your LUIS application using text only
Endpoint Authorizes access to a particular LUIS app

For this tutorial, you need the endpoint key type. The tutorial uses the example Home Automation LUIS app, which you can create by following the Use prebuilt Home automation app quickstart. If you've created a LUIS app of your own, you can use it instead.

When you create a LUIS app, LUIS automatically generates a starter key so you can test the app using text queries. This key doesn't enable the Speech service integration and won't work with this tutorial. Create a LUIS resource in the Azure dashboard and assign it to the LUIS app. You can use the free subscription tier for this tutorial.

After you create the LUIS resource in the Azure dashboard, log into the LUIS portal, choose your application on the My Apps page, then switch to the app's Manage page. Finally, select Keys and Endpoints in the sidebar.

LUIS portal keys and endpoint settings

On the Keys and Endpoint settings page:

  1. Scroll down to the Resources and Keys section and select Assign resource.

  2. In the Assign a key to your app dialog box, make the following changes:

    • Under Tenant, choose Microsoft.
    • Under Subscription Name, choose the Azure subscription that contains the LUIS resource you want to use.
    • Under Key, choose the LUIS resource that you want to use with the app.

    In a moment, the new subscription appears in the table at the bottom of the page.

  3. Select the icon next to a key to copy it to the clipboard. (You may use either key.)

LUIS app subscription keys

Next steps