How to create and manage LUIS resources

Important

LUIS will be retired on October 1st 2025 and starting April 1st 2023 you will not be able to create new LUIS resources. We recommend migrating your LUIS applications to conversational language understanding to benefit from continued product support and multilingual capabilities.

Use this article to learn about the types of Azure resources you can use with LUIS, and how to manage them.

Authoring Resource

An authoring resource lets you create, manage, train, test, and publish your applications. One pricing tier is available for the LUIS authoring resource - the free (F0) tier, which gives you:

• 1 million authoring transactions
• 1,000 testing prediction endpoint requests per month.

You can use the v3.0-preview LUIS Programmatic APIs to manage authoring resources.

Prediction resource

A prediction resource lets you query your prediction endpoint beyond the 1,000 requests provided by the authoring resource. Two pricing tiers are available for the prediction resource:

• The free (F0) prediction resource, which gives you 10,000 prediction endpoint requests monthly.
• Standard (S0) prediction resource, which is the paid tier.

You can use the v3.0-preview LUIS Endpoint API to manage prediction resources.

Note

• You can also use a multi-service resource to get a single endpoint you can use for multiple Azure AI services.
• LUIS provides two types of F0 (free tier) resources: one for authoring transactions and one for prediction transactions. If you're running out of free quota for prediction transactions, make sure you're using the F0 prediction resource, which gives you a 10,000 free transactions monthly, and not the authoring resource, which gives you 1,000 prediction transactions monthly.
• You should author LUIS apps in the regions where you want to publish and query.

Create LUIS resources

To create LUIS resources, you can use the LUIS portal, Azure portal, or Azure CLI. After you've created your resources, you'll need to assign them to your apps to be used by them.

LUIS portal

Create a LUIS authoring resource using the LUIS portal

1. Sign in to the LUIS portal, select your country/region and agree to the terms of use. If you see the My Apps section in the portal, a LUIS resource already exists and you can skip the next step.

2. In the Choose an authoring window that appears, find your Azure subscription, and LUIS authoring resource. If you don't have a resource, you can create a new one.

   

   When you create a new authoring resource, provide the following information:

   • Tenant name: the tenant your Azure subscription is associated with.
   • Azure subscription name: the subscription that will be billed for the resource.
   • Azure resource group name: a custom resource group name you choose or create. Resource groups allow you to group Azure resources for access and management.
   • Azure resource name: a custom name you choose, used as part of the URL for your authoring and prediction endpoint queries.
   • Pricing tier: the pricing tier determines the maximum transaction per second and month.

Create a LUIS Prediction resource using the LUIS portal

1. Go to the Manage tab in your application.

2. In the left navigation, select Azure Resources.

3. select Add Prediction resource button.

   

   If you already have a prediction resource, add it. Otherwise, select Create a new prediction resource.

   

Without LUIS portal

Create LUIS resources without using the LUIS portal

Use the Azure CLI to create each resource individually.

Tip

• The authoring resource kind is LUIS.Authoring
• The prediction resource kind is LUIS

1. Sign in to the Azure CLI:

   az login
   

   This command opens a browser so you can select the correct account and provide authentication.

2. Create a LUIS authoring resource of kind LUIS.Authoring, named my-luis-authoring-resource. Create it in the existing resource group named my-resource-group for the westus region.

   az cognitiveservices account create -n my-luis-authoring-resource -g my-resource-group --kind LUIS.Authoring --sku F0 -l westus --yes
   

3. Create a LUIS prediction endpoint resource of kind LUIS, named my-luis-prediction-resource. Create it in the existing resource group named my-resource-group for the westus region. If you want higher throughput than the free tier provides, change F0 to S0. Learn more about pricing tiers and throughput.

   az cognitiveservices account create -n my-luis-prediction-resource -g my-resource-group --kind LUIS --sku F0 -l westus --yes
   

Assign LUIS resources

Creating a resource doesn't necessarily mean that it is put to use, you need to assign it to your apps. You can assign an authoring resource for a single app or for all apps in LUIS.

LUIS portal

Assign resources using the LUIS portal

Assign an authoring resource to all your apps

The following procedure assigns the authoring resource to all apps.

1. Sign in to the LUIS portal.
2. In the upper-right corner, select your user account, and then select Settings.
3. On the User Settings page, select Add authoring resource, and then select an existing authoring resource. Select Save.

Assign a resource to a specific app

The following procedure assigns a resource to a specific app.

1. Sign in to the LUIS portal. Select an app from the My apps list.

2. Go to Manage > Azure Resources:

   

3. On the Prediction resource or Authoring resource tab, select the Add prediction resource or Add authoring resource button.

4. Use the fields in the form to find the correct resource, and then select Save.

Without LUIS portal

Assign prediction resource without using the LUIS portal

For automated processes like CI/CD pipelines, you can automate the assignment of a LUIS resource to a LUIS app with the following steps:

1. Get an Azure Resource Manager token which is an alphanumeric string of characters. This token does expire, so use it right away. You can also use the following Azure CLI command.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Use the token to request the LUIS runtime resources across subscriptions. Use the API to get the LUIS Azure account that your user account has access to.

   This POST API requires the following values:

   Header	Value
   Authorization	The value of Authorization is Bearer {token}. The token value must be preceded by the word Bearer and a space.
   Ocp-Apim-Subscription-Key	Your authoring key.

   The API returns an array of JSON objects that represent your LUIS subscriptions. Returned values include the subscription ID, resource group, and resource name, returned as AccountName. Find the item in the array that's the LUIS resource that you want to assign to the LUIS app.

