Prediction - Get Slot Prediction

Başvuru

Service:: Cognitive Services - LUIS

API Version:: 3.0

Bir uygulama yuvası için tahminleri alır.

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 Parametreleri

Name	İçinde	Gerekli	Tür	Description
appId	path	True	string uuid	Uygulama kimliği.
Endpoint	path	True	string	Desteklenen Bilişsel Hizmetler uç noktaları (protokol ve ana bilgisayar adı, örneğin: https://westus.api.cognitive.microsoft.com).
slotName	path	True	string	Uygulama yuvası adı.
log	query		boolean	Uç nokta sorgusunun günlüğe kaydedilip kaydedilmeyeceğini gösterir.
show-all-intents	query		boolean	Yanıttaki tüm amaçların mı yoksa yalnızca en üstteki amacın mı döndürüleceği belirtir.
verbose	query		boolean	Varlık tahminleri için ek meta verilerin alınıp alınmayacağını gösterir.

İstek Başlığı

Name	Gerekli	Tür	Description
Ocp-Apim-Subscription-Key	True	string

İstek Gövdesi

Name	Gerekli	Tür	Description
query	True	string	Tahmin etmek için sorgu.
dynamicLists		DynamicList[]	Bu istek için dinamik olarak oluşturulan liste varlıkları.
externalEntities		ExternalEntity[]	Bu istek için dışarıdan tahmin edilen varlıklar.
options		PredictionRequestOptions	Bu istek için tanımlanan özel seçenekler.

Yanıtlar

Name	Tür	Description
200 OK	PredictionResponse	Sağlanan sorgu için tahmin.
Other Status Codes	Error	Beklenmeyen hata.

Güvenlik

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Örnekler

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

Tanımlar

Name	Description
DynamicList	Liste varlığı için bir uzantı tanımlar.
Error	Oluşan hatayı temsil eder.
ErrorBody	Oluşan hatanın tanımını temsil eder.
ExternalEntity	Zaten var olan bir varlığı genişleten, kullanıcı tarafından tahmin edilen bir varlığı tanımlar.
Intent	Amaç tahminini temsil eder.
Prediction	Sorgunun tahminini temsil eder.
PredictionRequest	Tahmin isteği parametrelerini temsil eder.
PredictionRequestOptions	Tahmin isteği için özel seçenekler.
PredictionResponse	Tahmin yanıtını temsil eder.
RequestList	Var olan bir liste varlığına eklenecek bir alt liste tanımlar.
Sentiment	Yaklaşım analizinin sonucu.

DynamicList

Liste varlığı için bir uzantı tanımlar.

Name	Tür	Description
listEntityName	string	Genişletecek liste varlığının adı.
requestLists	RequestList[]	Genişletilmiş liste varlığına eklenecek listeler.

Error

Oluşan hatayı temsil eder.

Name	Tür	Description
error	ErrorBody	Oluşan hatanın tanımını temsil eder.

ErrorBody

Oluşan hatanın tanımını temsil eder.

Name	Tür	Description
code	string	Hata kodu.
message	string	Hata iletisi.

ExternalEntity

Zaten var olan bir varlığı genişleten, kullanıcı tarafından tahmin edilen bir varlığı tanımlar.

Name	Tür	Description
entityLength	integer	Tahmin edilen varlığın uzunluğu.
entityName	string	Genişletecek varlığın adı.
resolution		Kullanıcı, varlığın tahmini olarak döndürülecek özel çözüm sağladı.
score	number	Kullanıcı tarafından sağlanan puan, varlığın tahmin puanı olarak döndürülecek.
startIndex	integer	Tahmin edilen varlığın başlangıç karakteri dizini.

Intent

Amaç tahminini temsil eder.

Name	Tür	Description
childApp	Prediction	Dağıtılan uygulamanın tahmini.
score	number	Ateşlenen amacın puanı.

Prediction

Sorgunun tahminini temsil eder.

Name	Tür	Description
alteredQuery	string	Yazım denetiminden sonraki sorgu. Yalnızca yazım denetimi etkinleştirildiğinde ve yazım hatası bulunduğunda ayarlanır.
entities		Tetiklenen varlıkları temsil eden bir sözlük.
intents	<string, Intent>	Tetiklenen amaçları temsil eden bir sözlük.
sentiment	Sentiment	Yaklaşım analizinin sonucu.
topIntent	string	En çok puan alan amacın adı.

PredictionRequest

Tahmin isteği parametrelerini temsil eder.

Name	Tür	Description
dynamicLists	DynamicList[]	Bu istek için dinamik olarak oluşturulan liste varlıkları.
externalEntities	ExternalEntity[]	Bu istek için dışarıdan tahmin edilen varlıklar.
options	PredictionRequestOptions	Bu istek için tanımlanan özel seçenekler.
query	string	Tahmin etmek için sorgu.

PredictionRequestOptions

Tahmin isteği için özel seçenekler.

Name	Tür	Description
datetimeReference	string	Datetime varlıklarını tahmin etmek için kullanılan DateTime başvurusu.
preferExternalEntities	boolean	Dış varlıkların çözümlemesinin yapılıp yapılmaydığı, çakışma oluşursa tahminleri geçersiz kılar.

PredictionResponse

Tahmin yanıtını temsil eder.

Name	Tür	Description
prediction	Prediction	İstenen sorgunun tahmini.
query	string	Tahminde kullanılan sorgu.

RequestList

Var olan bir liste varlığına eklenecek bir alt liste tanımlar.

Name	Tür	Description
canonicalForm	string	Alt listenin kurallı biçimi.
name	string	Alt listenin adı.
synonyms	string[]	Kurallı formun eş anlamlıları.

Sentiment

Yaklaşım analizinin sonucu.

Name	Tür	Description
label	string	Yaklaşım analizi sonucunun etiketi.
score	number	Sorgunun yaklaşım puanı.