Prediction - Get Slot Prediction

Referência

Serviço:: Azure AI Services

Versão da API:: 3.0

Obtém as previsões para um slot de aplicativo.

POST {Endpoint}/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict

Com parâmetros opcionais:

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
appId	path	True	string (uuid)	O ID do aplicativo.
Endpoint	path	True	string	Pontos de extremidade de Serviços Cognitivos suportados (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).
slotName	path	True	string	O nome do slot do aplicativo.
log	query		boolean	Indica se a consulta de ponto de extremidade deve ser registrada ou não.
show-all-intents	query		boolean	Indica se todas as intenções na resposta devem ser retornadas ou apenas a intenção principal.
verbose	query		boolean	Indica se os metadados extras devem ser obtidos para as previsões das entidades ou não.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Corpo do Pedido

Name	Necessário	Tipo	Description
query	True	string	A consulta a ser prevista.
dynamicLists		DynamicList[]	As entidades de lista criadas dinamicamente para essa solicitação.
externalEntities		ExternalEntity[]	As entidades previstas externamente para esta solicitação.
options		PredictionRequestOptions	As opções personalizadas definidas para esta solicitação.

Respostas

Name	Tipo	Description
200 OK	PredictionResponse	A previsão para a consulta fornecida.
Other Status Codes	Error	Erro inesperado.

Segurança

Ocp-Apim-Subscription-Key

Tipo: apiKey
Em: header

Exemplos

Successful Get Slot Predictions From Endpoint Via Post request

Pedido de amostra

HTTP

POST {Endpoint}/luis/prediction/v3.0/apps/{Application Id}/slots/{Slot Name}/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": []
        }
      ]
    }
  ]
}

Resposta da amostra

Código de estado:: 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
    }
  }
}

Definições

Name	Description
DynamicList	Define uma extensão para uma entidade de lista.
Error	Representa o erro que ocorreu.
ErrorBody	Representa a definição do erro que ocorreu.
ExternalEntity	Define uma entidade prevista pelo usuário que estende uma entidade já existente.
Intent	Representa uma previsão de intenção.
Prediction	Representa a previsão de uma consulta.
PredictionRequest	Representa os parâmetros da solicitação de previsão.
PredictionRequestOptions	As opções personalizadas para a solicitação de previsão.
PredictionResponse	Representa a resposta de previsão.
RequestList	Define uma sublista a ser anexada a uma entidade de lista existente.
Sentiment	O resultado da análise de sentimento.

DynamicList

Object

Define uma extensão para uma entidade de lista.

Name	Tipo	Description
listEntityName	string	O nome da entidade de lista a ser estendida.
requestLists	RequestList[]	As listas a serem anexadas na entidade de lista estendida.

Error

Object

Representa o erro que ocorreu.

Name	Tipo	Description
error	ErrorBody	Representa a definição do erro que ocorreu.

ErrorBody

Object

Representa a definição do erro que ocorreu.

Name	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.

ExternalEntity

Object

Define uma entidade prevista pelo usuário que estende uma entidade já existente.

Name	Tipo	Description
entityLength	integer (int32)	O comprimento da entidade prevista.
entityName	string	O nome da entidade a ser estendida.
resolution		Um usuário forneceu resolução personalizada para retornar como previsão da entidade.
score	number (float)	Um usuário forneceu pontuação para retornar como a pontuação de previsão da entidade.
startIndex	integer (int32)	O índice de caracteres iniciais da entidade prevista.

Intent

Object

Representa uma previsão de intenção.

Name	Tipo	Description
childApp	Prediction	A previsão do aplicativo despachado.
score	number (float)	O placar da intenção disparada.

Prediction

Object

Representa a previsão de uma consulta.

Name	Tipo	Description
alteredQuery	string	A consulta após a verificação ortográfica. Defina apenas se a verificação ortográfica estiver ativada e tiver sido detetado um erro ortográfico.
entities		Um dicionário que representa as entidades que dispararam.
intents	<string, Intent>	Um dicionário que representa as intenções que dispararam.
sentiment	Sentiment	O resultado da análise de sentimento.
topIntent	string	O nome da intenção de pontuação máxima.

PredictionRequest

Object

Representa os parâmetros da solicitação de previsão.

Name	Tipo	Description
dynamicLists	DynamicList[]	As entidades de lista criadas dinamicamente para essa solicitação.
externalEntities	ExternalEntity[]	As entidades previstas externamente para esta solicitação.
options	PredictionRequestOptions	As opções personalizadas definidas para esta solicitação.
query	string	A consulta a ser prevista.

PredictionRequestOptions

Object

As opções personalizadas para a solicitação de previsão.

Name	Tipo	Description
datetimeReference	string (date-time)	A referência DateTime usada para prever entidades datetime.
preferExternalEntities	boolean	Se a resolução de entidades externas deve substituir as previsões se ocorrer uma sobreposição.

PredictionResponse

Object

Representa a resposta de previsão.

Name	Tipo	Description
prediction	Prediction	A previsão da consulta solicitada.
query	string	A consulta usada na previsão.

RequestList

Object

Define uma sublista a ser anexada a uma entidade de lista existente.

Name	Tipo	Description
canonicalForm	string	A forma canónica da sublista.
name	string	O nome da sublista.
synonyms	string[]	Os sinônimos da forma canônica.

Sentiment

Object

O resultado da análise de sentimento.

Name	Tipo	Description
label	string	O rótulo do resultado da análise de sentimento.
score	number (float)	A pontuação de sentimento da consulta.

O futuro é seu

Partilhar via

Prediction - Get Slot Prediction

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Segurança

Ocp-Apim-Subscription-Key

Exemplos

Successful Get Slot Predictions From Endpoint Via Post request

Pedido de amostra

Resposta da amostra

Definições

DynamicList

Error

ErrorBody

ExternalEntity

Intent

Prediction

PredictionRequest

PredictionRequestOptions

PredictionResponse

RequestList

Sentiment

Recursos adicionais