Examples - Batch

Usługa:

Azure AI Services

Wersja interfejsu API:

2.0

Dodaje partię oznaczonych przykładowymi wypowiedziami do wersji aplikacji.

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

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.

Nagłówek żądania

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

Treść żądania

Nazwa	Typ	Opis
exampleLabelObjectArray	ExampleLabelObject[]	Tablica przykładowych wypowiedzi.

Odpowiedzi

Nazwa	Typ	Opis
201 Created	BatchLabelExample[]	Tablica ciągów określająca, które z etykietami przykładowe wypowiedzi zostały pomyślnie dodane.
Other Status Codes	BatchLabelExample[]	Wskazuje, że żądanie zakończyło się częściowo pomyślnie. Odpowiedź zawiera tablicę ciągów wskazującą stan każdej z dodanych przykładowych wypowiedzi oznaczonych etykietą.
Other Status Codes	ErrorResponse	Odpowiedź na błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Przykłady

Successful Batch Add Labels request

Przykładowe żądanie

HTTP

POST {Endpoint}/luis/api/v2.0/apps/2370fb9d-7dbc-4898-a361-a742cf290766/versions/0.1/examples


[
  {
    "text": "whats the weather in seattle?",
    "entityLabels": [
      {
        "entityName": "Place",
        "startCharIndex": 21,
        "endCharIndex": 29
      }
    ],
    "intentName": "WeatherInPlace"
  },
  {
    "text": "whats the weather in buenos aires?",
    "entityLabels": [
      {
        "entityName": "Place",
        "startCharIndex": 21,
        "endCharIndex": 34
      }
    ],
    "intentName": "WeatherInPlace"
  }
]

Przykładowa odpowiedź

Kod stanu:

201

[
  {
    "value": {
      "UtteranceText": "whats the weather in seattle?",
      "ExampleId": -728104
    },
    "hasError": false
  },
  {
    "value": {
      "UtteranceText": "whats the weather in buenos aires?",
      "ExampleId": -5313943
    },
    "hasError": false
  }
]

Kod stanu:

207

[
  {
    "hasError": true,
    "error": {
      "code": "FAILED",
      "message": "whats the weather in seattle?. Error: The intent classifier InvalidIntent does not exist in the selected application"
    }
  },
  {
    "value": {
      "UtteranceText": "whats the weather in buenos aires?",
      "ExampleId": -5313943
    },
    "hasError": false
  }
]

Definicje

Nazwa	Opis
BatchLabelExample	Odpowiedź podczas dodawania partii oznaczonych przykładowymi wypowiedziami.
EntityLabelObject	Definiuje typ i położenie wyodrębnionej jednostki w przykładzie.
ErrorResponse	Odpowiedź na błąd podczas wywoływania operacji w interfejsie API.
ExampleLabelObject	Przykładowa wypowiedź oznaczona etykietą.
LabelExampleResponse	Odpowiedź podczas dodawania oznaczonej etykietą przykładowej wypowiedzi.
OperationStatus	Odpowiedź stanu operacji.
OperationStatusType	Kod stanu.

BatchLabelExample

Objekt

Odpowiedź podczas dodawania partii oznaczonych przykładowymi wypowiedziami.

Nazwa	Typ	Opis
error	OperationStatus	Odpowiedź stanu operacji.
hasError	boolean
value	LabelExampleResponse	Odpowiedź podczas dodawania oznaczonej etykietą przykładowej wypowiedzi.

EntityLabelObject

Objekt

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

Nazwa	Typ	Opis
endCharIndex	integer	Indeks w wypowiedzi, w której kończy się wyodrębniona jednostka.
entityName	string	Typ jednostki.
role	string	Rola jednostki w wypowiedzi.
startCharIndex	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

ExampleLabelObject

Objekt

Przykładowa wypowiedź oznaczona etykietą.

Nazwa	Typ	Opis
entityLabels	EntityLabelObject[]	Zidentyfikowane jednostki w przykładowej wypowiedzi.
intentName	string	Zidentyfikowana intencja reprezentująca przykładowe wypowiedzi.
text	string	Przykładowa wypowiedź.

LabelExampleResponse

Objekt

Odpowiedź podczas dodawania oznaczonej etykietą przykładowej wypowiedzi.

Nazwa	Typ	Opis
ExampleId	integer (int64)	Nowo utworzony przykładowy identyfikator.
UtteranceText	string	Przykładowa wypowiedź.

OperationStatus

Objekt

Odpowiedź stanu operacji.

Nazwa	Typ	Opis
code	OperationStatusType	Kod stanu.
message	string	Szczegóły stanu.

OperationStatusType

Wyliczanie

Kod stanu.

Wartość	Opis
FAILED
Failed
Success