Prediction - Get Version Prediction

Reference

Service:: Azure AI Services

API Version:: 3.0

Gets the predictions for an application version.

POST {Endpoint}/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict

With optional parameters:

POST {Endpoint}/luis/prediction/v3.0/apps/{appId}/versions/{versionId}/predict?verbose={verbose}&show-all-intents={show-all-intents}&log={log}

URI Parameters

Name	In	Required	Type	Description
appId	path	True	string uuid	The application ID.
Endpoint	path	True	string	Supported Cognitive Services endpoints (protocol and hostname, for example: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	The application version ID.
log	query		boolean	Indicates whether to log the endpoint query or not.
show-all-intents	query		boolean	Indicates whether to return all the intents in the response or just the top intent.
verbose	query		boolean	Indicates whether to get extra metadata for the entities predictions or not.

Request Header

Name	Required	Type	Description
Ocp-Apim-Subscription-Key	True	string

Request Body

Name	Required	Type	Description
query	True	string	The query to predict.
dynamicLists		DynamicList[]	The dynamically created list entities for this request.
externalEntities		ExternalEntity[]	The externally predicted entities for this request.
options		PredictionRequestOptions	The custom options defined for this request.

Responses

Name	Type	Description
200 OK	PredictionResponse	The prediction for the supplied query.
Other Status Codes	Error	Unexpected error.

Security

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Examples

Successful Get Version Predictions From Endpoint Via Post request

Sample request

HTTP

POST {Endpoint}/luis/prediction/v3.0/apps/{Application Id}/versions/{Version Id}/predict


{
  "query": "forward to frank 30 dollars through HSBC",
  "options": {
    "datetimeReference": "2015-02-13T13:15:00.000Z"
  },
  "externalEntities": [
    {
      "entityName": "Bank",
      "startIndex": 36,
      "entityLength": 4,
      "resolution": {
        "text": "International Bank"
      }
    }
  ],
  "dynamicLists": [
    {
      "listEntityName": "Employees",
      "requestLists": [
        {
          "name": "Management",
          "canonicalForm": "Frank",
          "synonyms": []
        }
      ]
    }
  ]
}

Sample response

Status code:: 200

{
  "query": "forward to frank 30 dollars through HSBC",
  "prediction": {
    "topIntent": "give",
    "intents": {
      "give": {
        "score": 0.943442
      }
    },
    "entities": {
      "Employees": [
        [
          "frank"
        ]
      ],
      "number": [
        30
      ],
      "money": [
        {
          "units": "Dollar",
          "value": 30
        }
      ],
      "Bank": [
        {
          "text": "International Bank"
        }
      ]
    },
    "sentiment": {
      "label": "positive",
      "score": 0.9163064
    }
  }
}

Definitions

Name	Description
DynamicList	Defines an extension for a list entity.
Error	Represents the error that occurred.
ErrorBody	Represents the definition of the error that occurred.
ExternalEntity	Defines a user predicted entity that extends an already existing one.
Intent	Represents an intent prediction.
Prediction	Represents the prediction of a query.
PredictionRequest	Represents the prediction request parameters.
PredictionRequestOptions	The custom options for the prediction request.
PredictionResponse	Represents the prediction response.
RequestList	Defines a sub-list to append to an existing list entity.
Sentiment	The result of the sentiment analysis.

DynamicList

Defines an extension for a list entity.

Name	Type	Description
listEntityName	string	The name of the list entity to extend.
requestLists	RequestList[]	The lists to append on the extended list entity.

Error

Represents the error that occurred.

Name	Type	Description
error	ErrorBody	Represents the definition of the error that occurred.

ErrorBody

Represents the definition of the error that occurred.

Name	Type	Description
code	string	The error code.
message	string	The error message.

ExternalEntity

Defines a user predicted entity that extends an already existing one.

Name	Type	Description
entityLength	integer	The length of the predicted entity.
entityName	string	The name of the entity to extend.
resolution		A user supplied custom resolution to return as the entity's prediction.
score	number	A user supplied score to return as the entity's prediction score.
startIndex	integer	The start character index of the predicted entity.

Intent

Represents an intent prediction.

Name	Type	Description
childApp	Prediction	The prediction of the dispatched application.
score	number	The score of the fired intent.

Prediction

Represents the prediction of a query.

Name	Type	Description
alteredQuery	string	The query after spell checking. Only set if spell check was enabled and a spelling mistake was found.
entities		A dictionary representing the entities that fired.
intents	<string, Intent>	A dictionary representing the intents that fired.
sentiment	Sentiment	The result of the sentiment analysis.
topIntent	string	The name of the top scoring intent.

PredictionRequest

Represents the prediction request parameters.

Name	Type	Description
dynamicLists	DynamicList[]	The dynamically created list entities for this request.
externalEntities	ExternalEntity[]	The externally predicted entities for this request.
options	PredictionRequestOptions	The custom options defined for this request.
query	string	The query to predict.

PredictionRequestOptions

The custom options for the prediction request.

Name	Type	Description
datetimeReference	string	The reference DateTime used for predicting datetime entities.
preferExternalEntities	boolean	Whether to make the external entities resolution override the predictions if an overlap occurs.

PredictionResponse

Represents the prediction response.

Name	Type	Description
prediction	Prediction	The prediction of the requested query.
query	string	The query used in the prediction.

RequestList

Defines a sub-list to append to an existing list entity.

Name	Type	Description
canonicalForm	string	The canonical form of the sub-list.
name	string	The name of the sub-list.
synonyms	string[]	The synonyms of the canonical form.

Sentiment

The result of the sentiment analysis.

Name	Type	Description
label	string	The label of the sentiment analysis result.
score	number	The sentiment score of the query.

Compartilhar via