You can use the Microsoft LUIS NLU Connector to connect to Microsoft LUIS
and use the language understanding results from this service to power the NLU
of agents within Cognigy.AI. This guide covers the necessary prerequisites for setting up the LUIS NLU Connector, and how to connect a LUIS app to a LUIS NLU Connector in Cognigy.AI.

Requirements

You'll need the following credential to successfully connect to a Microsoft LUIS service from Cognigy.AI:

• • Location (e.g. westus2)
  • Subscription Key
  • App ID

Setup

This section describes the necessary steps for setting up a LUIS NLU Connector.

1. Create and publish a Microsoft LUIS app

🔗 In Microsoft LUIS

In order to use the LUIS NLU Connector, a working LUIS app is required. To setup a new app, refer to the guides from the Microsoft LUIS Documentation listed below:

• Create a new app
• Add entities
• Add intents
• Publish your app

2. Retrieve the Authentication Parameters

🔗 In Microsoft LUIS

In order for the NLU Connector to connect to the LUIS app, it needs an authentication URL, the details for which can be found in the LUIS app.

In the LUIS app, navigate to `Manage > Azure Resources` to view the prediction resource parameters. Retrieve the following parameters:

• Location (e.g. westus2)
• Subscription Key (Primary or Secondary)

Navigate to `Manage > Settings` to view the retrieve the following parameter:

• App ID

These three credentials are required to build the Authentication URL that will be used by Cognigy.AI to call you LUIS app.

If the prediction resource parameters are not show in the Azure Resources menu (available initially with a trial account), you will need to create a prediction resource, in line with your Microsoft subscription, that enables communication to Microsoft LUIS from a third party service. Find out how to add a prediction resource in the Microsoft Documentation. 

3. Connect the MS LUIS NLU Connector

🔗 In Cognigy.AI

The last step is to create and configure a LUIS NLU Connector on the Cognigy.AI platform.

In Cognigy.AI, navigate to the NLU connectors menu found under the Build sub-menu in the resources panel. Create a new NLU Connector of type LUIS. 

The NLU connector settings will be opened automatically (you can open the settings again by clicking on the NLU connector). 

Paste the below URL into the `Authentication URL` field in the `LUIS Settings`of the NLU Connector and substitute the parameters retrieved in the previous step.

https://{location}.api.cognitive.microsoft.com/luis/v2.0/apps/{appId}?subscription-key={subscriptionKey}&q=

4. Test your NLU Connector

🔗 In Cognigy.AI

Open the interaction panel from the top right of the interface. Select settings, then select the LUIS NLU connector you just created from the NLU Connector dropdown menu. Additionally, enable Expert Mode to get a summary of the intent mapping printed to the chat window.

Now select the chat tab and type a message to your bot that was one of the example sentences you used for intent creation in the LUIS app. If the connection is successful, you will see an orange box showing the name of the LUIS intent that you configured in your LUIS app.

Congratulations, you have successfully connected Microsoft LUIS as the NLU service for Cognigy.AI!