다음을 통해 공유

Train - Get Status

서비스:
Azure AI Services
API 버전:
2.0

지정된 LUIS 앱에 대한 모든 모델(의도 및 엔터티)의 학습 상태를 가져옵니다. 학습 상태를 얻으려면 이 API를 호출하기 전에 학습 API를 호출하여 LUIS 앱을 학습시켜야 합니다. "appID"는 LUIS 앱 ID를 지정합니다. "versionId"는 LUIS 앱의 버전 번호를 지정합니다. 예를 들어 "0.1"입니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
appId
 path True

string (uuid)

애플리케이션 ID입니다.
Endpoint
 path True

string

지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).
versionId
 path True

string

버전 ID입니다.

요청 헤더

Name 필수 형식 Description
Ocp-Apim-Subscription-Key True

string

응답

Name 형식 Description
200 OK

ModelTrainingInfo[]

성공적인 응답은 학습을 위해 제출한 LUIS 앱에 대한 학습 상태 세부 정보의 배열을 제공합니다. 응답 배열의 각 요소는 LUIS 앱의 모델(의도 또는 엔터티)에 대한 학습 상태를 제공합니다. 참고: 미리 빌드된 엔터티에 대한 학습 상태는 미리 학습되어 있으므로 제공되지 않습니다. "modelId" 속성은 학습 상태가 해당하는 의도 또는 엔터티를 식별합니다. 각 모델의 이름과 형식을 가져오려면 요청 URL이 있는 모델 API를 사용합니다. https://westus.api.cognitive.microsoft.com/luis/api/v2.0/apps/{appId}/versions/{versionId}/models 각 모델에 대한 세부 정보 속성은 다음 필드를 포함할 수 있습니다. "statusId": 상태 필드의 값에 해당하는 0에서 3까지의 정수입니다. "status": "Success", "UpToDate", "InProgress", "Fail" 값 중 하나가 있는 문자열입니다. 상태가 "Fail"인 경우 "failureReason" 속성은 실패 이유를 제공합니다. "exampleCount": 학습에 사용되는 예제 수입니다. None 의도 또는 미리 빌드된 도메인 의도 및 엔터티의 경우 이 번호에는 LUIS 앱에 추가한 예제뿐만 아니라 시스템에서 내부적으로 제공하는 예제도 포함됩니다. "failureReason": 학습이 실패한 이유를 나타내는 문자열입니다. 값 "FewLabels"는 학습을 위해 레이블이 지정된 예제 발화가 제공되지 않음을 의미합니다. "trainingDateTime": 모델이 마지막으로 학습된 시간을 나타내는 문자열입니다. 값은 UTC(협정 세계시)로 시간을 나타내는 데 ISO 8601 형식을 UTC 지정자("Z")와 함께 사용합니다(예: "2017-08-10T01:08:34Z").

Media Types: "application/json", "JSON"
Other Status Codes

ErrorResponse

오류 응답입니다.

Media Types: "application/json", "JSON"

보안

Ocp-Apim-Subscription-Key

형식: apiKey
In(다음 안에): header

예제

Successful Get Application Version Training Status request

샘플 요청

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

샘플 응답

상태 코드:
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
    }
  }
]

정의

Name Description
ErrorResponse

API에서 작업을 호출할 때 오류 응답입니다.
ModelTrainingDetails

모델 학습 세부 정보입니다.
ModelTrainingInfo

모델 학습 정보입니다.
TrainingStatus

학습 상태입니다.

ErrorResponse

Object

API에서 작업을 호출할 때 오류 응답입니다.

Name 형식 Description
errorType

string

ModelTrainingDetails

Object

모델 학습 세부 정보입니다.

Name 형식 Description
exampleCount

integer

모델을 학습시키는 데 사용되는 예제의 수입니다.
failureReason

string

학습 실패의 원인입니다.
status

TrainingStatus

학습 상태입니다.
statusId

integer

학습 요청 상태 ID입니다.
trainingDateTime

string (date-time)

모델을 학습할 때입니다.

ModelTrainingInfo

Object

모델 학습 정보입니다.

Name 형식 Description
details

ModelTrainingDetails

모델 학습 세부 정보입니다.
modelId

string (uuid)

모델의 ID(GUID)입니다.

TrainingStatus

열거형

학습 상태입니다.

값 Description
Queued
InProgress
UpToDate
Fail
Success