Train - Get Status

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

Získá stav trénování všech modelů (záměry a entity) pro zadanou aplikaci LUIS. Abyste získali stav trénování, musíte před voláním tohoto rozhraní API zavolat rozhraní API pro trénování pro trénování aplikace LUIS. "appID" určuje ID aplikace LUIS. "versionId" určuje číslo verze aplikace LUIS. Například 0,1.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
appId	path	True	string uuid	ID aplikace.
Endpoint	path	True	string	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	ID verze.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
Ocp-Apim-Subscription-Key	True	string

Odpovědi

Name	Typ	Description
200 OK	ModelTrainingInfo[]	Úspěšná odpověď poskytuje pole podrobností o stavu trénování pro aplikaci LUIS, kterou jste odeslali k trénování. Každý prvek v poli odpovědí poskytuje stav trénování pro model (záměr nebo entitu) v aplikaci LUIS. Poznámka: Stav trénování není k dispozici pro předem připravené entity, protože jsou předem vytrénované. Vlastnost modelId určuje, kterému záměru nebo entitě odpovídá stav trénování. K získání názvu a typu jednotlivých modelů použijte rozhraní API pro modely, které má adresu URL požadavku v tomto formátu: https://westus.api.cognitive.microsoft.com/luis/api/v3.0-preview/apps/{appId}/versions/{versionId}/models Vlastnost details pro každý model může obsahovat následující pole: statusId: Celé číslo od 0 do 3, které odpovídá hodnotě pole stavu. "status": Řetězec s jednou z následujících hodnot: "Success", "UpToDate", "InProgress", "Fail". Pokud je stav "Fail", vlastnost "failureReason" poskytuje důvod selhání. "exampleCount": Počet příkladů použitých pro trénování. V případě záměru None nebo předem připravených doménových záměrů a entit toto číslo zahrnuje příklad, který interně poskytuje systém, a také příklady, které jste přidali do aplikace LUIS. "failureReason": Řetězec, který označuje důvod selhání trénování. Hodnota FewLabels znamená, že pro trénování nebyly poskytnuty žádné označené ukázkové promluvy. "trainingDateTime": Řetězec označující čas posledního trénování modelu. Hodnota používá formát ISO 8601 pro reprezentaci časů ve standardu UTC (Coordinated Universal Time) s označením UTC ("Z"), například: "2017-08-10T01:08:34Z". Media Types: "application/json", "JSON"
Other Status Codes	ErrorResponse	Odpověď na chybu. Media Types: "application/json", "JSON"

Zabezpečení

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Příklady

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

Definice

Name	Description
ErrorResponse	Chybová odpověď při vyvolání operace v rozhraní API
ModelTrainingDetails	Podrobnosti o trénování modelu.
ModelTrainingInfo	Informace o trénování modelu.
TrainingStatus	Stav trénování.

ErrorResponse

Chybová odpověď při vyvolání operace v rozhraní API

Name	Typ	Description
errorType	string

ModelTrainingDetails

Podrobnosti o trénování modelu.

Name	Typ	Description
exampleCount	integer	Počet příkladů použitých k trénování modelu
failureReason	string	Důvod selhání trénování
status	TrainingStatus	Stav trénování.
statusId	integer	ID stavu žádosti o trén.
trainingDateTime	string	Kdy byl model natrénován.

ModelTrainingInfo

Informace o trénování modelu.

Name	Typ	Description
details	ModelTrainingDetails	Podrobnosti o trénování modelu.
modelId	string	ID (GUID) modelu.

TrainingStatus

Stav trénování.

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