Train - Get Status

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

Obtient la status d’entraînement de tous les modèles (intentions et entités) pour l’application LUIS spécifiée. Vous devez appeler l’API Train pour effectuer l'apprentissage de l’application LUIS avant d’appeler cette API pour recevoir l’état de l’apprentissage. « appID » spécifie l’ID d’application LUIS. « versionId » spécifie le numéro de version de l’application LUIS. Par exemple, « 0.1 ».

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
appId	path	True	string uuid	L’ID de l'application.
Endpoint	path	True	string	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	ID de version.

En-tête de la demande

Nom	Obligatoire	Type	Description
Ocp-Apim-Subscription-Key	True	string

Réponses

Nom	Type	Description
200 OK	ModelTrainingInfo[]	Une réponse réussie fournit un tableau d’entraînement status détails pour une application LUIS que vous avez envoyée pour la formation. Chaque élément du tableau de réponses fournit des status d’entraînement pour un modèle (intention ou entité) dans l’application LUIS. Remarque : la formation status n’est pas fournie pour les entités prédéfinies, car elles sont préentraînées. La propriété « modelId » identifie à quelle intention ou entité correspond l’status d’entraînement. Pour obtenir le nom et le type de chaque modèle, utilisez l’API de modèles qui a une URL de requête dans ce format : https://westus.api.cognitive.microsoft.com/luis/api/v3.0-preview/apps/{appId}/versions/{versionId}/models la propriété details de chaque modèle peut contenir les champs suivants : « statusId » : entier compris entre 0 et 3 qui correspond à la valeur du champ status. « status » : chaîne avec l’une des valeurs suivantes : « Success », « UpToDate », « InProgress », « Fail ». Si le status est « Fail », la propriété « failureReason » indique la raison de l’échec. « exampleCount » : nombre d’exemples utilisés pour l’entraînement. Dans le cas de l’intention None ou des intentions et entités de domaine prédéfinies, ce nombre inclut l’exemple fourni en interne par le système, ainsi que les exemples que vous avez ajoutés à votre application LUIS. « failureReason » : chaîne qui indique la raison de l’échec de l’entraînement. La valeur « FewLabels » signifie qu’aucun exemple d’énoncé étiqueté n’a été fourni pour la formation. « trainingDateTime » : chaîne indiquant l’heure à laquelle le modèle a été entraîné pour la dernière fois. La valeur utilise le format ISO 8601 pour représenter les heures utc (temps universel coordonné) avec un indicateur UTC (« Z »), par exemple : « 2017-08-10T01 :08 :34Z ». Media Types: "application/json", "JSON"
Other Status Codes	ErrorResponse	Réponse d’erreur. Media Types: "application/json", "JSON"

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exemples

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

Définitions

Nom	Description
ErrorResponse	Réponse d’erreur lors de l’appel d’une opération sur l’API.
ModelTrainingDetails	Détails de l’entraînement du modèle.
ModelTrainingInfo	Informations d’entraînement du modèle.
TrainingStatus	Le status de formation.

ErrorResponse

Réponse d’erreur lors de l’appel d’une opération sur l’API.

Nom	Type	Description
errorType	string

ModelTrainingDetails

Détails de l’entraînement du modèle.

Nom	Type	Description
exampleCount	integer	Nombre d’exemples utilisés pour entraîner le modèle.
failureReason	string	Raison de l’échec d’entraînement.
status	TrainingStatus	Le status de formation.
statusId	integer	ID de status de demande de train.
trainingDateTime	string	Lorsque le modèle a été entraîné.

ModelTrainingInfo

Informations d’entraînement du modèle.

Nom	Type	Description
details	ModelTrainingDetails	Détails de l’entraînement du modèle.
modelId	string	ID (GUID) du modèle.

TrainingStatus

Le status de formation.

Nom	Type	Description
Fail	string
InProgress	string
Queued	string
Success	string
UpToDate	string