Prediction - Get Slot Prediction

Riferimento

Service:: Cognitive Services - LUIS

API Version:: 3.0

Ottiene le stime per uno slot dell'applicazione.

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

With optional parameters:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
appId	path	True	string uuid	ID applicazione.
Endpoint	path	True	string	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com).
slotName	path	True	string	Nome dello slot dell'applicazione.
log	query		boolean	Indica se registrare o meno la query dell'endpoint.
show-all-intents	query		boolean	Indica se restituire tutte le finalità nella risposta o solo la finalità superiore.
verbose	query		boolean	Indica se ottenere o meno metadati aggiuntivi per le stime delle entità.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Ocp-Apim-Subscription-Key	True	string

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
query	True	string	Query da stimare.
dynamicLists		DynamicList[]	Entità elenco create dinamicamente per questa richiesta.
externalEntities		ExternalEntity[]	Entità stimate esternamente per questa richiesta.
options		PredictionRequestOptions	Opzioni personalizzate definite per questa richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	PredictionResponse	Stima per la query fornita.
Other Status Codes	Error	Errore imprevisto.

Sicurezza

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Esempio

Successful Get Slot Predictions From Endpoint Via Post request

Sample Request

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": []
        }
      ]
    }
  ]
}

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
    }
  }
}

Definizioni

Nome	Descrizione
DynamicList	Definisce un'estensione per un'entità elenco.
Error	Rappresenta l'errore che si è verificato.
ErrorBody	Rappresenta la definizione dell'errore che si è verificato.
ExternalEntity	Definisce un'entità stimata dall'utente che estende un'entità già esistente.
Intent	Rappresenta una stima della finalità.
Prediction	Rappresenta la stima di una query.
PredictionRequest	Rappresenta i parametri della richiesta di stima.
PredictionRequestOptions	Opzioni personalizzate per la richiesta di stima.
PredictionResponse	Rappresenta la risposta di stima.
RequestList	Definisce un sottoelenno da aggiungere a un'entità elenco esistente.
Sentiment	Risultato dell'analisi del sentiment.

DynamicList

Definisce un'estensione per un'entità elenco.

Nome	Tipo	Descrizione
listEntityName	string	Nome dell'entità elenco da estendere.
requestLists	RequestList[]	Elenchi da aggiungere all'entità elenco estesa.

Error

Rappresenta l'errore che si è verificato.

Nome	Tipo	Descrizione
error	ErrorBody	Rappresenta la definizione dell'errore che si è verificato.

ErrorBody

Rappresenta la definizione dell'errore che si è verificato.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.

ExternalEntity

Definisce un'entità stimata dall'utente che estende un'entità già esistente.

Nome	Tipo	Descrizione
entityLength	integer	Lunghezza dell'entità stimata.
entityName	string	Nome dell'entità da estendere.
resolution		Un utente ha fornito una risoluzione personalizzata da restituire come stima dell'entità.
score	number	Un utente ha fornito un punteggio da restituire come punteggio di stima dell'entità.
startIndex	integer	Indice dei caratteri iniziale dell'entità stimata.

Intent

Rappresenta una stima della finalità.

Nome	Tipo	Descrizione
childApp	Prediction	Stima dell'applicazione inviata.
score	number	Punteggio della finalità attivata.

Prediction

Rappresenta la stima di una query.

Nome	Tipo	Descrizione
alteredQuery	string	Query dopo il controllo ortografico. Impostare solo se il controllo ortografico è stato abilitato e è stato trovato un errore di ortografia.
entities		Dizionario che rappresenta le entità attivate.
intents	<string, Intent>	Dizionario che rappresenta le finalità attivate.
sentiment	Sentiment	Risultato dell'analisi del sentiment.
topIntent	string	Nome della finalità di punteggio superiore.

PredictionRequest

Rappresenta i parametri della richiesta di stima.

Nome	Tipo	Descrizione
dynamicLists	DynamicList[]	Entità elenco create dinamicamente per questa richiesta.
externalEntities	ExternalEntity[]	Entità stimate esternamente per questa richiesta.
options	PredictionRequestOptions	Opzioni personalizzate definite per questa richiesta.
query	string	Query da stimare.

PredictionRequestOptions

Opzioni personalizzate per la richiesta di stima.

Nome	Tipo	Descrizione
datetimeReference	string	Valore DateTime di riferimento usato per la stima delle entità datetime.
preferExternalEntities	boolean	Se eseguire la risoluzione delle entità esterne, eseguire l'override delle stime in caso di sovrapposizione.

PredictionResponse

Rappresenta la risposta di stima.

Nome	Tipo	Descrizione
prediction	Prediction	Stima della query richiesta.
query	string	Query utilizzata nella stima.

RequestList

Definisce un sottoelenno da aggiungere a un'entità elenco esistente.

Nome	Tipo	Descrizione
canonicalForm	string	Forma canonica dell'elenco secondario.
name	string	Nome dell'elenco secondario.
synonyms	string[]	Sinonimi della forma canonica.

Sentiment

Risultato dell'analisi del sentiment.

Nome	Tipo	Descrizione
label	string	Etichetta del risultato dell'analisi del sentiment.
score	number	Punteggio del sentiment della query.