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

Train - Get Status

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

Возвращает состояние обучения всех моделей (намерений и сущностей) для указанного приложения LUIS. Перед вызовом этого API необходимо вызвать API обучения, чтобы обучить приложение LUIS, чтобы получить состояние обучения. AppID указывает идентификатор приложения LUIS. "versionId" указывает номер версии приложения LUIS. Например, "0.1".

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

Параметры 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

Ответы

Имя Тип Описание
200 OK

ModelTrainingInfo[]

Успешный ответ предоставляет массив сведений о состоянии обучения для приложения LUIS, отправленного для обучения. Каждый элемент в массиве ответов предоставляет состояние обучения для модели (намерения или сущности) в приложении LUIS. Примечание. Состояние обучения не предоставляется для предварительно созданных сущностей, так как они предварительно обучены. Свойство ModelId определяет, какое намерение или сущность соответствует состоянию обучения. Чтобы получить имя и тип каждой модели, используйте API моделей, имеющий URL-адрес запроса в этом формате: https://westus.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appId}/versions/{versionId}/models Свойство details для каждой модели может содержать следующие поля: statusId: целое число от 0 до 3, соответствующее значению поля состояния. "status": строка с одним из следующих значений: "Success", "UpToDate", "InProgress", "Fail". Если состояние имеет значение Fail, свойство failureReason предоставляет причину сбоя. "exampleCount": количество примеров, используемых для обучения. В случае намерения None или предварительно созданных намерений домена и сущностей это число включает пример, предоставленный системой, а также примеры, добавленные в приложение LUIS. "failureReason": строка, указывающая причину сбоя обучения. Значение "FewLabels" означает, что для обучения не были предоставлены помеченные примеры речевых фрагментов. "trainingDateTime": строка, указывающая время последнего обучения модели. Значение использует формат ISO 8601 для представления времени в формате UTC (координированное универсальное время) с конструктором UTC ("Z"), например: "2017-08-10T01:08:34Z".

Media Types: "application/json", "JSON"
Other Status Codes

ErrorResponse

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

Media Types: "application/json", "JSON"

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

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

Примеры

Successful Get Application Version Training Status request

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

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

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

Код состояния:
200 
[
  {
    "modelId": "f9b00d5b-1f2d-421e-bc99-5ff192d0b998",
    "details": {
      "statusId": 3,
      "status": "InProgress",
      "exampleCount": 0
    }
  },
  {
    "modelId": "51403af3-5342-4926-abaa-91172a42e075",
    "details": {
      "statusId": 2,
      "status": "UpToDate",
      "exampleCount": 12,
      "trainingDateTime": "2017-01-31T21:42:02Z"
    }
  },
  {
    "modelId": "b4cf6402-dc79-4ca3-8666-b0007337e92b",
    "details": {
      "statusId": 1,
      "status": "Fail",
      "exampleCount": 12,
      "failureReason": "FewLabels"
    }
  },
  {
    "modelId": "e8e3135a-acd9-4164-a65c-e2fedbe78cfa",
    "details": {
      "statusId": 3,
      "status": "InProgress",
      "exampleCount": 0
    }
  },
  {
    "modelId": "3291fac9-6368-4c87-9562-e78cae0fa7c6",
    "details": {
      "statusId": 0,
      "status": "Success",
      "exampleCount": 12,
      "trainingDateTime": "2017-01-31T21:42:02Z"
    }
  },
  {
    "modelId": "a193efac-ab02-49d7-b005-ee717d45c4f1",
    "details": {
      "statusId": 3,
      "status": "InProgress",
      "exampleCount": 0
    }
  }
]

Определения

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

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

Сведения о обучении модели.
ModelTrainingInfo

Сведения об обучении модели.
TrainingStatus

Состояние обучения.

ErrorResponse

Object

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

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

string

ModelTrainingDetails

Object

Сведения о обучении модели.

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

integer

Количество примеров, используемых для обучения модели.
failureReason

string

Причина сбоя обучения.
status

TrainingStatus

Состояние обучения.
statusId

integer

Идентификатор состояния запроса на обучение.
trainingDateTime

string (date-time)

Когда модель была обучена.

ModelTrainingInfo

Object

Сведения об обучении модели.

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

ModelTrainingDetails

Сведения о обучении модели.
modelId

string (uuid)

Идентификатор (GUID) модели.

TrainingStatus

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

Состояние обучения.

Значение Описание
Fail
InProgress
Queued
Success
UpToDate