Train - Get Status

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

Hämtar träningsstatus för alla modeller (avsikter och entiteter) för den angivna LUIS-appen. Du måste anropa tränings-API:et för att träna LUIS-appen innan du anropar det här API:et för att få träningsstatus. "appID" anger LUIS-app-ID. "versionId" anger versionsnumret för LUIS-appen. Till exempel "0.1".

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
appId	path	True	string uuid	Program-ID:t.
Endpoint	path	True	string	Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	Versions-ID.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Ocp-Apim-Subscription-Key	True	string

Svar

Name	Typ	Description
200 OK	ModelTrainingInfo[]	Ett lyckat svar innehåller en matris med information om träningsstatus för en LUIS-app som du har skickat för träning. Varje element i svarsmatrisen ger träningsstatus för en modell (avsikt eller entitet) i LUIS-appen. Obs! Träningsstatus anges inte för fördefinierade entiteter eftersom de är förtränad. Egenskapen "modelId" identifierar vilken avsikt eller entitet träningsstatusen motsvarar. Om du vill hämta namnet och typen för varje modell använder du modell-API:et som har en begärande-URL i det här formatet: https://westus.api.cognitive.microsoft.com/luis/api/v3.0-preview/apps/{appId}/versions/{versionId}/models Informationsegenskapen för varje modell kan innehålla följande fält: "statusId": Ett heltal från 0 till 3 som motsvarar värdet för statusfältet. "status": En sträng med något av följande värden: "Success", "UpToDate", "InProgress", "Fail". Om statusen är "Misslyckas" anger egenskapen "failureReason" orsaken till felet. "exampleCount": Antalet exempel som används för träning. När det gäller avsikten Ingen eller fördefinierade domäninsikter och entiteter innehåller det här numret exempel som tillhandahålls internt av systemet samt exempel som du har lagt till i LUIS-appen. "failureReason": En sträng som anger orsaken till att träningen misslyckades. Värdet "FewLabels" innebär att inga märkta exempelyttranden angavs för träning. "trainingDateTime": En sträng som anger den tid då modellen senast tränades. Värdet använder FORMATET ISO 8601 för att representera tider i UTC (Coordinated Universal Time) med en UTC-designator ("Z"), till exempel: "2017-08-10T01:08:34Z". Media Types: "application/json", "JSON"
Other Status Codes	ErrorResponse	Felsvar. Media Types: "application/json", "JSON"

Säkerhet

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exempel

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

Definitioner

Name	Description
ErrorResponse	Felsvar vid anrop av en åtgärd i API:et.
ModelTrainingDetails	Information om modellträning.
ModelTrainingInfo	Information om modellträning.
TrainingStatus	Träningsstatus.

ErrorResponse

Felsvar vid anrop av en åtgärd i API:et.

Name	Typ	Description
errorType	string

ModelTrainingDetails

Information om modellträning.

Name	Typ	Description
exampleCount	integer	Antalet exempel som används för att träna modellen.
failureReason	string	Orsak till träningsfelet.
status	TrainingStatus	Träningsstatus.
statusId	integer	Status-ID för träningsbegäran.
trainingDateTime	string	När modellen tränades.

ModelTrainingInfo

Information om modellträning.

Name	Typ	Description
details	ModelTrainingDetails	Information om modellträning.
modelId	string	Modellens ID (GUID).

TrainingStatus

Träningsstatus.

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