Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Entraînez des classificateurs personnalisés (API)
<a name="train-custom-classifier-api"></a>

Pour créer et entraîner un classificateur personnalisé, utilisez l'[CreateDocumentClassifier](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateDocumentClassifier.html)opération.

Vous pouvez suivre la progression de la demande à l'aide de l'[DescribeDocumentClassifier](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeDocumentClassifier.html)opération. Une fois le `Status` champ passé à`TRAINED`, vous pouvez utiliser le classificateur pour classer les documents. Si le statut est le cas`TRAINED_WITH_WARNINGS`, passez en revue le dossier des fichiers ignorés dans le formulaire [Résultat d'entraînement du classificateur](train-classifier-output.md) de l'`CreateDocumentClassifier`opération.

**Topics**
+ [Classification personnalisée de la formation à l'aide du AWS Command Line Interface](#get-started-api-customclass-cli)
+ [Utilisation du SDK AWS SDK pour Java or pour Python](#get-started-api-customclass-java)

## Classification personnalisée de la formation à l'aide du AWS Command Line Interface
<a name="get-started-api-customclass-cli"></a>

Les exemples suivants montrent comment utiliser l'`CreateDocumentClassifier`opération, l'`DescribeDocumentClassificationJob`opération et tout autre classificateur personnalisé APIs avec le AWS CLI. 

Les exemples sont formatés pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation Unix, à savoir la barre oblique inversée (\$1), à la fin de chaque ligne par un accent circonflexe (^).

Créez un classificateur personnalisé en texte brut à l'aide de l'opération. `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
```

Pour créer un classificateur personnalisé natif, fournissez les paramètres supplémentaires suivants dans la `create-document-classifier` demande.

1. DocumentType: définissez la valeur sur SEMI\$1STRUCTURED\$1DOCUMENT.

1. Documents : emplacement S3 pour les documents de formation (et, éventuellement, les documents de test).

1. OutputDataConfig: indiquez l'emplacement S3 des documents de sortie (et une clé KMS optionnelle). 

1. DocumentReaderConfig: champ facultatif pour les paramètres d'extraction de texte.

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

Obtenez des informations sur un classificateur personnalisé avec l'ARN du classificateur de documents à l'aide de l'`DescribeDocumentClassifier`opération.

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

Supprimez un classificateur personnalisé à l'aide de cette `DeleteDocumentClassifier` opération.

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

Répertoriez tous les classificateurs personnalisés du compte à l'aide de l'`ListDocumentClassifiers`opération.

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

## Utilisation du SDK AWS SDK pour Java or pour Python
<a name="get-started-api-customclass-java"></a>

Pour des exemples de SDK expliquant comment créer et entraîner un classificateur personnalisé, consultez. [Utilisation `CreateDocumentClassifier` avec un AWS SDK ou une CLI](example_comprehend_CreateDocumentClassifier_section.md)