> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cognigy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft LUIS

The Microsoft LUIS NLU connector enables integration with [Microsoft LUIS](https://www.luis.ai/) to use its language understanding results for powering AI Agents in Cognigy.AI.

## Prerequisites

* Access to Microsoft LUIS.

## Configuration on the NLU Provider Side

1. Set up a new LUIS app in the **Microsoft LUIS portal**, define intents, add entities, and train the model.
2. Go to **Manage > Azure Resources** in your LUIS app to find the required parameters:
   * **Location** — the Azure region where the LUIS service is hosted. For example, `westus2`.
   * **Subscription Key** — the key (Primary or Secondary key) can be found in **Manage > Azure Resources**.
   * **App ID** — the App ID can be found in **Manage > Settings** of the LUIS app.
3. Ensure the app is published in **production mode** for external services, such as Cognigy.AI, to access it.

## Configuration on the Cognigy.AI Side

1. In Cognigy.AI, go to **Build > NLU Connectors**, create a LUIS NLU connector.
2. Fill in the placeholders in the URL with the parameters you found in LUIS:

   ```txt theme={null}
   https://{location}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?subscription-key={subscriptionKey}&q=
   ```
3. Paste this URL into the **Authentication URL** field.

## Test your NLU Connector

By default, the Cognigy NLU connector is used in the Interaction Panel for testing purposes.
To change this behavior, open the **Settings** tab in the Interaction Panel, then select the configured connector from the **NLU Connector** list.

## Add your NLU Connector to Endpoint Settings

By default, the Cognigy NLU connector is used in the Endpoint.
To change this behavior, follow these steps:

1. Go to **Deploy > Endpoints**.
2. Select the desired Endpoint and open the Endpoint Settings.
3. Go to **Natural Language Understanding > NLU Connector** and select the configured connector.

## More Information

* [All NLU Connectors](/ai/platform-features/nlu/external/nlu-connector-reference/all-nlu-connectors)
* [Cognigy Help Center: Microsoft LUIS](https://support.cognigy.com/hc/en-us/articles/360017517319-Microsoft-LUIS-External-NLU)