기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 사용자 지정 분류기 학습시키기(API)
<a name="train-custom-classifier-api"></a>

사용자 지정 분류기를 만들고 학습하려면 [문서 분류기 만들기](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateDocumentClassifier.html) 작업을 사용하십시오.

[DescribeDocumentClas3](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeDocumentClassifier.html) 작업을 사용하여 요청 진행 상황을 모니터링할 수 있습니다. `Status` 필드가 `TRAINED`으로 전환된 후 분류기를 사용하여 문서를 분류할 수 있습니다. 상태가 `TRAINED_WITH_WARNINGS`인 경우 [분류기 학습 출력](train-classifier-output.md)에 있는 `CreateDocumentClassifier` 작업에서 건너뛴 파일 폴더를 검토하십시오.

**Topics**
+ [를 사용하여 사용자 지정 분류 훈련 AWS Command Line Interface](#get-started-api-customclass-cli)
+ [AWS SDK for Java 또는 Python용 SDK 사용](#get-started-api-customclass-java)

## 를 사용하여 사용자 지정 분류 훈련 AWS Command Line Interface
<a name="get-started-api-customclass-cli"></a>

다음 예제는 AWS CLI를 사용하여 `CreateDocumentClassifier` 작업, `DescribeDocumentClassificationJob`작업 및 기타 사용자 지정 분류기 API를 사용하는 방법을 보여줍니다.

Unix, Linux, macOS용 형식으로 지정된 예제입니다. Windows의 경우 각 줄의 끝에 있는 백슬래시(\$1) Unix 연속 문자를 캐럿(^)으로 바꿉니다.

`create-document-classifier` 작업을 사용하여 일반 텍스트 사용자 지정 분류기를 만듭니다.

```
aws comprehend create-document-classifier \
     --region region \
     --document-classifier-name testDelete \
     --language-code en \
     --input-data-config S3Uri=s3://S3Bucket/docclass/file name \
     --data-access-role-arn arn:aws:iam::account number:role/testFlywheelDataAccess
```

네이티브 사용자 지정 분류기를 만들려면 `create-document-classifier` 요청에 다음과 같은 추가 파라미터를 제공합니다.

1. 문서유형: 값을 SEMI\$1STRUCTURED\$1DOCUMENT로 설정합니다.

1. 문서: 학습 문서(및 선택적으로 테스트 문서)를 위한 S3 위치.

1. OutputDataConfig: 출력 문서의 S3 위치(및 선택적 KMS 키)를 제공합니다.

1. DocumentReaderConfig: 텍스트 추출 설정을 위한 선택적 필드입니다.

```
aws comprehend create-document-classifier \
     --region region \
     --document-classifier-name testDelete \
     --language-code en \
     --input-data-config 
          S3Uri=s3://S3Bucket/docclass/file name \
           DocumentType \
             Documents  \
     --output-data-config S3Uri=s3://S3Bucket/docclass/file name \
     --data-access-role-arn arn:aws:iam::account number:role/testFlywheelDataAccess
```

`DescribeDocumentClassifier` 작업을 사용하여 문서 분류기 ARN으로 사용자 지정 분류기에 대한 정보를 가져옵니다.

```
aws comprehend describe-document-classifier \
     --region region \
     --document-classifier-arn arn:aws:comprehend:region:account number:document-classifier/file name
```

`DeleteDocumentClassifier` 작업을 사용하여 사용자 지정 분류기를 삭제합니다.

```
aws comprehend delete-document-classifier \
     --region region \
     --document-classifier-arn arn:aws:comprehend:region:account number:document-classifier/testDelete
```

`ListDocumentClassifiers` 작업을 사용하여 계정의 모든 사용자 지정 분류기를 나열합니다.

```
aws comprehend list-document-classifiers
     --region region
```

## AWS SDK for Java 또는 Python용 SDK 사용
<a name="get-started-api-customclass-java"></a>

사용자 지정 분류기를 만들고 학습시키는 방법에 대한 SDK 예제는 [AWS SDK 또는 CLI와 `CreateDocumentClassifier` 함께 사용](example_comprehend_CreateDocumentClassifier_section.md)를 참조하세요.