Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Trabajos de análisis para una clasificación personalizada (API)
<a name="analysis-jobs-custom-class-api"></a>

Tras [crear y entrenar](train-custom-classifier-api.md) un clasificador de documentos personalizado, puede utilizarlo para ejecutar trabajos de análisis.

Utilice la [StartDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartDocumentClassificationJob.html)operación para empezar a clasificar los documentos sin etiquetar. Debe especificar el bucket de S3 que contiene los documentos de entrada, el bucket de S3 para los documentos de salida y el clasificador que se va a utilizar.

Para lograr el máximo nivel de precisión en el entrenamiento de un modelo, haga coincidir el tipo de entrada con el tipo de modelo del clasificador. El trabajo del clasificador muestra una advertencia si envía documentos nativos a un modelo de texto sin formato o documentos de texto sin formato a un modelo de documento nativo. Para obtener más información, consulte [Modelos de clasificación de entrenamiento](training-classifier-model.md).

 [StartDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartDocumentClassificationJob.html)es asíncrono. Una vez que haya iniciado el trabajo, utilice la [DescribeDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeDocumentClassificationJob.html)operación para supervisar su progreso. Cuando el campo `Status` de la respuesta muestre `COMPLETED`, podrá acceder a la salida en la ubicación que haya especificado.

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

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

A continuación, se muestra un ejemplo de la operación `StartDocumentClassificationJob` y de otras API de clasificadores personalizadas con AWS CLI. 

Los siguientes ejemplos usan el formato de comando para Unix, Linux y macOS. Para Windows, sustituya la barra diagonal invertida (\\) utilizada como carácter de continuación de Unix al final de cada línea por el signo de intercalación (^).

Ejecución de un trabajo de clasificación personalizada mediante la operación `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}}
```

Obtenga información sobre un clasificador personalizado con el identificador del trabajo mediante la operación `DescribeDocumentClassificationJob` .

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

Enumere todos los trabajos de clasificación personalizada de su cuenta mediante la operación `ListDocumentClassificationJobs`.

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

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

Para ver ejemplos del SDK sobre cómo iniciar un trabajo de clasificador personalizado, consulte [Úselo `StartDocumentClassificationJob` con un AWS SDK o CLI](example_comprehend_StartDocumentClassificationJob_section.md).