本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 訓練自訂分類器 (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`，請從 [分類器訓練輸出](train-classifier-output.md)`CreateDocumentClassifier`操作檢閱 中略過的檔案資料夾。

**Topics**
+ [使用 訓練自訂分類 AWS Command Line Interface](#get-started-api-customclass-cli)
+ [使用適用於 Python 的 適用於 Java 的 AWS SDK 或 SDK](#get-started-api-customclass-java)

## 使用 訓練自訂分類 AWS Command Line Interface
<a name="get-started-api-customclass-cli"></a>

下列範例示範如何搭配 使用 `CreateDocumentClassifier`操作、 `DescribeDocumentClassificationJob`操作和其他自訂分類器 APIs AWS CLI。

這些範例已針對 Unix、Linux 和 macOS 格式化。用於 Windows 時，請以插入號 (^) 取代每一行結尾處的 Unix 接續字元斜線 (\$1)。

使用 `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
```

## 使用適用於 Python 的 適用於 Java 的 AWS SDK 或 SDK
<a name="get-started-api-customclass-java"></a>

如需如何建立和訓練自訂分類器 的 SDK 範例，請參閱 [`CreateDocumentClassifier` 搭配 AWS SDK 或 CLI 使用](example_comprehend_CreateDocumentClassifier_section.md)。