Delen via

Prediction - Get Slot Prediction

  • Referentie
Service:
Azure AI Services
API-versie:
3.0

Hiermee haalt u de voorspellingen voor een toepassingssite op.

POST {Endpoint}/luis/prediction/v3.0/apps/{appId}/slots/{slotName}/predict
Met optionele 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

Geeft aan of de eindpuntquery moet worden vastgelegd of niet.
show-all-intents
 query

boolean

Geeft aan of alle intenties in het antwoord of alleen de belangrijkste intentie moeten worden geretourneerd.
verbose
 query

boolean

Hiermee wordt aangegeven of u extra metagegevens voor de voorspellingen van entiteiten wilt ophalen of niet.

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

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:
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

Hiermee definieert u 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 voor 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

Object

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

Object

Vertegenwoordigt de fout die is opgetreden.

Name Type Description
error

ErrorBody

Vertegenwoordigt de definitie van de fout die is opgetreden.

ErrorBody

Object

Vertegenwoordigt de definitie van de fout die is opgetreden.

Name Type Description
code

string

De foutcode.
message

string

Het foutbericht.

ExternalEntity

Object

Hiermee definieert u een door de gebruiker voorspelde entiteit die een bestaande entiteit uitbreidt.

Name Type Description
entityLength

integer (int32)

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 de voorspelling van de entiteit.
score

number (float)

Een gebruiker heeft een score opgegeven die moet worden geretourneerd als de voorspellingsscore van de entiteit.
startIndex

integer (int32)

De begintekenindex van de voorspelde entiteit.

Intent

Object

Vertegenwoordigt een intentievoorspelling.

Name Type Description
childApp

Prediction

De voorspelling van de verzonden toepassing.
score

number (float)

De score van de geactiveerde intentie.

Prediction

Object

Vertegenwoordigt de voorspelling van een query.

Name Type Description
alteredQuery

string

De query na spellingcontrole. Alleen ingesteld als 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 vertegenwoordigt die zijn geactiveerd.
sentiment

Sentiment

Het resultaat van de sentimentanalyse.
topIntent

string

De naam van de meest scorende intentie.

PredictionRequest

Object

Vertegenwoordigt de parameters voor 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

Object

De aangepaste opties voor de voorspellingsaanvraag.

Name Type Description
datetimeReference

string (date-time)

De referentie datetime die wordt gebruikt voor het voorspellen van datum/tijd-entiteiten.
preferExternalEntities

boolean

Of de oplossing van externe entiteiten de voorspellingen overschrijft als er sprake is van een overlapping.

PredictionResponse

Object

Vertegenwoordigt het voorspellingsantwoord.

Name Type Description
prediction

Prediction

De voorspelling van de aangevraagde query.
query

string

De query die in de voorspelling wordt gebruikt.

RequestList

Object

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

Object

Het resultaat van de sentimentanalyse.

Name Type Description
label

string

Het label van het resultaat van de sentimentanalyse.
score

number (float)

De gevoelsscore van de query.