Megosztás a következőn keresztül:

Prediction - Get Slot Prediction

  • Referencia
Szolgáltatás:
Azure AI Services
API-verzió:
3.0

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

POST {Endpoint}/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict
Opcionális paraméterekkel: 
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ás pontjának 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 vissza szeretné-e adni, vagy csak a legfelső szándékot.
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őrejelezendő lekérdezés.
dynamicLists

DynamicList[]

A kérelem dinamikusan létrehozott listaentitásai.
externalEntities

ExternalEntity[]

A kérés külsőleg előrejelzett entitásai.
options

PredictionRequestOptions

A kéréshez 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

Típus: apiKey
In: header

Példák

Successful Get Slot Predictions From Endpoint Via Post request

Mintakérelem

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

Mintaválasz

Állapotkód:
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 határozza meg.
Error

A bekövetkezett hibát jelöli.
ErrorBody

A 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őt.
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 határoz meg.
Sentiment

A hangulatelemzés eredménye.

DynamicList

Objektum

Egy listaentitás bővítményét határozza meg.

Name Típus Description
listEntityName

string

A kibővítendő lista entitás neve.
requestLists

RequestList[]

A kiterjesztett lista entitáshoz hozzáfűzendő listák.

Error

Objektum

A bekövetkezett hibát jelöli.

Name Típus Description
error

ErrorBody

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

ErrorBody

Objektum

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

Name Típus Description
code

string

A hibakód.
message

string

A hibaüzenet.

ExternalEntity

Objektum

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

Name Típus Description
entityLength

integer (int32)

Az előrejelzett entitás hossza.
entityName

string

A kibővítendő entitás neve.
resolution

A felhasználó egyéni felbontást adott meg az entitás előrejelzéseként való visszatéréshez.
score

number (float)

Egy felhasználó adott vissza pontszámot az entitás előrejelzési pontszámaként.
startIndex

integer (int32)

Az előrejelzett entitás kezdő karakterindexe.

Intent

Objektum

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

Az aktivált szándék pontszáma.

Prediction

Objektum

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

Name Típus Description
alteredQuery

string

A lekérdezés a helyesírás-ellenőrzés után. Csak akkor állítsa be, ha engedélyezve volt a helyesírás-ellenőrzés, és helyesírási hiba történt.
entities

Egy szótár, amely az aktivált entitásokat jelöli.
intents

<string,  Intent>

Egy szótár, amely az aktivált szándékokat ábrázolja.
sentiment

Sentiment

A hangulatelemzés eredménye.
topIntent

string

A legfelső pontozási szándék neve.

PredictionRequest

Objektum

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

Name Típus Description
dynamicLists

DynamicList[]

A kérelem dinamikusan létrehozott listaentitásai.
externalEntities

ExternalEntity[]

A kérés külsőleg előrejelzett entitásai.
options

PredictionRequestOptions

A kéréshez definiált egyéni beállítások.
query

string

Az előrejelezendő lekérdezés.

PredictionRequestOptions

Objektum

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

Name Típus Description
datetimeReference

string (date-time)

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

Objektum

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

Objektum

Egy meglévő listaentitáshoz hozzáfűzendő allistát határoz meg.

Name Típus Description
canonicalForm

string

Az allista canonical formája.
name

string

Az allista neve.
synonyms

string[]

A canonical form szinonimái.

Sentiment

Objektum

A hangulatelemzés eredménye.

Name Típus Description
label

string

A hangulatelemzési eredmény címkéje.
score

number (float)

A lekérdezés hangulati pontszáma.