Prediction - Get Slot Prediction

Referencia

Service:: Cognitive Services - LUIS

API Version:: 3.0

Lekéri az alkalmazáshelyre vonatkozó előrejelzéseket.

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}

URI-paraméterek

Name	In	Kötelező	Típus	Description
appId	path	True	string uuid	Az alkalmazás azonosítója.
Endpoint	path	True	string	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://westus.api.cognitive.microsoft.com).
slotName	path	True	string	Az alkalmazáshely neve.
log	query		boolean	Azt jelzi, hogy naplózza-e a végpontlekérdezéseket.
show-all-intents	query		boolean	Azt jelzi, hogy a válaszban szereplő összes szándékot vagy csak a legfelső szándékot szeretné-e visszaadni.
verbose	query		boolean	Azt jelzi, hogy szeretne-e további metaadatokat lekérni az entitások előrejelzéseihez, vagy sem.

Kérelem fejléce

Name	Kötelező	Típus	Description
Ocp-Apim-Subscription-Key	True	string

Kérelem törzse

Name	Kötelező	Típus	Description
query	True	string	Az előrejelzendő lekérdezés.
dynamicLists		DynamicList[]	A kérelemhez dinamikusan létrehozott listaentitások.
externalEntities		ExternalEntity[]	A kérés külsőleg előrejelzett entitásai.
options		PredictionRequestOptions	A kérelemhez definiált egyéni beállítások.

Válaszok

Name	Típus	Description
200 OK	PredictionResponse	A megadott lekérdezés előrejelzése.
Other Status Codes	Error	Váratlan hiba.

Biztonság

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Példák

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

Definíciók

Name	Description
DynamicList	Egy listaentitás bővítményét definiálja.
Error	A bekövetkezett hibát jelöli.
ErrorBody	A bekövetkezett hiba definícióját jelöli.
ExternalEntity	Definiál egy felhasználó által előrejelzett entitást, amely kiterjeszt egy már meglévő entitást.
Intent	Szándék-előrejelzést jelöl.
Prediction	Egy lekérdezés előrejelzését jelöli.
PredictionRequest	Az előrejelzési kérelem paramétereit jelöli.
PredictionRequestOptions	Az előrejelzési kérelem egyéni beállításai.
PredictionResponse	Az előrejelzési választ jelöli.
RequestList	Egy meglévő listaentitáshoz hozzáfűzendő allistát definiál.
Sentiment	A hangulatelemzés eredménye.

DynamicList

Egy listaentitás bővítményét definiálja.

Name	Típus	Description
listEntityName	string	A kibővítendő listaentitás neve.
requestLists	RequestList[]	A kiterjesztett listaentitáshoz hozzáfűzendő listák.

Error

A bekövetkezett hibát jelöli.

Name	Típus	Description
error	ErrorBody	A bekövetkezett hiba definícióját jelöli.

ErrorBody

A bekövetkezett hiba definícióját jelöli.

Name	Típus	Description
code	string	A hibakód.
message	string	A hibaüzenet.

ExternalEntity

Definiál egy felhasználó által előrejelzett entitást, amely kiterjeszt egy már meglévő entitást.

Name	Típus	Description
entityLength	integer	Az előrejelzett entitás hossza.
entityName	string	A kiterjesztendő entitás neve.
resolution		A felhasználó egyéni felbontást adott meg, hogy az entitás előrejelzéseként visszatérjen.
score	number	Egy felhasználó adott vissza pontszámot az entitás előrejelzési pontszámaként.
startIndex	integer	Az előrejelzett entitás kezdő karakterindexe.

Intent

Szándék-előrejelzést jelöl.

Name	Típus	Description
childApp	Prediction	A kézbesített alkalmazás előrejelzése.
score	number	Az aktivált szándék pontszáma.

Prediction

Egy lekérdezés előrejelzését jelöli.

Name	Típus	Description
alteredQuery	string	A lekérdezés helyesírás-ellenőrzés után. Csak akkor állítsa be, ha a helyesírás-ellenőrzés engedélyezve van, és helyesírási hiba történt.
entities		Az aktivált entitásokat jelölő szótár.
intents	<string, Intent>	Az aktivált szándékokat jelölő szótár.
sentiment	Sentiment	A hangulatelemzés eredménye.
topIntent	string	A legfelső pontozási szándék neve.

PredictionRequest

Az előrejelzési kérelem paramétereit jelöli.

Name	Típus	Description
dynamicLists	DynamicList[]	A kérelemhez dinamikusan létrehozott listaentitások.
externalEntities	ExternalEntity[]	A kérés külsőleg előrejelzett entitásai.
options	PredictionRequestOptions	A kérelemhez definiált egyéni beállítások.
query	string	Az előrejelzendő lekérdezés.

PredictionRequestOptions

Az előrejelzési kérelem egyéni beállításai.

Name	Típus	Description
datetimeReference	string	A datetime entitások előrejelzéséhez használt dateTime referencia.
preferExternalEntities	boolean	Azt határozza meg, hogy a külső entitások feloldása felülbírálja-e az előrejelzéseket, ha átfedés történik.

PredictionResponse

Az előrejelzési választ jelöli.

Name	Típus	Description
prediction	Prediction	A kért lekérdezés előrejelzése.
query	string	Az előrejelzésben használt lekérdezés.

RequestList

Egy meglévő listaentitáshoz hozzáfűzendő allistát definiál.

Name	Típus	Description
canonicalForm	string	Az allista canonical formája.
name	string	Az allista neve.
synonyms	string[]	A canonical form szinonimái.

Sentiment

A hangulatelemzés eredménye.

Name	Típus	Description
label	string	A hangulatelemzés eredményének címkéje.
score	number	A lekérdezés hangulati pontszáma.