Поделиться через

Examples - Batch

  • Ссылка
Служба:
Azure AI Services
Версия API:
2.0

Добавляет пакет помеченных примеров речевых фрагментов в версию приложения.

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

Параметры URI

Имя В Обязательно Тип Описание
appId
 path True

string (uuid)

Идентификатор приложения.
Endpoint
 path True

string

Поддерживаемые конечные точки Cognitive Services (протокол и имя узла, например https://westus.api.cognitive.microsoft.com).
versionId
 path True

string

Идентификатор версии.

Заголовок запроса

Имя Обязательно Тип Описание
Ocp-Apim-Subscription-Key True

string

Текст запроса

Имя Тип Описание
exampleLabelObjectArray

ExampleLabelObject[]

Массив примеров речевых фрагментов.

Ответы

Имя Тип Описание
201 Created

BatchLabelExample[]

Строковый массив, определяющий, какие помеченные примеры высказываний были добавлены успешно.
Other Status Codes

BatchLabelExample[]

Указывает, что запрос был частично успешным. Ответ содержит массив строк, указывающий состояние каждого добавленного примера речевых фрагментов.
Other Status Codes

ErrorResponse

Ответ на ошибку.

Безопасность

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

Примеры

Successful Batch Add Labels request

Образец запроса

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

Пример ответа

Код состояния:
201 
[
  {
    "value": {
      "UtteranceText": "whats the weather in seattle?",
      "ExampleId": -728104
    },
    "hasError": false
  },
  {
    "value": {
      "UtteranceText": "whats the weather in buenos aires?",
      "ExampleId": -5313943
    },
    "hasError": false
  }
]
Код состояния:
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
  }
]

Определения

Имя Описание
BatchLabelExample

Ответ при добавлении пакета помеченных примеров речевых фрагментов.
EntityLabelObject

Определяет тип сущности и позицию извлеченной сущности в примере.
ErrorResponse

Ответ об ошибке при вызове операции в API.
ExampleLabelObject

Помеченный пример речевых фрагментов.
LabelExampleResponse

Ответ при добавлении помеченного примера речевых фрагментов.
OperationStatus

Ответ состояния операции.
OperationStatusType

Код состояния.

BatchLabelExample

Object

Ответ при добавлении пакета помеченных примеров речевых фрагментов.

Имя Тип Описание
error

OperationStatus

Ответ состояния операции.
hasError

boolean

value

LabelExampleResponse

Ответ при добавлении помеченного примера речевых фрагментов.

EntityLabelObject

Object

Определяет тип сущности и позицию извлеченной сущности в примере.

Имя Тип Описание
endCharIndex

integer

Индекс в речевых фрагментах, где заканчивается извлеченная сущность.
entityName

string

Тип сущности.
role

string

Роль сущности в речевых фрагментах.
startCharIndex

integer

Индекс в речевых фрагментах, где запускается извлеченная сущность.

ErrorResponse

Object

Ответ об ошибке при вызове операции в API.

Имя Тип Описание
errorType

string

ExampleLabelObject

Object

Помеченный пример речевых фрагментов.

Имя Тип Описание
entityLabels

EntityLabelObject[]

Определяемые сущности в примере речевых фрагментов.
intentName

string

Определяемое намерение, представляющее пример высказываний.
text

string

Пример речевых фрагментов.

LabelExampleResponse

Object

Ответ при добавлении помеченного примера речевых фрагментов.

Имя Тип Описание
ExampleId

integer (int64)

Созданный идентификатор примера.
UtteranceText

string

Пример речевых фрагментов.

OperationStatus

Object

Ответ состояния операции.

Имя Тип Описание
code

OperationStatusType

Код состояния.
message

string

Сведения о состоянии.

OperationStatusType

Перечисление

Код состояния.

Значение Описание
FAILED
Failed
Success