Prediction - Get Slot Prediction

Referentie

Service:: Cognitive Services - LUIS

API Version:: 3.0

Hiermee haalt u de voorspellingen voor een toepassingssite op.

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

Name	In	Vereist	Type	Description
appId	path	True	string uuid	De toepassings-id.
Endpoint	path	True	string	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://westus.api.cognitive.microsoft.com).
slotName	path	True	string	De naam van de toepassingssite.
log	query		boolean	Hiermee wordt aangegeven of de eindpuntquery moet worden aangemeld of niet.
show-all-intents	query		boolean	Hiermee wordt aangegeven of alle intenties in het antwoord of alleen de bovenste intentie moeten worden geretourneerd.
verbose	query		boolean	Hiermee wordt aangegeven of extra metagegevens voor de voorspellingen van entiteiten moeten worden opgeslagen.

Aanvraagkoptekst

Name	Vereist	Type	Description
Ocp-Apim-Subscription-Key	True	string

Aanvraagbody

Name	Vereist	Type	Description
query	True	string	De query die moet worden voorspeld.
dynamicLists		DynamicList[]	De dynamisch gemaakte lijstentiteiten voor deze aanvraag.
externalEntities		ExternalEntity[]	De extern voorspelde entiteiten voor deze aanvraag.
options		PredictionRequestOptions	De aangepaste opties die voor deze aanvraag zijn gedefinieerd.

Antwoorden

Name	Type	Description
200 OK	PredictionResponse	De voorspelling voor de opgegeven query.
Other Status Codes	Error	Onverwachte fout.

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Voorbeelden

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

Definities

Name	Description
DynamicList	Hiermee definieert u een extensie voor een lijstentiteit.
Error	Vertegenwoordigt de fout die is opgetreden.
ErrorBody	Vertegenwoordigt de definitie van de fout die is opgetreden.
ExternalEntity	Definieert een door de gebruiker voorspelde entiteit die een bestaande entiteit uitbreidt.
Intent	Vertegenwoordigt een intentievoorspelling.
Prediction	Vertegenwoordigt de voorspelling van een query.
PredictionRequest	Vertegenwoordigt de parameters van de voorspellingsaanvraag.
PredictionRequestOptions	De aangepaste opties voor de voorspellingsaanvraag.
PredictionResponse	Vertegenwoordigt het voorspellingsantwoord.
RequestList	Hiermee definieert u een sublijst die moet worden toegevoegd aan een bestaande lijstentiteit.
Sentiment	Het resultaat van de sentimentanalyse.

DynamicList

Hiermee definieert u een extensie voor een lijstentiteit.

Name	Type	Description
listEntityName	string	De naam van de lijstentiteit die moet worden uitgebreid.
requestLists	RequestList[]	De lijsten die moeten worden toegevoegd aan de entiteit Uitgebreide lijst.

Error

Vertegenwoordigt de fout die is opgetreden.

Name	Type	Description
error	ErrorBody	Vertegenwoordigt de definitie van de fout die is opgetreden.

ErrorBody

Vertegenwoordigt de definitie van de fout die is opgetreden.

Name	Type	Description
code	string	De foutcode.
message	string	Het foutbericht.

ExternalEntity

Definieert een door de gebruiker voorspelde entiteit die een bestaande entiteit uitbreidt.

Name	Type	Description
entityLength	integer	De lengte van de voorspelde entiteit.
entityName	string	De naam van de entiteit die moet worden uitgebreid.
resolution		Een gebruiker heeft een aangepaste oplossing opgegeven om te retourneren als voorspelling van de entiteit.
score	number	Een gebruiker heeft een score opgegeven om als voorspellingsscore van de entiteit te retourneren.
startIndex	integer	De begintekenindex van de voorspelde entiteit.

Intent

Vertegenwoordigt een intentievoorspelling.

Name	Type	Description
childApp	Prediction	De voorspelling van de verzonden toepassing.
score	number	De score van de geactiveerde intentie.

Prediction

Vertegenwoordigt de voorspelling van een query.

Name	Type	Description
alteredQuery	string	De query na de spellingcontrole. Alleen ingesteld als de spellingcontrole is ingeschakeld en er een spelfout is gevonden.
entities		Een woordenlijst die de entiteiten vertegenwoordigt die zijn geactiveerd.
intents	<string, Intent>	Een woordenlijst die de intenties weergeeft die zijn geactiveerd.
sentiment	Sentiment	Het resultaat van de sentimentanalyse.
topIntent	string	De naam van de meest scorende intentie.

PredictionRequest

Vertegenwoordigt de parameters van de voorspellingsaanvraag.

Name	Type	Description
dynamicLists	DynamicList[]	De dynamisch gemaakte lijstentiteiten voor deze aanvraag.
externalEntities	ExternalEntity[]	De extern voorspelde entiteiten voor deze aanvraag.
options	PredictionRequestOptions	De aangepaste opties die voor deze aanvraag zijn gedefinieerd.
query	string	De query die moet worden voorspeld.

PredictionRequestOptions

De aangepaste opties voor de voorspellingsaanvraag.

Name	Type	Description
datetimeReference	string	De referentie-datum/tijd die wordt gebruikt voor het voorspellen van datum/tijd-entiteiten.
preferExternalEntities	boolean	Of de externe entiteitenomzetting de voorspellingen moet overschrijven als er een overlapping optreedt.

PredictionResponse

Vertegenwoordigt het voorspellingsantwoord.

Name	Type	Description
prediction	Prediction	De voorspelling van de aangevraagde query.
query	string	De query die wordt gebruikt in de voorspelling.

RequestList

Hiermee definieert u een sublijst die moet worden toegevoegd aan een bestaande lijstentiteit.

Name	Type	Description
canonicalForm	string	De canonieke vorm van de sublijst.
name	string	De naam van de sublijst.
synonyms	string[]	De synoniemen van de canonieke vorm.

Sentiment

Het resultaat van de sentimentanalyse.

Name	Type	Description
label	string	Het label van het resultaat van de sentimentanalyse.
score	number	De gevoelsscore van de query.