Share via

Train - Get Status

  • Ссылка
Service:
Cognitive Services - LUIS
API Version:
3.0-preview

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

GET {Endpoint}/luis/authoring/v3.0-preview/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/v3.0-preview/apps/{appId}/versions/{versionId}/models Свойство details для каждой модели может содержать следующие поля: statusId: целое число от 0 до 3, соответствующее значению поля состояния. "status": строка со следующими значениями: "Success", "UpToDate", "InProgress", "Fail". Если состояние — "Сбой", свойство failureReason предоставляет причину сбоя. "exampleCount": количество примеров, используемых для обучения. В случае намерения None или предварительно созданных намерений и сущностей домена это число включает примеры, предоставленные системой, а также примеры, добавленные в приложение LUIS. "failureReason": строка, указывающая причину сбоя обучения. Значение "FewLabels" означает, что для обучения не предоставлены помеченные примеры речевых фрагментов. "trainingDateTime": строка, указывающая время последнего обучения модели. Значение использует формат ISO 8601 для представления времени в формате UTC (универсальное время в формате 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

Type: apiKey
In: header

Примеры

Successful Get Application Version Training Status request

Sample Request

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

Sample Response

Status code:
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

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

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

string

ModelTrainingDetails

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

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

integer

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

string

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

TrainingStatus

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

integer

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

string

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

ModelTrainingInfo

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

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

ModelTrainingDetails

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

string

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

TrainingStatus

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

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

string

InProgress

string

Queued

string

Success

string

UpToDate

string