API를 사용한 플라이 휠 구성

Amazon Comprehend API를 사용하여 플라이 휠을 생성, 업데이트 및 삭제할 수 있습니다.

플라이 휠을 생성하면 Amazon Comprehend는 각 모델 버전의 학습 데이터 및 테스트 데이터와 같이 플라이 휠에 필요한 모든 데이터를 보관하기 위해 데이터 레이크를 생성합니다.

플라이 휠을 삭제해도 Amazon Comprehend는 데이터 레이크 또는 플라이 휠과 관련된 모델을 삭제하지 않습니다.

플라이 휠이 반복 실행하거나 데이터 세트를 생성하는 중이면 플라이 휠 삭제 작업이 실패합니다.

새 플라이 휠을 생성하기 전에 플라이 휠 생성 섹션의 정보를 검토합니다.

기존 모델의 플라이 휠 생성

CreateFlywheel작업을 사용하여 기존 모델의 플라이휠을 생성합니다.

aws comprehend create-flywheel  \
    --flywheel-name "myFlywheel2"  \
    --active-model-arn  "modelArn"  \
    --data-access-role-arn   arn:aws::iam::111122223333:role/testFlywheelDataAccess \
    --data-lake-s3-uri": "https://s3-bucket-endpoint"   \ 

작업이 성공하면 응답에 플라이 휠 ARN이 포함됩니다.

{
  "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
  "ActiveModelArn": "modelArn"
}     

새 모델용 플라이 휠 생성

CreateFlywheel작업을 사용하여 새 사용자 지정 분류 모델을 위한 플라이휠을 만들 수 있습니다.

aws comprehend create-flywheel \
    --flywheel-name "myFlywheel2" \
    --data-access-role-arn  arn:aws::iam::111122223333:role/testFlywheelDataAccess \
    --model-type "DOCUMENT_CLASSIFIER" \
    --data-lake-s3-uri  "s3Uri"  \
    --task-config  file://taskConfig.json         

TaskConfig.json 파일에는 다음 콘텐츠가 포함되어 있습니다:

{
    "LanguageCode": "en",
    "DocumentClassificationConfig": {
        "Mode": "MULTI_LABEL",
        "Labels": ["optimism", "anger"]
    } 
}       

API 응답 본문에는 다음 콘텐츠가 포함됩니다.

{
  "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
  "ActiveModelArn": "modelArn"
}  

플라이 휠을 설명합니다.

Amazon DescribeFlywheelComprehend 작업을 사용하여 플라이휠에 대한 구성된 정보를 검색할 수 있습니다.

aws comprehend describe-flywheel \
    --flywheel-arn  "flywheelArn" 

API 응답 본문에는 다음 콘텐츠가 포함됩니다.

{
  "FlywheelProperties": {
      "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/myTestFlywheel",
      "DataAccessRoleArn": "arn:aws::iam::111122223333:role/Admin",
      "TaskConfig": {
          "LanguageCode": "en",
          "DocumentClassificationConfig": {
              "Mode": "MULTI_LABEL"
          }
      },
      "DataLakeS3Uri": "s3://my-test-datalake/flywheelbasictest/myTestFlywheel/schemaVersion=1/20220801T014326Z",
      "Status": "ACTIVE",
      "ModelType":  "DOCUMENT_CLASSIFIER",
      "CreationTime": 1659318206.102,
      "LastModifiedTime": 1659318249.05
  }
}    

플라이 휠 업데이트

UpdateFlywheel작업을 사용하여 플라이휠의 수정 가능한 구성 값을 업데이트하십시오.

일부 구성 필드는 하위 필드가 있는 JSON 구조입니다. 하나 이상의 하위 필드를 업데이트하려면 모든 하위 필드에 값을 제공합니다. Amazon Comprehend는 요청에서 누락된 모든 하위 필드에 대해 값을 null로 설정합니다.

UpdateFlywheel요청에 최상위 파라미터를 빠뜨리면 Amazon Comprehend는 플라이 휠에 있는 파라미터 또는 해당 하위 필드의 값을 변경하지 않습니다.

플라이휠에서 태그를 추가하거나 제거하려면 및 작업을 사용합니다. TagResourceUntagResource

다음 예와 같이 ActiveModelArn 파라미터를 설정하여 모델 버전을 승격할 수 있습니다.

aws comprehend update-flywheel \
    --region aws-region \
    --flywheel-arn  "flywheelArn" \
    --active-model-arn  "modelArn" \

API 응답 본문에는 다음 콘텐츠가 포함됩니다.

{
  "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
  "ActiveModelArn": "modelArn"
}    

플라이 휠 삭제

Amazon DeleteFlywheelComprehend 작업을 사용하여 플라이휠을 삭제할 수 있습니다.

aws comprehend delete-flywheel \
    --flywheel-arn  "flywheelArn" 

성공적인 API 응답에는 메시지 본문이 비워 있습니다

플라이 휠 목록

Amazon ListFlywheelsComprehend 작업을 사용하여 현재 지역의 플라이휠 목록을 검색할 수 있습니다.

aws comprehend list-flywheel \
    --region aws-region \
    --endpoint-url  "uri" 
    

API 응답 본문에는 다음 콘텐츠가 포함됩니다.

{
    "FlywheelSummaryList": [
        {
            "FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/myTestFlywheel",
            "DataLakeS3Uri": "s3://my-test-datalake/flywheelbasictest/myTestFlywheel/schemaVersion=1/20220801T014326Z",
            "Status": "ACTIVE",
            ""ModelType":  "DOCUMENT_CLASSIFIER",
            "CreationTime": 1659318206.102,
            "LastModifiedTime": 1659318249.05
        }
    ]
}