Train - Get Status

Servizio:

Azure AI Services

Versione API:

2.0

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/api/v2.0/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	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é vengono sottoposti a training preliminare. 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/v2.0/apps/{appId}/versions/{versionId}/models La proprietà details per ogni modello può contenere i campi seguenti: "statusId": 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à None 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

Tipo: apiKey
In: header

Esempio

Successful Get Application Version Training Status request

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

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 sull'API.
ModelTrainingDetails	Dettagli training del modello.
ModelTrainingInfo	Informazioni sul training del modello.
TrainingStatus	Stato training.

ErrorResponse

Object

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

Nome	Tipo	Descrizione
errorType	string

ModelTrainingDetails

Object

Dettagli training del modello.

Nome	Tipo	Descrizione
exampleCount	integer	Numero di esempi usati per eseguire il training del modello.
failureReason	string	Motivo dell'errore di training.
status	TrainingStatus	Stato training.
statusId	integer	ID di stato della richiesta di training.
trainingDateTime	string (date-time)	Quando è stato eseguito il training del modello.

ModelTrainingInfo

Object

Informazioni sul training del modello.

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

TrainingStatus

Enumerazione

Stato training.

Valore	Descrizione
Fail
InProgress
Queued
Success
UpToDate