Train - Get Status

Service:

Cognitive Services - LUIS

API Version:

3.0-preview

Hiermee haalt u de trainingsstatus op van alle modellen (intenties en entiteiten) voor de opgegeven LUIS-app. U moet de train-API aanroepen om de LUIS-app te trainen voordat u deze API aanroept om de trainingsstatus op te halen. 'appID' geeft de LUIS-app-id op. "versionId" geeft het versienummer van de LUIS-app aan. Bijvoorbeeld '0.1'.

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

URI-parameters

Name	In	Vereist	Type	Description
appId	path	True	string uuid	De toepassings-id.
Endpoint	path	True	string	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://westus.api.cognitive.microsoft.com).
versionId	path	True	string	De versie-id.

Aanvraagkoptekst

Name	Vereist	Type	Description
Ocp-Apim-Subscription-Key	True	string

Antwoorden

Name	Type	Description
200 OK	ModelTrainingInfo[]	Een geslaagd antwoord biedt een matrix met trainingsstatusdetails voor een LUIS-app die u hebt ingediend voor training. Elk element in de antwoordmatrix biedt trainingsstatus voor een model (intentie of entiteit) in de LUIS-app. Opmerking: de trainingsstatus is niet opgegeven voor vooraf samengestelde entiteiten omdat deze vooraf zijn getraind. De eigenschap modelId geeft aan met welke intentie of entiteit de trainingsstatus overeenkomt. Als u de naam en het type van elk model wilt ophalen, gebruikt u de modellen-API met een aanvraag-URL in deze indeling: https://westus.api.cognitive.microsoft.com/luis/api/v3.0-preview/apps/{appId}/versions/{versionId}/models De eigenschap details voor elk model kan de volgende velden bevatten: 'statusId': een geheel getal van 0 tot 3 dat overeenkomt met de waarde van het statusveld. "status": een tekenreeks met een van de volgende waarden: "Success", "UpToDate", "InProgress", "Fail". Als de status Mislukt is, biedt de eigenschap failureReason de reden voor de fout. "exampleCount": het aantal voorbeelden dat wordt gebruikt voor training. In het geval van de intentie Geen of vooraf gedefinieerde domeinintensies en entiteiten bevat dit nummer voorbeelden die intern door het systeem zijn verstrekt, evenals voorbeelden die u hebt toegevoegd aan uw LUIS-app. "failureReason": een tekenreeks die de reden aangeeft waarom de training is mislukt. De waarde 'FewLabels' betekent dat er geen gelabelde voorbeelduitingen zijn opgegeven voor training. 'trainingDateTime': een tekenreeks die de tijd aangeeft waarop het model voor het laatst is getraind. De waarde gebruikt de ISO 8601-indeling voor het vertegenwoordigen van tijden in UTC (Coordinated Universal Time) met een UTC-aantekening (Z), bijvoorbeeld: "2017-08-10T01:08:34Z". Media Types: "application/json", "JSON"
Other Status Codes	ErrorResponse	Foutreactie. Media Types: "application/json", "JSON"

Beveiliging

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Voorbeelden

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

Definities

Name	Description
ErrorResponse	Foutreactie bij het aanroepen van een bewerking op de API.
ModelTrainingDetails	Details van modeltraining.
ModelTrainingInfo	Informatie over modeltraining.
TrainingStatus	De trainingsstatus.

ErrorResponse

Foutreactie bij het aanroepen van een bewerking op de API.

Name	Type	Description
errorType	string

ModelTrainingDetails

Details van modeltraining.

Name	Type	Description
exampleCount	integer	Het aantal voorbeelden dat wordt gebruikt om het model te trainen.
failureReason	string	Reden voor de trainingsfout.
status	TrainingStatus	De trainingsstatus.
statusId	integer	De status-id van de treinaanvraag.
trainingDateTime	string	Toen het model werd getraind.

ModelTrainingInfo

Informatie over modeltraining.

Name	Type	Description
details	ModelTrainingDetails	Details van modeltraining.
modelId	string	De id (GUID) van het model.

TrainingStatus

De trainingsstatus.

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