As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Tarefas de análise para classificação personalizada (API)
<a name="analysis-jobs-custom-class-api"></a>

Depois de [criar e treinar](train-custom-classifier-api.md) um classificador de documentos personalizado, use o classificador para executar tarefas de análise.

Use a [StartDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartDocumentClassificationJob.html)operação para começar a classificar documentos sem rótulos. Você especifica o bucket do S3 que contém os documentos de entrada, o bucket do S3 para os documentos de saída e o classificador a ser usado.

Para alcançar o mais alto nível de precisão no treinamento de um modelo, combine o tipo de entrada com o tipo de modelo do classificador. A tarefa classificadora retornará um aviso se você enviar documentos nativos para um modelo de texto sem formatação ou documentos de texto sem formatação para um modelo de documento nativo. Para obter mais informações, consulte [Modelos de classificação de treinamento](training-classifier-model.md).

 [StartDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartDocumentClassificationJob.html)é assíncrono. Depois de iniciar o trabalho, use a [DescribeDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeDocumentClassificationJob.html)operação para monitorar seu progresso. Quando o campo `Status` na resposta exibir `COMPLETED`, você poderá acessar a saída no local especificado.

**Topics**
+ [Usando o AWS Command Line Interface](#get-started-api-customclass-cli)
+ [Usando o AWS SDK para Java ou SDK para Python](#get-started-api-customclass-java)

## Usando o AWS Command Line Interface
<a name="get-started-api-customclass-cli"></a>

Os exemplos a seguir são a `StartDocumentClassificationJob` operação e outro classificador personalizado APIs com o. AWS CLI

Os exemplos a seguir usam o formato de comando para Unix, Linux e macOS. Para Windows, substitua o caractere de continuação Unix de barra invertida (\$1) no final de cada linha por um circunflexo (^).

Execute uma tarefa de classificação personalizada usando a operação `StartDocumentClassificationJob`.

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

Obtenha informações sobre um classificador personalizado com o ID da tarefa usando a operação `DescribeDocumentClassificationJob`.

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

Liste todas as tarefas de classificação personalizada em sua conta usando a operação `ListDocumentClassificationJobs`.

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

## Usando o AWS SDK para Java ou SDK para Python
<a name="get-started-api-customclass-java"></a>

Para exemplos de SDK sobre como iniciar um classificador personalizado, consulte [Use `StartDocumentClassificationJob` com um AWS SDK ou CLI](example_comprehend_StartDocumentClassificationJob_section.md).