Partager via

Train - Get Status

  • Référence
Service:
Azure AI Services
Version d'API:
2.0

Obtient l’état d’entraînement de tous les modèles (intentions et entités) pour l’application LUIS spécifiée. Vous devez appeler l’API d’apprentissage pour entraîner l’application LUIS avant d’appeler cette API pour obtenir l’état de formation. « 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/api/v2.0/apps/{appId}/versions/{versionId}/train

Paramètres URI

Nom Dans Obligatoire Type Description
appId
 path True

string (uuid)

ID d’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 de détails d’état d’entraînement pour une application LUIS que vous avez envoyée pour la formation. Chaque élément du tableau de réponses fournit un état d’apprentissage pour un modèle (intention ou entité) dans l’application LUIS. Remarque : L’état d’entraînement n’est pas fourni pour les entités prédéfinies, car elles sont préentraînées. La propriété « modelId » identifie l’intention ou l’entité à laquelle correspond l’état d’entraînement. Pour obtenir le nom et le type de chaque modèle, utilisez l’API modèles qui a une URL de requête au format suivant : https://westus.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appId}/versions/{versionId}/models La propriété détails de chaque modèle peut contenir les champs suivants : « statusId » : entier compris entre 0 et 3 qui correspond à la valeur du champ d’état. « status » : chaîne avec l’une des valeurs suivantes : « Success », « UpToDate », « InProgress », « Fail ». Si l’état est « Fail », la propriété « failureReason » fournit la raison de l’échec. « exampleCount » : nombre d’exemples utilisés pour l’entraînement. Dans le cas de l’intention None ou des entités de domaine prédéfinies, ce nombre inclut un exemple fourni en interne par le système, ainsi que des exemples que vous avez ajoutés à votre application LUIS. « failureReason » : chaîne qui indique l’échec de l’entraînement. La valeur « FewLabels » signifie qu’aucun exemple d’énoncé étiqueté n’a été fourni pour l’entraînement. « trainingDateTime » : chaîne indiquant l’heure à laquelle le modèle a été formé pour la dernière fois. La valeur utilise le format ISO 8601 pour représenter des heures au format 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
Dans: header

Exemples

Successful Get Application Version Training Status request

Exemple de requête

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

Exemple de réponse

Code d’état:
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

État de l’entraînement.

ErrorResponse

Object

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

Nom Type Description
errorType

string

ModelTrainingDetails

Object

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 de l’entraînement.
status

TrainingStatus

État de l’entraînement.
statusId

integer

ID d’état de la demande d’apprentissage.
trainingDateTime

string (date-time)

Lorsque le modèle a été entraîné.

ModelTrainingInfo

Object

Informations d’entraînement du modèle.

Nom Type Description
details

ModelTrainingDetails

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

string (uuid)

ID (GUID) du modèle.

TrainingStatus

Énumération

État de l’entraînement.

Valeur Description
Fail
InProgress
Queued
Success
UpToDate