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.

# Tâches d'analyse pour une classification personnalisée (API)
<a name="analysis-jobs-custom-class-api"></a>

Après avoir [créé et entraîné](train-custom-classifier-api.md) un classificateur de documents personnalisé, vous pouvez l'utiliser pour exécuter des tâches d'analyse.

Utilisez cette [StartDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartDocumentClassificationJob.html)opération pour commencer à classer les documents non étiquetés. Vous spécifiez le compartiment S3 qui contient les documents d'entrée, le compartiment S3 pour les documents de sortie et le classificateur à utiliser.

Pour obtenir le plus haut niveau de précision lors de l'entraînement d'un modèle, faites correspondre le type d'entrée au type de modèle de classificateur. La tâche de classification renvoie un avertissement si vous soumettez des documents natifs à un modèle de texte brut ou des documents en texte brut à un modèle de document natif. Pour de plus amples informations, veuillez consulter [Modèles de classification des formations](training-classifier-model.md).

 [StartDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartDocumentClassificationJob.html)est asynchrone. Une fois que vous avez commencé la tâche, utilisez l'[DescribeDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeDocumentClassificationJob.html)opération pour suivre sa progression. Lorsque le `Status` champ de la réponse s'affiche`COMPLETED`, vous pouvez accéder à la sortie à l'emplacement que vous avez spécifié.

**Topics**
+ [En utilisant le AWS Command Line Interface](#get-started-api-customclass-cli)
+ [Utilisation du SDK AWS SDK pour Java or pour Python](#get-started-api-customclass-java)

## En utilisant le AWS Command Line Interface
<a name="get-started-api-customclass-cli"></a>

Les exemples suivants illustrent l'`StartDocumentClassificationJob`opération et un autre classificateur personnalisé APIs avec le AWS CLI. 

Les exemples suivants utilisent le format de commande 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 (^).

Exécutez une tâche de classification personnalisée à l'aide de l'`StartDocumentClassificationJob`opération.

```
aws comprehend start-document-classification-job \
     --region region \
     --document-classifier-arn arn:aws:comprehend:region:account number:document-classifier/testDelete \
     --input-data-config S3Uri=s3://S3Bucket/docclass/file name,InputFormat=ONE_DOC_PER_LINE \
     --output-data-config S3Uri=s3://S3Bucket/output \
     --data-access-role-arn arn:aws:iam::account number:role/resource name
```

Obtenez des informations sur un classificateur personnalisé avec l'identifiant de la tâche à l'aide de l'`DescribeDocumentClassificationJob`opération.

```
aws comprehend describe-document-classification-job \
     --region region \
     --job-id job id
```

Répertoriez toutes les tâches de classification personnalisées de votre compte à l'aide de `ListDocumentClassificationJobs` cette opération.

```
aws comprehend list-document-classification-jobs
     --region region
```

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

Pour obtenir des exemples de SDK expliquant comment démarrer une tâche de classificateur personnalisée, consultez. [Utilisation `StartDocumentClassificationJob` avec un AWS SDK ou une CLI](example_comprehend_StartDocumentClassificationJob_section.md)