Compartir a través de

Train - Get Status

  • Referencia
Servicio:
Azure AI Services
Versión de la API:
2.0

Obtiene el estado de entrenamiento de todos los modelos (intenciones y entidades) de 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 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/api/v2.0/apps/{appId}/versions/{versionId}/train

Parámetros de identificador URI

Nombre En Requerido Tipo Description
appId
 path True

string (uuid)

Identificador de la 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/v2.0/apps/{appId}/versions/{versionId}/models La propiedad details de cada modelo puede contener los siguientes campos: "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": el 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 de entrenamiento. El valor "FewLabels" significa que no se proporcionó ninguna expresión de ejemplo etiquetada 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 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

Tipo: apiKey
En: header

Ejemplos

Successful Get Application Version Training Status request

Solicitud de ejemplo

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

Respuesta de muestra

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 de entrenamiento del modelo.
ModelTrainingInfo

Información de entrenamiento del modelo.
TrainingStatus

Estado de entrenamiento.

ErrorResponse

Object

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

Nombre Tipo Description
errorType

string

ModelTrainingDetails

Object

Detalles de 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 (date-time)

Cuando se entrenó el modelo.

ModelTrainingInfo

Object

Información de entrenamiento del modelo.

Nombre Tipo Description
details

ModelTrainingDetails

Detalles de entrenamiento del modelo.
modelId

string (uuid)

Identificador (GUID) del modelo.

TrainingStatus

Enumeración

Estado de entrenamiento.

Valor Description
Fail
InProgress
Queued
Success
UpToDate