LUIS
Azure cognitive services language understanding intelligent service (LUIS) lets you understand language contextually, so your apps communicate with people in the way they speak.
This connector is available in the following products and regions:
Service | Class | Regions |
---|---|---|
Logic Apps | Standard | All Logic Apps regions |
Power Automate | Standard | All Power Automate regions |
Power Apps | Standard | All Power Apps regions |
Connector Metadata | |
---|---|
Publisher | Microsoft |
Website | https://azure.microsoft.com/services/cognitive-services/language-understanding-intelligent-service/ |
The following are some known limitations of using the LUIS connector
- Dropdowns for App Id, App Version, Desired Intent and Desired Entity call authoring endpoints and hence require an authoring key to be used when creating a connection. In case of only an endpoint key being available, one must use "Enter custom value" to enter the corresponding parameter values.
The connector supports the following authentication types:
Default | Parameters for creating connection. | All regions | Shareable |
Applicable: All regions
Parameters for creating connection.
This is shareable connection. If the power app is shared with another user, connection is shared as well. For more information, please see the Connectors overview for canvas apps - Power Apps | Microsoft Docs
Name | Type | Description | Required |
---|---|---|---|
API Key | securestring | API Key | True |
Prediction endpoint | string | Prediction endpoint. If not specified, it will be defaulted to https://westus.api.cognitive.microsoft.com. |
Name | Calls | Renewal Period |
---|---|---|
API calls per connection | 1200 | 60 seconds |
Get entity by type |
For a given entity type, the operation returns the best matching entity model from the LUIS prediction object. |
Get prediction |
Given some input text, this operations returns a prediction based on a pre-trained model. The prediction object returned can also be used as input for other LUIS actions. |
For a given entity type, the operation returns the best matching entity model from the LUIS prediction object.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
App Id
|
app-id | True | string |
Id of the trained application |
Desired Entity
|
desiredEntity | True | string |
The Desired Entity. |
App version
|
versionId | string |
The version name. The value 0.1 will be used by default. |
|
luisPredictionObject
|
luisPredictionObject | True | string |
Returns
Given some input text, this operations returns a prediction based on a pre-trained model. The prediction object returned can also be used as input for other LUIS actions.
Parameters
Name | Key | Required | Type | Description |
---|---|---|---|---|
App Id
|
app-id | True | string |
Id of the trained application. |
Utterance Text
|
q | True | string |
String to predict |
Desired Intent
|
desiredIntent | string |
Desired top scoring intent |
|
App version
|
versionId | string |
The version name. The value 0.1 will be used by default. |
Returns
- Body
- PredictResponse
Name | Path | Type | Description |
---|---|---|---|
LUIS Prediction
|
luisPrediciton | string |
Used as input for other other LUIS actions. |
Is Desired Intent
|
isDesiredIntent | boolean |
True if the top scoring intent matches the desired intent. |
Desired Intent
|
desiredIntent | string |
Desired intent specified as input, if any. |
Utterance Text
|
query | string |
String that the prediction is based off. |
Name
|
topScoringIntent.intent | string |
Name of the intent model. |
Score
|
topScoringIntent.score | float |
Percent confidence of prediction. |
Intents Array
|
intents | array of object |
List of all predicted intents. |
Intent Name
|
intents.intent | string |
Name of the intent model. |
Intent Score
|
intents.score | float |
Percent confidence of prediction. |
Entities Array
|
entities | array of LuisPredictResponseEntity |
List of all predicted entities. |
Name | Path | Type | Description |
---|---|---|---|
Entity Value
|
entity | string |
Value of the corresponding entity type. |
Entity Type
|
type | string |
Name of the entity model. |
Entity Score
|
score | float |
Percent confidence of prediction. |
Name | Path | Type | Description |
---|---|---|---|
entity
|
entity | LuisPredictResponseEntityMinusType | |
entityMatchInfo
|
entityMatchInfo | EntityMatchInfo |
Name | Path | Type | Description |
---|---|---|---|
Entity Value
|
entity | string |
Value of the corresponding entity type. |
Entity Score
|
score | float |
Percent confidence of prediction. |
Entity Resolution
|
resolution | string |
The resolution of this entity. Only applies to built in entities. |
Name | Path | Type | Description |
---|---|---|---|
Desired Entity
|
desiredEntity | string |
Desired entity specified as input, if any. |
Is Entity Match
|
isEntityMatch | boolean |
True if the specific entity was found. |
Entity Match Count
|
entityMatchCount | integer |
Number of entities that match the desired entity type. |