Delen via

Train - Get Status

  • Referentie
Service:
Azure AI Services
API-versie:
2.0

Hiermee haalt u de trainingsstatus van alle modellen (intenties en entiteiten) op 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 op. Bijvoorbeeld '0.1'.

GET {Endpoint}/luis/api/v2.0/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 gedefinieerde entiteiten omdat deze vooraf zijn getraind. Met de eigenschap modelId wordt aangegeven 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/v2.0/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, geeft de eigenschap failureReason de reden voor de fout op. "exampleCount": het aantal voorbeelden dat wordt gebruikt voor training. In het geval van de intentie None of vooraf gedefinieerde domeinintenties en entiteiten bevat dit aantal voorbeelden die intern door het systeem worden geleverd, evenals voorbeelden die u aan uw LUIS-app hebt toegevoegd. "failureReason": een tekenreeks die aangeeft dat de redentraining is mislukt. De waarde 'FewLabels' betekent dat er geen gelabelde voorbeelduitingen zijn opgegeven voor training. "trainingDateTime": Een tekenreeks die aangeeft hoe lang het model voor het laatst is getraind. De waarde gebruikt de ISO 8601-indeling voor het weergeven van tijden in UTC (Coordinated Universal Time) met een UTC-ontwerpator (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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
ErrorResponse

Foutreactie bij het aanroepen van een bewerking op de API.
ModelTrainingDetails

Details van modeltraining.
ModelTrainingInfo

Modeltrainingsgegevens.
TrainingStatus

De trainingsstatus.

ErrorResponse

Object

Foutreactie bij het aanroepen van een bewerking op de API.

Name Type Description
errorType

string

ModelTrainingDetails

Object

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 (date-time)

Toen het model werd getraind.

ModelTrainingInfo

Object

Modeltrainingsgegevens.

Name Type Description
details

ModelTrainingDetails

Details van modeltraining.
modelId

string (uuid)

De id (GUID) van het model.

TrainingStatus

Inventarisatie

De trainingsstatus.

Waarde Description
Fail
InProgress
Queued
Success
UpToDate