Train - Get Status

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

Obtém o estado de preparação de todos os modelos (intenções e entidades) para a aplicação LUIS especificada. Tem de chamar a API de preparação para preparar a aplicação LUIS antes de chamar esta API para obter o estado de preparação. "appID" especifica o ID da aplicação LUIS. "versionId" especifica o número da versão da aplicação LUIS. Por exemplo, "0,1".

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
appId	path	True	string uuid	O ID da aplicação.
Endpoint	path	True	string	Pontos finais dos Serviços Cognitivos suportados (protocolo e nome do anfitrião, por exemplo: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	O ID da versão.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Respostas

Name	Tipo	Description
200 OK	ModelTrainingInfo[]	Uma resposta bem-sucedida fornece uma matriz de detalhes do estado de preparação para uma aplicação LUIS que submeteu para preparação. Cada elemento na matriz de resposta fornece o estado de preparação para um modelo (intenção ou entidade) na aplicação LUIS. Nota: o estado de preparação não é fornecido para entidades pré-criadas porque estão pré-preparados. A propriedade "modelId" identifica a que intenção ou entidade o estado de preparação corresponde. Para obter o nome e o tipo de cada modelo, utilize a API de modelos que tem um URL de pedido neste formato: https://westus.api.cognitive.microsoft.com/luis/api/v3.0-preview/apps/{appId}/versions/{versionId}/models a propriedade details para cada modelo pode conter os seguintes campos: "statusId": um número inteiro de 0 a 3 que corresponda ao valor do campo de estado. "status": uma cadeia com um dos seguintes valores: "Success", "UpToDate", "InProgress", "Fail". Se o estado for "Falha", a propriedade "failureReason" fornece o motivo da falha. "exampleCount": o número de exemplos utilizados para a preparação. No caso da intenção None ou das intenções e entidades de domínio pré-criadas, este número inclui exemplos fornecidos internamente pelo sistema, bem como exemplos que adicionou à sua aplicação LUIS. "failureReason": uma cadeia que indica a razão pela qual a preparação falhou. O valor "FewLabels" significa que não foram fornecidas expressões de exemplo etiquetadas para preparação. "trainingDateTime": uma cadeia que indica a hora em que o modelo foi preparado pela última vez. O valor utiliza o formato ISO 8601 para representar horas em UTC (Hora Universal Coordenada) com um designador UTC ("Z"), por exemplo: "2017-08-10T01:08:34Z". Media Types: "application/json", "JSON"
Other Status Codes	ErrorResponse	Resposta do Erro. Media Types: "application/json", "JSON"

Segurança

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exemplos

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

Definições

Name	Description
ErrorResponse	Resposta de erro ao invocar uma operação na API.
ModelTrainingDetails	Detalhes da Preparação do Modelo.
ModelTrainingInfo	Informações de Preparação de Modelos.
TrainingStatus	O Estado da preparação.

ErrorResponse

Resposta de erro ao invocar uma operação na API.

Name	Tipo	Description
errorType	string

ModelTrainingDetails

Detalhes da Preparação do Modelo.

Name	Tipo	Description
exampleCount	integer	A contagem de exemplos utilizados para preparar o modelo.
failureReason	string	Motivo da falha de preparação.
status	TrainingStatus	O Estado da preparação.
statusId	integer	O ID de estado do pedido de preparação.
trainingDateTime	string	Quando o modelo foi preparado.

ModelTrainingInfo

Informações de Preparação de Modelos.

Name	Tipo	Description
details	ModelTrainingDetails	Detalhes da Preparação do Modelo.
modelId	string	O ID (GUID) do modelo.

TrainingStatus

O Estado da preparação.

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