Train - Get Status

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

Obtiene el estado de entrenamiento de todos los modelos (intenciones y entidades) para la aplicación de LUIS especificada. Debe llamar a la API de entrenamiento para entrenar la aplicación de LUIS antes de llamar a esta API para obtener el estado de entrenamiento. "appID" especifica el identificador de la aplicación de LUIS. "versionId" especifica el número de versión de la aplicación de LUIS. Por ejemplo, "0.1".

GET {Endpoint}/luis/authoring/v3.0-preview/apps/{appId}/versions/{versionId}/train

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
appId	path	True	string uuid	El id. de aplicación.
Endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	Identificador de versión.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Respuestas

Nombre	Tipo	Description
200 OK	ModelTrainingInfo[]	Una respuesta correcta proporciona una matriz de detalles de estado de entrenamiento para una aplicación de LUIS que envió para el entrenamiento. Cada elemento de la matriz de respuesta proporciona el estado de entrenamiento de un modelo (intención o entidad) en la aplicación de LUIS. Nota: El estado de entrenamiento no se proporciona para las entidades precompiladas porque están entrenadas previamente. La propiedad "modelId" identifica a qué intención o entidad corresponde el estado de entrenamiento. Para obtener el nombre y el tipo de cada modelo, use la API de modelos que tiene una dirección URL de solicitud en este formato: https://westus.api.cognitive.microsoft.com/luis/api/v3.0-preview/apps/{appId}/versions/{versionId}/models la propiedad details de cada modelo puede contener los campos siguientes: "statusId": un entero de 0 a 3 que corresponde al valor del campo de estado. "status": una cadena con uno de los siguientes valores: "Success", "UpToDate", "InProgress", "Fail". Si el estado es "Fail", la propiedad "failureReason" proporciona el motivo del error. "exampleCount": número de ejemplos usados para el entrenamiento. En el caso de la intención None o las intenciones y entidades de dominio precompiladas, este número incluye un ejemplo proporcionado internamente por el sistema, así como ejemplos que agregó a la aplicación de LUIS. "failureReason": cadena que indica el motivo por el que se produjo un error en el entrenamiento. El valor "FewLabels" significa que no se proporcionaron expresiones de ejemplo etiquetadas para el entrenamiento. "trainingDateTime": una cadena que indica la hora en que se entrenó por última vez el modelo. El valor usa el formato ISO 8601 para representar las horas en UTC (hora universal coordinada) con un designador UTC ("Z"), por ejemplo: "2017-08-10T01:08:34Z". Media Types: "application/json", "JSON"
Other Status Codes	ErrorResponse	Respuesta de error. Media Types: "application/json", "JSON"

Seguridad

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Ejemplos

Successful Get Application Version Training Status request

Sample Request

HTTP

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

Definiciones

Nombre	Description
ErrorResponse	Respuesta de error al invocar una operación en la API.
ModelTrainingDetails	Detalles del entrenamiento del modelo.
ModelTrainingInfo	Información de entrenamiento del modelo.
TrainingStatus	Estado de entrenamiento.

ErrorResponse

Respuesta de error al invocar una operación en la API.

Nombre	Tipo	Description
errorType	string

ModelTrainingDetails

Detalles del entrenamiento del modelo.

Nombre	Tipo	Description
exampleCount	integer	Recuento de ejemplos usados para entrenar el modelo.
failureReason	string	Motivo del error de entrenamiento.
status	TrainingStatus	Estado de entrenamiento.
statusId	integer	Identificador de estado de la solicitud de entrenamiento.
trainingDateTime	string	Cuando se entrenó el modelo.

ModelTrainingInfo

Información de entrenamiento del modelo.

Nombre	Tipo	Description
details	ModelTrainingDetails	Detalles del entrenamiento del modelo.
modelId	string	Identificador (GUID) del modelo.

TrainingStatus

Estado de entrenamiento.

Nombre	Tipo	Description
Fail	string
InProgress	string
Queued	string
Success	string
UpToDate	string