Train - Get Status

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

Ruft die Trainings-status aller Modelle (Absichten und Entitäten) für die angegebene LUIS-App ab. Sie müssen die Trainings-API zum Trainieren der LUIS-App aufrufen, bevor Sie mit dieser API den Trainingsstatus abrufen können. "appID" gibt die LUIS-App-ID an. "versionId" gibt die Versionsnummer der LUIS-App an. Beispiel: "0.1".

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
appId	path	True	string uuid	Die Anwendungs-ID.
Endpoint	path	True	string	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. ). https://westus.api.cognitive.microsoft.com
versionId	path	True	string	Die Versions-ID.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Ocp-Apim-Subscription-Key	True	string

Antworten

Name	Typ	Beschreibung
200 OK	ModelTrainingInfo[]	Eine erfolgreiche Antwort enthält ein Array von Trainings status Details für eine LUIS-App, die Sie zum Training übermittelt haben. Jedes Element im Antwortarray bietet Training status für ein Modell (Absicht oder Entität) in der LUIS-App. Hinweis: Training status wird für vordefinierte Entitäten nicht bereitgestellt, da sie vortrainiert sind. Die Eigenschaft "modelId" gibt an, welcher Absicht oder Entität das Training status entspricht. Verwenden Sie zum Abrufen des Namens und typs jedes Modells die Modell-API, die über eine Anforderungs-URL in diesem Format verfügt: https://westus.api.cognitive.microsoft.com/luis/api/v3.0-preview/apps/{appId}/versions/{versionId}/models Die detail-Eigenschaft für jedes Modell kann die folgenden Felder enthalten: "statusId": Eine ganze Zahl von 0 bis 3, die dem Wert des status Felds entspricht. "status": Eine Zeichenfolge mit einem der folgenden Werte: "Success", "UpToDate", "InProgress", "Fail". Wenn der status "Fail" lautet, gibt die Eigenschaft "failureReason" den Grund für den Fehler an. "exampleCount": Die Anzahl der Beispiele, die für das Training verwendet werden. Im Fall der Absicht None oder der vordefinierten Domänenabsichten und -entitäten enthält diese Nummer das intern vom System bereitgestellte Beispiel sowie Beispiele, die Sie Ihrer LUIS-App hinzugefügt haben. "failureReason": Eine Zeichenfolge, die den Grund angibt, warum das Training fehlgeschlagen ist. Der Wert "FewLabels" bedeutet, dass keine beschrifteten Beispieläußerungen für das Training bereitgestellt wurden. "trainingDateTime": Eine Zeichenfolge, die den Zeitpunkt angibt, zu dem das Modell zuletzt trainiert wurde. Der Wert verwendet das ISO 8601-Format für die Darstellung von Zeiten in UTC (Koordinierte Weltzeit) mit einem UTC-Bezeichner ("Z"), z. B. "2017-08-10T01:08:34Z". Media Types: "application/json", "JSON"
Other Status Codes	ErrorResponse	Fehlerantwort. Media Types: "application/json", "JSON"

Sicherheit

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Beispiele

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

Definitionen

Name	Beschreibung
ErrorResponse	Fehlerantwort beim Aufrufen eines Vorgangs für die API.
ModelTrainingDetails	Details zum Modelltraining.
ModelTrainingInfo	Modelltrainingsinformationen.
TrainingStatus	Das training status.

ErrorResponse

Fehlerantwort beim Aufrufen eines Vorgangs für die API.

Name	Typ	Beschreibung
errorType	string

ModelTrainingDetails

Details zum Modelltraining.

Name	Typ	Beschreibung
exampleCount	integer	Die Anzahl der Beispiele, die zum Trainieren des Modells verwendet werden.
failureReason	string	Grund für den Trainingsfehler.
status	TrainingStatus	Das training status.
statusId	integer	Die Zuganforderung status ID.
trainingDateTime	string	Wann das Modell trainiert wurde.

ModelTrainingInfo

Modelltrainingsinformationen.

Name	Typ	Beschreibung
details	ModelTrainingDetails	Details zum Modelltraining.
modelId	string	Die ID (GUID) des Modells.

TrainingStatus

Das training status.

Name	Typ	Beschreibung
Fail	string
InProgress	string
Queued	string
Success	string
UpToDate	string