3. Assign the token to the LUIS resource by using the Assign a LUIS Azure accounts to an application API.

   This POST API requires the following values:

   Type	Setting	Value
   Header	Authorization	The value of Authorization is Bearer {token}. The token value must be preceded by the word Bearer and a space.
   Header	Ocp-Apim-Subscription-Key	Your authoring key.
   Header	Content-type	application/json
   Querystring	appid	The LUIS app ID.
   Body		{AzureSubscriptionId: Your Subscription ID, ResourceGroup: Resource Group name that has your prediction resource, AccountName: Name of your prediction resource}

   When this API is successful, it returns 201 - created status.

Unassign a resource

When you unassign a resource, it's not deleted from Azure. It's only unlinked from LUIS.

LUIS portal

Unassign resources using LUIS portal

1. Sign in to the LUIS portal, and then select an app from the My apps list.
2. Go to Manage > Azure Resources.
3. Select the Unassign resource button for the resource.

Without LUIS portal

Unassign prediction resource without using the LUIS portal

1. Get an Azure Resource Manager token which is an alphanumeric string of characters. This token does expire, so use it right away. You can also use the following Azure CLI command.

   az account get-access-token --resource=https://management.core.windows.net/ --query accessToken --output tsv
   

2. Use the token to request the LUIS runtime resources across subscriptions. Use the Get LUIS Azure accounts API, which your user account has access to.

   This POST API requires the following values:

   Header	Value
   Authorization	The value of Authorization is Bearer {token}. The token value must be preceded by the word Bearer and a space.
   Ocp-Apim-Subscription-Key	Your authoring key.

   The API returns an array of JSON objects that represent your LUIS subscriptions. Returned values include the subscription ID, resource group, and resource name, returned as AccountName. Find the item in the array that's the LUIS resource that you want to assign to the LUIS app.

3. Assign the token to the LUIS resource by using the Unassign a LUIS Azure account from an application API.

   This DELETE API requires the following values:

   Type	Setting	Value
   Header	Authorization	The value of Authorization is Bearer {token}. The token value must be preceded by the word Bearer and a space.
   Header	Ocp-Apim-Subscription-Key	Your authoring key.
   Header	Content-type	application/json
   Querystring	appid	The LUIS app ID.
   Body		{AzureSubscriptionId: Your Subscription ID, ResourceGroup: Resource Group name that has your prediction resource, AccountName: Name of your prediction resource}

   When this API is successful, it returns 200 - OK status.

Resource ownership

An Azure resource, like a LUIS resource, is owned by the subscription that contains the resource.

To change the ownership of a resource, you can take one of these actions:

• Transfer the ownership of your subscription.
• Export the LUIS app as a file, and then import the app on a different subscription. Export is available on the My apps page in the LUIS portal.

Resource limits

Authoring key creation limits

You can create as many as 10 authoring keys per region, per subscription. Publishing regions are different from authoring regions. Make sure you create an app in the authoring region that corresponds to the publishing region where you want your client application to be located. For information on how authoring regions map to publishing regions, see Authoring and publishing regions.

See resource limits for more information.

Errors for key usage limits

Usage limits are based on the pricing tier.

If you exceed your transactions-per-second (TPS) quota, you receive an HTTP 429 error. If you exceed your transaction-per-month (TPM) quota, you receive an HTTP 403 error.

Change the pricing tier

1. In the Azure portal, Go to All resources and select your resource

   

2. From the left side menu, select Pricing tier to see the available pricing tiers

3. Select the pricing tier you want, and click Select to save your change. When the pricing change is complete, a notification will appear in the top right with the pricing tier update.

View Azure resource metrics

View a summary of Azure resource usage

You can view LUIS usage information in the Azure portal. The Overview page shows a summary, including recent calls and errors. If you make a LUIS endpoint request, allow up to five minutes for the change to appear.

Customizing Azure resource usage charts

The Metrics page provides a more detailed view of the data. You can configure your metrics charts for a specific time period and metric.

Total transactions threshold alert

If you want to know when you reach a certain transaction threshold, for example 10,000 transactions, you can create an alert:

1. From the left side menu, select Alerts

2. From the top menu select New alert rule

   

3. Select Add condition

   

4. Select Total calls

   

5. Scroll down to the Alert logic section and set the attributes as you want and click Done

   

6. To send notifications or invoke actions when the alert rule triggers go to the Actions section and add your action group.

   

Reset an authoring key

For migrated authoring resource apps: If your authoring key is compromised, reset the key in the Azure portal, on the Keys page for the authoring resource.

For apps that haven't been migrated: The key is reset on all your apps in the LUIS portal. If you author your apps via the authoring APIs, you need to change the value of Ocp-Apim-Subscription-Key to the new key.

Regenerate an Azure key

You can regenerate an Azure key from the Keys page in the Azure portal.

App ownership, access, and security

An app is defined by its Azure resources, which are determined by the owner's subscription.

You can move your LUIS app. Use the following resources to help you do so by using the Azure portal or Azure CLI:

• Move an app between LUIS authoring resources
• Move a resource to a new resource group or subscription
• Move a resource within the same subscription or across subscriptions

Next steps

• Learn how to use versions to control your app life cycle.