Train - Get Status

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

Ottiene lo stato di training di tutti i modelli (finalità ed entità) per l'app LUIS specificata. È necessario chiamare l'API di training per eseguire il training dell'app LUIS prima di chiamare questa API per ottenere lo stato di training. "appID" specifica l'ID app LUIS. "versionId" specifica il numero di versione dell'app LUIS. Ad esempio, "0.1".

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
appId	path	True	string uuid	ID applicazione.
Endpoint	path	True	string	Endpoint di Servizi cognitivi supportati (protocollo e nome host, ad esempio: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	L'ID versione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
Ocp-Apim-Subscription-Key	True	string

Risposte

Nome	Tipo	Descrizione
200 OK	ModelTrainingInfo[]	Una risposta con esito positivo fornisce una matrice di dettagli sullo stato del training per un'app LUIS inviata per il training. Ogni elemento nella matrice di risposta fornisce lo stato di training per un modello (finalità o entità) nell'app LUIS. Nota: lo stato del training non viene fornito per le entità predefinite perché sono pretrained. La proprietà "modelId" identifica la finalità o l'entità a cui corrisponde lo stato del training. Per ottenere il nome e il tipo di ogni modello, usare l'API models con un URL di richiesta in questo formato: https://westus.api.cognitive.microsoft.com/luis/api/v3.0-preview/apps/{appId}/versions/{versionId}/models la proprietà details per ogni modello può contenere i campi seguenti: "statusId": Un numero intero compreso tra 0 e 3 che corrisponde al valore del campo di stato. "status": stringa con uno dei valori seguenti: "Success", "UpToDate", "InProgress", "Fail". Se lo stato è "Fail", la proprietà "failureReason" fornisce il motivo dell'errore. "exampleCount": numero di esempi usati per il training. Nel caso della finalità Nessuno o delle entità predefinite del dominio, questo numero include l'esempio fornito internamente dal sistema, nonché esempi aggiunti all'app LUIS. "failureReason": stringa che indica il motivo per cui il training non è riuscito. Il valore "FewLabels" indica che non sono state fornite espressioni di esempio con etichetta per il training. "trainingDateTime": stringa che indica l'ora dell'ultimo training del modello. Il valore usa il formato ISO 8601 per rappresentare le ore in formato UTC (Coordinated Universal Time) con un designatore UTC ("Z"), ad esempio: "2017-08-10T01:08:34Z". Media Types: "application/json", "JSON"
Other Status Codes	ErrorResponse	Risposta errore. Media Types: "application/json", "JSON"

Sicurezza

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Esempio

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

Definizioni

Nome	Descrizione
ErrorResponse	Risposta di errore quando si richiama un'operazione nell'API.
ModelTrainingDetails	Dettagli training modello.
ModelTrainingInfo	Informazioni sul training del modello.
TrainingStatus	Stato training.

ErrorResponse

Risposta di errore quando si richiama un'operazione nell'API.

Nome	Tipo	Descrizione
errorType	string

ModelTrainingDetails

Dettagli training modello.

Nome	Tipo	Descrizione
exampleCount	integer	Conteggio degli esempi usati per eseguire il training del modello.
failureReason	string	Motivo dell'errore di training.
status	TrainingStatus	Stato training.
statusId	integer	ID dello stato della richiesta di training.
trainingDateTime	string	Quando è stato eseguito il training del modello.

ModelTrainingInfo

Informazioni sul training del modello.

Nome	Tipo	Descrizione
details	ModelTrainingDetails	Dettagli training modello.
modelId	string	ID (GUID) del modello.

TrainingStatus

Stato training.

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