Udostępnij za pośrednictwem

Prediction - Get Slot Prediction

  • Odwołanie
Usługa:
Azure AI Services
Wersja interfejsu API:
3.0

Pobiera przewidywania dla miejsca aplikacji.

POST {Endpoint}/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict
Z parametrami opcjonalnymi: 
POST {Endpoint}/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict?verbose={verbose}&show-all-intents={show-all-intents}&log={log}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
appId
 path True

string (uuid)

Identyfikator aplikacji.
Endpoint
 path True

string

Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://westus.api.cognitive.microsoft.com).
slotName
 path True

string

Nazwa miejsca aplikacji.
log
 query

boolean

Wskazuje, czy należy zarejestrować zapytanie punktu końcowego, czy nie.
show-all-intents
 query

boolean

Wskazuje, czy zwracać wszystkie intencje w odpowiedzi, czy tylko wierzchołków intencji.
verbose
 query

boolean

Wskazuje, czy uzyskać dodatkowe metadane dla przewidywań jednostek, czy nie.

Nagłówek żądania

Nazwa Wymagane Typ Opis
Ocp-Apim-Subscription-Key True

string

Treść żądania

Nazwa Wymagane Typ Opis
query True

string

Zapytanie do przewidzenia.
dynamicLists

DynamicList[]

Dynamicznie tworzone jednostki listy dla tego żądania.
externalEntities

ExternalEntity[]

Zewnętrznie przewidywane jednostki dla tego żądania.
options

PredictionRequestOptions

Opcje niestandardowe zdefiniowane dla tego żądania.

Odpowiedzi

Nazwa Typ Opis
200 OK

PredictionResponse

Przewidywanie dostarczonego zapytania.
Other Status Codes

Error

Nieoczekiwany błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Przykłady

Successful Get Slot Predictions From Endpoint Via Post request

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
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
    }
  }
}

Definicje

Nazwa Opis
DynamicList

Definiuje rozszerzenie jednostki listy.
Error

Reprezentuje błąd, który wystąpił.
ErrorBody

Reprezentuje definicję błędu, który wystąpił.
ExternalEntity

Definiuje przewidywaną jednostkę użytkownika, która rozszerza już istniejącą jednostkę.
Intent

Reprezentuje przewidywanie intencji.
Prediction

Reprezentuje przewidywanie zapytania.
PredictionRequest

Reprezentuje parametry żądania przewidywania.
PredictionRequestOptions

Opcje niestandardowe dla żądania przewidywania.
PredictionResponse

Reprezentuje odpowiedź przewidywania.
RequestList

Definiuje listę podrzędną dołączaną do istniejącej jednostki listy.
Sentiment

Wynik analizy tonacji.

DynamicList

Objekt

Definiuje rozszerzenie jednostki listy.

Nazwa Typ Opis
listEntityName

string

Nazwa jednostki listy do rozszerzenia.
requestLists

RequestList[]

Listy, które mają być dołączane do jednostki listy rozszerzonej.

Error

Objekt

Reprezentuje błąd, który wystąpił.

Nazwa Typ Opis
error

ErrorBody

Reprezentuje definicję błędu, który wystąpił.

ErrorBody

Objekt

Reprezentuje definicję błędu, który wystąpił.

Nazwa Typ Opis
code

string

Kod błędu.
message

string

Komunikat o błędzie.

ExternalEntity

Objekt

Definiuje przewidywaną jednostkę użytkownika, która rozszerza już istniejącą jednostkę.

Nazwa Typ Opis
entityLength

integer (int32)

Długość przewidywanej jednostki.
entityName

string

Nazwa jednostki do rozszerzenia.
resolution

Użytkownik dostarczył niestandardowe rozwiązanie, które ma być zwracane jako przewidywanie jednostki.
score

number (float)

Użytkownik podał ocenę, która ma być zwracana jako wynik przewidywania jednostki.
startIndex

integer (int32)

Indeks znaku początkowego przewidywanej jednostki.

Intent

Objekt

Reprezentuje przewidywanie intencji.

Nazwa Typ Opis
childApp

Prediction

Przewidywanie wysłanej aplikacji.
score

number (float)

Wynik wyzwolonej intencji.

Prediction

Objekt

Reprezentuje przewidywanie zapytania.

Nazwa Typ Opis
alteredQuery

string

Zapytanie po sprawdzeniu pisowni. Ustaw tylko wtedy, gdy włączono sprawdzanie pisowni i znaleziono błąd pisowni.
entities

Słownik reprezentujący wyzwolone jednostki.
intents

<string,  Intent>

Słownik reprezentujący wyzwolone intencje.
sentiment

Sentiment

Wynik analizy tonacji.
topIntent

string

Nazwa głównej intencji oceniania.

PredictionRequest

Objekt

Reprezentuje parametry żądania przewidywania.

Nazwa Typ Opis
dynamicLists

DynamicList[]

Dynamicznie tworzone jednostki listy dla tego żądania.
externalEntities

ExternalEntity[]

Zewnętrznie przewidywane jednostki dla tego żądania.
options

PredictionRequestOptions

Opcje niestandardowe zdefiniowane dla tego żądania.
query

string

Zapytanie do przewidzenia.

PredictionRequestOptions

Objekt

Opcje niestandardowe dla żądania przewidywania.

Nazwa Typ Opis
datetimeReference

string (date-time)

Odwołanie DateTime używane do przewidywania jednostek datetime.
preferExternalEntities

boolean

Czy rozwiązanie jednostek zewnętrznych zastępuje przewidywania, jeśli wystąpi nakładanie.

PredictionResponse

Objekt

Reprezentuje odpowiedź przewidywania.

Nazwa Typ Opis
prediction

Prediction

Przewidywanie żądanego zapytania.
query

string

Zapytanie używane w przewidywaniu.

RequestList

Objekt

Definiuje listę podrzędną dołączaną do istniejącej jednostki listy.

Nazwa Typ Opis
canonicalForm

string

Kanoniczna forma listy podrzędnej.
name

string

Nazwa listy podrzędnej.
synonyms

string[]

Synonimy formy kanonicznej.

Sentiment

Objekt

Wynik analizy tonacji.

Nazwa Typ Opis
label

string

Etykieta wyniku analizy tonacji.
score

number (float)

Wynik tonacji zapytania.