Prediction - Get Slot Prediction

Reference

Service:: Cognitive Services - LUIS

API Version:: 3.0

Získá předpovědi pro slot aplikace.

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}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
appId	path	True	string uuid	ID aplikace.
Endpoint	path	True	string	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://westus.api.cognitive.microsoft.com).
slotName	path	True	string	Název slotu aplikace.
log	query		boolean	Určuje, jestli se má dotaz koncového bodu protokolovat, nebo ne.
show-all-intents	query		boolean	Určuje, jestli se mají vrátit všechny záměry v odpovědi, nebo jenom záměr s nejvyšším využitím.
verbose	query		boolean	Určuje, jestli se mají získat další metadata pro predikce entit, nebo ne.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
Ocp-Apim-Subscription-Key	True	string

Text požadavku

Name	Vyžadováno	Typ	Description
query	True	string	Dotaz, který chcete předpovědět.
dynamicLists		DynamicList[]	Dynamicky vytvořené entity seznamu pro tento požadavek.
externalEntities		ExternalEntity[]	Externě předpovězené entity pro tento požadavek
options		PredictionRequestOptions	Vlastní možnosti definované pro tento požadavek.

Odpovědi

Name	Typ	Description
200 OK	PredictionResponse	Predikce pro zadaný dotaz.
Other Status Codes	Error	Neočekávaná chyba.

Zabezpečení

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Příklady

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

Definice

Name	Description
DynamicList	Definuje rozšíření pro entitu seznamu.
Error	Představuje chybu, ke které došlo.
ErrorBody	Představuje definici chyby, ke které došlo.
ExternalEntity	Definuje entitu predikovanou uživatelem, která rozšiřuje již existující entitu.
Intent	Představuje předpověď záměru.
Prediction	Představuje předpověď dotazu.
PredictionRequest	Představuje parametry predikce požadavku.
PredictionRequestOptions	Vlastní možnosti pro žádost o predikci
PredictionResponse	Představuje predikční odpověď.
RequestList	Definuje dílčí seznam, který se připojí k existující entitě seznamu.
Sentiment	Výsledek analýzy mínění.

DynamicList

Definuje rozšíření pro entitu seznamu.

Name	Typ	Description
listEntityName	string	Název entity seznamu, která se má rozšířit.
requestLists	RequestList[]	Seznamy, které se mají připojit k entitě rozšířeného seznamu.

Error

Představuje chybu, ke které došlo.

Name	Typ	Description
error	ErrorBody	Představuje definici chyby, ke které došlo.

ErrorBody

Představuje definici chyby, ke které došlo.

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva

ExternalEntity

Definuje entitu predikovanou uživatelem, která rozšiřuje již existující entitu.

Name	Typ	Description
entityLength	integer	Délka předpovězené entity
entityName	string	Název entity, která se má rozšířit.
resolution		Uživatel zadal vlastní rozlišení, které se má vrátit jako predikce entity.
score	number	Uživatel zadal skóre, které se má vrátit jako skóre předpovědi entity.
startIndex	integer	Index počátečního znaku předpovězené entity.

Intent

Představuje předpověď záměru.

Name	Typ	Description
childApp	Prediction	Predikce odeslané aplikace.
score	number	Skóre aktivovaného záměru.

Prediction

Představuje předpověď dotazu.

Name	Typ	Description
alteredQuery	string	Dotaz po kontrole pravopisu. Nastavte pouze v případě, že byla povolena kontrola pravopisu a byla nalezena pravopisná chyba.
entities		Slovník představující entity, které se aktivovaly.
intents	<string, Intent>	Slovník představující záměry, které se aktivovaly.
sentiment	Sentiment	Výsledek analýzy mínění.
topIntent	string	Název záměru s nejvyšším skóre.

PredictionRequest

Představuje parametry predikce požadavku.

Name	Typ	Description
dynamicLists	DynamicList[]	Dynamicky vytvořené entity seznamu pro tento požadavek.
externalEntities	ExternalEntity[]	Externě předpovězené entity pro tento požadavek
options	PredictionRequestOptions	Vlastní možnosti definované pro tento požadavek.
query	string	Dotaz, který chcete předpovědět.

PredictionRequestOptions

Vlastní možnosti pro žádost o predikci

Name	Typ	Description
datetimeReference	string	Referenční hodnota DateTime používaná k predikci entit data a času.
preferExternalEntities	boolean	Určuje, jestli má rozlišení externích entit přepsat predikce, pokud dojde k překrytí.

PredictionResponse

Představuje predikční odpověď.

Name	Typ	Description
prediction	Prediction	Předpověď požadovaného dotazu.
query	string	Dotaz použitý v predikci

RequestList

Definuje dílčí seznam, který se připojí k existující entitě seznamu.

Name	Typ	Description
canonicalForm	string	Kanonický tvar dílčího seznamu.
name	string	Název dílčího seznamu.
synonyms	string[]	Synonyma kanonického tvaru.

Sentiment

Výsledek analýzy mínění.

Name	Typ	Description
label	string	Popisek výsledku analýzy mínění.
score	number	Skóre mínění dotazu.

Sdílet prostřednictvím