Train - Get Status

Usługa:

Azure AI Services

Wersja interfejsu API:

2.0

Pobiera stan trenowania wszystkich modeli (intencji i jednostek) dla określonej aplikacji usługi LUIS. Przed wywołaniem tego interfejsu API należy wywołać interfejs API szkolenia, aby wytrenować aplikację usługi LUIS, aby uzyskać stan trenowania. "appID" określa identyfikator aplikacji usługi LUIS. "versionId" określa numer wersji aplikacji LUIS. Na przykład "0.1".

GET {Endpoint}/luis/api/v2.0/apps/{appId}/versions/{versionId}/train

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
appId	path	True	string (uuid)	Identyfikator aplikacji.
Endpoint	path	True	string	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	Identyfikator wersji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Ocp-Apim-Subscription-Key	True	string

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ModelTrainingInfo[]	Pomyślna odpowiedź zawiera tablicę szczegółów stanu trenowania dla aplikacji usługi LUIS przesłanej do trenowania. Każdy element w tablicy odpowiedzi zapewnia stan trenowania modelu (intencji lub jednostki) w aplikacji USŁUGI LUIS. Uwaga: Stan trenowania nie jest udostępniany dla wstępnie utworzonych jednostek, ponieważ są wstępnie wytrenowane. Właściwość "modelId" identyfikuje intencję lub jednostkę, z którą odpowiada stan trenowania. Aby uzyskać nazwę i typ każdego modelu, użyj interfejsu API modeli, który ma adres URL żądania w tym formacie: https://westus.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appId}/versions/{versionId}/models Właściwość szczegółów dla każdego modelu może zawierać następujące pola: "statusId": liczba całkowita z zakresu od 0 do 3, która odpowiada wartości pola stanu. "status": ciąg z jedną z następujących wartości: "Success", "UpToDate", "InProgress", "Fail". Jeśli stan to "Niepowodzenie", właściwość "failureReason" zawiera przyczynę niepowodzenia. "exampleCount": liczba przykładów używanych do trenowania. W przypadku intencji None lub wstępnie utworzonych intencji i jednostek domeny ta liczba zawiera przykład podany wewnętrznie przez system, a także przykłady dodane do aplikacji usługi LUIS. "failureReason": ciąg wskazujący przyczynę niepowodzenia trenowania. Wartość "FewLabels" oznacza, że nie podano żadnych przykładowych wypowiedzi do trenowania. "trainingDateTime": ciąg wskazujący czas ostatniego wytrenowania modelu. Wartość używa formatu ISO 8601 do reprezentowania godzin w formacie UTC (uniwersalny czas koordynowany) z designatorem UTC ("Z"), na przykład: "2017-08-10T01:08:34Z". Media Types: "application/json", "JSON"
Other Status Codes	ErrorResponse	Odpowiedź na błąd. Media Types: "application/json", "JSON"

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Przykłady

Successful Get Application Version Training Status request

Przykładowe żądanie

HTTP

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
ErrorResponse	Odpowiedź na błąd podczas wywoływania operacji w interfejsie API.
ModelTrainingDetails	Szczegóły trenowania modelu.
ModelTrainingInfo	Informacje o trenowaniu modelu.
TrainingStatus	Stan trenowania.

ErrorResponse

Objekt

Odpowiedź na błąd podczas wywoływania operacji w interfejsie API.

Nazwa	Typ	Opis
errorType	string

ModelTrainingDetails

Objekt

Szczegóły trenowania modelu.

Nazwa	Typ	Opis
exampleCount	integer	Liczba przykładów używanych do trenowania modelu.
failureReason	string	Przyczyna niepowodzenia trenowania.
status	TrainingStatus	Stan trenowania.
statusId	integer	Identyfikator stanu żądania pociągu.
trainingDateTime	string (date-time)	Kiedy model został wytrenowany.

ModelTrainingInfo

Objekt

Informacje o trenowaniu modelu.

Nazwa	Typ	Opis
details	ModelTrainingDetails	Szczegóły trenowania modelu.
modelId	string (uuid)	Identyfikator (GUID) modelu.

TrainingStatus

Wyliczanie

Stan trenowania.

Wartość	Opis
Fail
InProgress
Queued
Success
UpToDate