Compartilhar via

Train - Get Status

  • Referência
Serviço:
Azure AI Services
Versão da API:
2.0

Obtém o status de treinamento de todos os modelos (intenções e entidades) para o aplicativo LUIS especificado. Você deve chamar a API de trem 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/api/v2.0/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 detalhes de status de treinamento 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: o status de treinamento não é fornecido para entidades predefinidas porque elas 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/v2.0/apps/{appId}/versions/{versionId}/models A propriedade de detalhes de cada modelo pode conter os seguintes campos: "statusId": um inteiro de 0 a 3 que corresponde ao valor do campo de 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 o exemplo fornecido internamente pelo sistema, bem como exemplos que você adicionou ao aplicativo LUIS. "failureReason": uma cadeia de caracteres que indica o motivo da falha no treinamento. 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 tempos 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

Tipo: apiKey
Em: header

Exemplos

Successful Get Application Version Training Status request

Solicitação de exemplo

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

Resposta de exemplo

Código de status:
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 do treinamento do modelo.
ModelTrainingInfo

Informações de treinamento de modelo.
TrainingStatus

O status de treinamento.

ErrorResponse

Objeto

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

Nome Tipo Description
errorType

string

ModelTrainingDetails

Objeto

Detalhes do treinamento do modelo.

Nome Tipo Description
exampleCount

integer

A contagem de exemplos usados para treinar o modelo.
failureReason

string

Motivo da falha no treinamento.
status

TrainingStatus

O status de treinamento.
statusId

integer

A ID de status da solicitação de trem.
trainingDateTime

string (date-time)

Quando o modelo foi treinado.

ModelTrainingInfo

Objeto

Informações de treinamento de modelo.

Nome Tipo Description
details

ModelTrainingDetails

Detalhes do treinamento do modelo.
modelId

string (uuid)

A ID (GUID) do modelo.

TrainingStatus

Enumeração

O status de treinamento.

Valor Description
Fail
InProgress
Queued
Success
UpToDate