Condividi tramite

Prediction - Get Slot Prediction

  • Riferimento
Servizio:
Azure AI Services
Versione API:
3.0

Ottiene le stime per uno slot dell'applicazione.

POST {Endpoint}/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict
Con parametri facoltativi: 
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

Tipo: apiKey
In: header

Esempio

Successful Get Slot Predictions From Endpoint Via Post request

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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 delle 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 sottoelenca da accodare a un'entità elenco esistente.
Sentiment

Risultato dell'analisi del sentiment.

DynamicList

Object

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

Object

Rappresenta l'errore che si è verificato.

Nome Tipo Descrizione
error

ErrorBody

Rappresenta la definizione dell'errore che si è verificato.

ErrorBody

Object

Rappresenta la definizione dell'errore che si è verificato.

Nome Tipo Descrizione
code

string

Codice di errore.
message

string

Messaggio di errore.

ExternalEntity

Object

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

Nome Tipo Descrizione
entityLength

integer (int32)

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 (float)

Un utente ha fornito un punteggio da restituire come punteggio di stima dell'entità.
startIndex

integer (int32)

Indice dei caratteri iniziale dell'entità stimata.

Intent

Object

Rappresenta una stima delle finalità.

Nome Tipo Descrizione
childApp

Prediction

Stima dell'applicazione inviata.
score

number (float)

Punteggio della finalità attivata.

Prediction

Object

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

Object

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

Object

Opzioni personalizzate per la richiesta di stima.

Nome Tipo Descrizione
datetimeReference

string (date-time)

Valore DateTime di riferimento usato per la stima delle entità datetime.
preferExternalEntities

boolean

Indica se eseguire la risoluzione delle entità esterne eseguire l'override delle stime in caso di sovrapposizione.

PredictionResponse

Object

Rappresenta la risposta di stima.

Nome Tipo Descrizione
prediction

Prediction

Stima della query richiesta.
query

string

Query utilizzata nella stima.

RequestList

Object

Definisce un sottoelenca da accodare 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

Object

Risultato dell'analisi del sentiment.

Nome Tipo Descrizione
label

string

Etichetta del risultato dell'analisi del sentiment.
score

number (float)

Punteggio del sentiment della query.