Train - Get Status

Dienst:

Azure AI Services

API-Version:

2.0

Ruft den Schulungsstatus aller Modelle (Intents und Entitäten) für die angegebene LUIS-App ab. Sie müssen die Train-API aufrufen, um die LUIS-App zu trainieren, bevor Sie diese API aufrufen, um den Schulungsstatus zu erhalten. "appID" gibt die LUIS-App-ID an. "versionId" gibt die Versionsnummer der LUIS-App an. Beispiel: "0.1".

GET {Endpoint}/luis/api/v2.0/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 stellt eine Reihe von Schulungsstatusdetails für eine LUIS-App bereit, die Sie zur Schulung übermittelt haben. Jedes Element im Antwortarray stellt den Schulungsstatus für ein Modell (Absicht oder Entität) in der LUIS-App bereit. Hinweis: Der Schulungsstatus wird für vordefinierte Entitäten nicht bereitgestellt, da sie vortrainiert sind. Die Eigenschaft "modelId" gibt an, welcher Absicht oder Entität der Schulungsstatus entspricht. Um den Namen und typ jedes Modells abzurufen, verwenden Sie die Modell-API, die eine Anforderungs-URL in diesem Format aufweist: https://westus.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appId}/versions/{versionId}/models Die Detaileigenschaft für jedes Modell kann die folgenden Felder enthalten: "statusId": Eine ganze Zahl von 0 bis 3, die dem Wert des Statusfelds entspricht. "status": Eine Zeichenfolge mit einem der folgenden Werte: "Success", "UpToDate", "InProgress", "Fail". Wenn der Status "Fail" lautet, stellt die Eigenschaft "failureReason" den Grund für den Fehler bereit. "exampleCount": Die Anzahl der Beispiele, die für schulungen verwendet werden. Im Fall der Absichten oder voreingestellten Domänenabsichten und Entitäten enthält diese Zahl Beispiele, die intern vom System bereitgestellt werden, sowie Beispiele, die Sie Ihrer LUIS-App hinzugefügt haben. "failureReason": Eine Zeichenfolge, die angibt, warum die Schulung fehlgeschlagen ist. Der Wert "FewLabels" bedeutet, dass keine beschrifteten Beispiel-Äußerungen für die Schulung bereitgestellt wurden. "trainingDateTime": Eine Zeichenfolge, die angibt, wie lange 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-Kennzeichner ("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

Typ: apiKey
In: header

Beispiele

Successful Get Application Version Training Status request

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

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 in der API.
ModelTrainingDetails	Modellschulungsdetails.
ModelTrainingInfo	Modellschulungsinformationen.
TrainingStatus	Der Schulungsstatus.

ErrorResponse

Objekt

Fehlerantwort beim Aufrufen eines Vorgangs in der API.

Name	Typ	Beschreibung
errorType	string

ModelTrainingDetails

Objekt

Modellschulungsdetails.

Name	Typ	Beschreibung
exampleCount	integer	Die Anzahl der Beispiele, die zum Trainieren des Modells verwendet werden.
failureReason	string	Grund für den Trainingsausfall.
status	TrainingStatus	Der Schulungsstatus.
statusId	integer	Die Status-ID der Zuganforderung.
trainingDateTime	string (date-time)	Als das Modell trainiert wurde.

ModelTrainingInfo

Objekt

Modellschulungsinformationen.

Name	Typ	Beschreibung
details	ModelTrainingDetails	Modellschulungsdetails.
modelId	string (uuid)	Die ID (GUID) des Modells.

TrainingStatus

Enumeration

Der Schulungsstatus.

Wert	Beschreibung
Queued
InProgress
UpToDate
Fail
Success