Examples - List

Usługa:

Azure AI Services

Wersja interfejsu API:

2.0

Zwraca przykładowe wypowiedzi do przejrzenia z wersji aplikacji.

GET {Endpoint}/luis/api/v2.0/apps/{appId}/versions/{versionId}/examples

Z parametrami opcjonalnymi:

GET {Endpoint}/luis/api/v2.0/apps/{appId}/versions/{versionId}/examples?skip={skip}&take={take}

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).
versionId	path	True	string	Identyfikator wersji.
skip	query		integer minimum: 0	Liczba wpisów do pominięcia. Wartość domyślna to 0.
take	query		integer minimum: 0 maximum: 500	Liczba wpisów do zwrócenia. Maksymalny rozmiar strony to 500. Wartość domyślna to 100.

Nagłówek żądania

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

Odpowiedzi

Nazwa	Typ	Opis
200 OK	LabeledUtterance[]	Lista przewidywań i par etykiet dla każdej przykładowej wypowiedzi w aplikacji.
Other Status Codes	ErrorResponse	Odpowiedź na błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Przykłady

Successful Review Labeled Examples request

Przykładowe żądanie

HTTP

GET {Endpoint}/luis/api/v2.0/apps/86226c53-b7a6-416f-876b-226b2b5ab07b/versions/0.1/examples

Przykładowa odpowiedź

Kod stanu:

200

[
  {
    "id": -12,
    "text": "what's the weather like in seattle?",
    "tokenizedText": [
      "what",
      "'",
      "s",
      "the",
      "weather",
      "like",
      "in",
      "seattle",
      "?"
    ],
    "intentLabel": "GetWeather",
    "entityLabels": [
      {
        "entityName": "Location",
        "startTokenIndex": 7,
        "endTokenIndex": 7
      }
    ],
    "intentPredictions": [
      {
        "name": "GetWeather",
        "score": 1
      },
      {
        "name": "None",
        "score": 0.21
      },
      {
        "name": "BookFlight",
        "score": 0
      }
    ],
    "entityPredictions": [
      {
        "entityName": "Location",
        "startTokenIndex": 7,
        "endTokenIndex": 7,
        "phrase": "seattle"
      }
    ]
  },
  {
    "id": -11,
    "text": "book me a flight from cairo to redmond next thursday",
    "tokenizedText": [
      "book",
      "me",
      "a",
      "flight",
      "from",
      "cairo",
      "to",
      "redmond",
      "next",
      "thursday"
    ],
    "intentLabel": "BookFlight",
    "entityLabels": [
      {
        "entityName": "Location",
        "startTokenIndex": 7,
        "endTokenIndex": 7,
        "role": "To"
      },
      {
        "entityName": "Location",
        "startTokenIndex": 5,
        "endTokenIndex": 5,
        "role": "from"
      }
    ],
    "intentPredictions": [
      {
        "name": "BookFlight",
        "score": 0.93
      },
      {
        "name": "None",
        "score": 0.41
      },
      {
        "name": "GetWeather",
        "score": 0
      }
    ],
    "entityPredictions": [
      {
        "entityName": "datetime",
        "startTokenIndex": 8,
        "endTokenIndex": 9,
        "phrase": "next thursday"
      }
    ]
  }
]

Definicje

Nazwa	Opis
EntityLabel	Definiuje typ i położenie wyodrębnionej jednostki w przykładzie.
EntityPrediction	Sugerowana jednostka.
ErrorResponse	Odpowiedź na błąd podczas wywoływania operacji w interfejsie API.
IntentPrediction	Sugerowana intencja.
LabeledUtterance	Para przewidywania i etykiety przykładu.

EntityLabel

Objekt

Definiuje typ i położenie wyodrębnionej jednostki w przykładzie.

Nazwa	Typ	Opis
endTokenIndex	integer	Indeks w wypowiedzi, w której kończy się wyodrębniona jednostka.
entityName	string	Typ jednostki.
role	string	Rola jednostki w wypowiedzi.
roleId	string	Identyfikator roli.
startTokenIndex	integer	Indeks w wypowiedzi, w której rozpoczyna się wyodrębniona jednostka.

EntityPrediction

Objekt

Sugerowana jednostka.

Nazwa	Typ	Opis
endTokenIndex	integer	Indeks w wypowiedzi, w której kończy się wyodrębniona jednostka.
entityName	string	Nazwa jednostki
phrase	string	Rzeczywiste tokeny, które składają się na jednostkę.
startTokenIndex	integer	Indeks w wypowiedzi, w której rozpoczyna się wyodrębniona jednostka.

ErrorResponse

Objekt

Odpowiedź na błąd podczas wywoływania operacji w interfejsie API.

Nazwa	Typ	Opis
errorType	string

IntentPrediction

Objekt

Sugerowana intencja.

Nazwa	Typ	Opis
name	string	Nazwa intencji
score	number	Wynik intencji na podstawie modelu przewidywania.

LabeledUtterance

Objekt

Para przewidywania i etykiety przykładu.

Nazwa	Typ	Opis
entityLabels	EntityLabel[]	Jednostki pasujące do przykładu.
entityPredictions	EntityPrediction[]	Lista sugerowanych jednostek.
id	integer (int64)	Identyfikator oznaczonej wypowiedzi.
intentLabel	string	Intencja zgodna z przykładem.
intentPredictions	IntentPrediction[]	Lista sugerowanych intencji.
text	string	Wypowiedź. Na przykład "Jak wygląda pogoda w seattle?"
tokenizedText	string[]	Wypowiedź została tokenizowana.