Train - Get Status

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

Obtém a status de treinamento de todos os modelos (intenções e entidades) para o aplicativo LUIS especificado. Você deve chamar a API de treinamento para treinar o aplicativo LUIS antes de chamar essa API para obter o status de treinamento. "appID" especifica a ID do aplicativo LUIS. "versionId" especifica o número de versão do aplicativo LUIS. Por exemplo, "0.1".

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
appId	path	True	string uuid	A ID do aplicativo.
Endpoint	path	True	string	Pontos de extremidade dos Serviços Cognitivos com suporte (protocolo e nome do host, por exemplo: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	A ID da versão.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Respostas

Nome	Tipo	Description
200 OK	ModelTrainingInfo[]	Uma resposta bem-sucedida fornece uma matriz de treinamento status detalhes para um aplicativo LUIS que você enviou para treinamento. Cada elemento na matriz de resposta fornece status de treinamento para um modelo (intenção ou entidade) no aplicativo LUIS. Observação: as status de treinamento não são fornecidas para entidades predefinidas porque são pré-treinadas. A propriedade "modelId" identifica a intenção ou entidade à qual o status de treinamento corresponde. Para obter o nome e o tipo de cada modelo, use a API de modelos que tem uma URL de solicitação 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 inteiro de 0 a 3 que corresponde ao valor do campo status. "status": uma cadeia de caracteres com um dos seguintes valores: "Success", "UpToDate", "InProgress", "Fail". Se o status for "Fail", a propriedade "failureReason" fornecerá o motivo da falha. "exampleCount": o número de exemplos usados para treinamento. No caso da intenção None ou de entidades e intenções de domínio predefinidas, esse número inclui um exemplo fornecido internamente pelo sistema, bem como exemplos que você adicionou ao seu aplicativo LUIS. "failureReason": uma cadeia de caracteres que indica o motivo pelo qual o treinamento falhou. O valor "FewLabels" significa que nenhum enunciado de exemplo rotulado foi fornecido para treinamento. "trainingDateTime": uma cadeia de caracteres que indica a hora em que o modelo foi treinado pela última vez. O valor usa o formato ISO 8601 para representar horários em UTC (Tempo Universal Coordenado) com um designador UTC ("Z"), por exemplo: "2017-08-10T01:08:34Z". Media Types: "application/json", "JSON"
Other Status Codes	ErrorResponse	Resposta de 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

Nome	Description
ErrorResponse	Resposta de erro ao invocar uma operação na API.
ModelTrainingDetails	Detalhes de treinamento do modelo.
ModelTrainingInfo	Informações de treinamento de modelo.
TrainingStatus	O status treinamento.

ErrorResponse

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

Nome	Tipo	Description
errorType	string

ModelTrainingDetails

Detalhes de treinamento do modelo.

Nome	Tipo	Description
exampleCount	integer	A contagem de exemplos usados para treinar o modelo.
failureReason	string	Motivo da falha de treinamento.
status	TrainingStatus	O status treinamento.
statusId	integer	A solicitação de trem status ID.
trainingDateTime	string	Quando o modelo foi treinado.

ModelTrainingInfo

Informações de treinamento de modelo.

Nome	Tipo	Description
details	ModelTrainingDetails	Detalhes de treinamento do modelo.
modelId	string	A ID (GUID) do modelo.

TrainingStatus

O status treinamento.

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