Admin handoff for LUIS
APPLIES TO: Composer v2.x
Note
Language Understanding (LUIS) will be retired on 1 October 2025. Beginning 1 April 2023, you won't be able to create new LUIS resources. A newer version of language understanding is now available as part of Azure AI Language.
Conversational language understanding (CLU), a feature of Azure AI Language, is the updated version of LUIS. For more information about question-and-answer support in Composer, see Natural language processing.
In many cases, such as adding an intent trigger for a LUIS recognizer bot or using a template that requires LUIS, it's required to provide a LUIS Authoring key to Composer to allow for your bot project to launch properly.
Many users won't have the right to create a LUIS service for their bot project as they don't have rights to an Azure Tenant to create objects. The following with walk a user through the process of generating an Admin Handoff request.
In Composer there are two ways to initiate the LUIS provisioning for your local development environment.
The first is to go to the Configure tab on the navigation on the left column and choose the tab called Development resources. Under this section select the Set up Language Understanding button on the bottom.
The other way is if you've added any triggers to your bot project or used a template that requires LUIS, you'll be able to see a required action for Set up Language Understanding in the Getting Started experience.
Once you initiate the LUIS setup process, you select the option for Generate instructions for Azure administrator and select Next. You'll then be given a screen that will allow you to copy and paste the instructions for your Azure Administrator to complete the process needed to provision your needed resources.
As an Azure Admin, you may be requested to create a LUIS resource for use with Composer. To complete these actions, you'll need to log on to the Azure portal and create a Language Understanding resource.
In Azure, search for Language Understanding.
Select Create and choose the Authoring option in the Create options selection.
Ensure that you complete the required items including the Subscription, Resource group, Name, Authoring location and Authoring pricing tier. Then select the Review + create button.
You'll then be provided with a summary screen that you'll need to verify what you've entered. Select Create.
Once the resource has been created you'll be presented with a confirmation screen and you'll need to select Go to resource. This will take you to the LUIS Authoring Service that was created.
Navigate in the Azure portal to the LUIS Authoring Service that was created above and collect the following information:
Go to Keys and Endpoints and select the Copy button next to the KEY 1.
Copy this key to a secure location that you plan to share with your requestor. This is secure data and should be treated as such.
On the Keys and Endpoint screen also copy the Location.
Copy this to the same secure location as the key.
Now securely send this information back to the requestor of the resource.
Once you securely receive the response from your Azure administrator, you'll need to complete the following steps to ensure that your local development environment is setup for use in Composer.
- Navigate to the Configure tab on the left column and then select the tab called Development resources.
- Under Azure Language Understanding, you'll need to copy the LUIS authoring key your administrator provided and select the region that was provided.
This should remove the required item from the Getting Started experience and will also remove the errors warning that your LUIS configuration wasn't complete.
Be aware that there's a limit to the number of queries that you can run per month using only an Authoring key. If you happen to get a 403 error warning that you're out of quota for the month, you can publish your bot to a publishing profile to allow for more queries to be run.