翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# カスタム分類子の調教 (API)
<a name="train-custom-classifier-api"></a>

カスタム分類子を作成して調教するには、[CreateDocumentClassifier](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateDocumentClassifier.html) 演算機能を使用します。

[DescribeDocumentClassifier](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeDocumentClassifier.html) 演算機能を使用して、リクエストの進行状況を監視できます。`Status` フィールドが `TRAINED` に移行すると、分類子を使用して文書を分類できます。ステータスが `TRAINED_WITH_WARNINGS` の場合、演算 `CreateDocumentClassifier` でスキップした [分類子の調教出力](train-classifier-output.md) の中のファイルフォルダを確認してください。

**Topics**
+ [を使用したカスタム分類のトレーニング AWS Command Line Interface](#get-started-api-customclass-cli)
+ [AWS SDK for Java または SDK for Python の使用](#get-started-api-customclass-java)

## を使用したカスタム分類のトレーニング AWS Command Line Interface
<a name="get-started-api-customclass-cli"></a>

以下の例は、演算機能 `CreateDocumentClassifier`、演算機能 `DescribeDocumentClassificationJob`、その他のカスタム分類子 API を AWS CLIで使用する方法を示しています。

例は、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. DocumentType: 値を 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 または SDK for Python の使用
<a name="get-started-api-customclass-java"></a>

カスタム分類子を作成して調教する方法の SDK の例については、「[AWS SDK または CLI `CreateDocumentClassifier`で を使用する](example_comprehend_CreateDocumentClassifier_section.md)」を参照してください。