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.

# Cómo entrenar clasificadores personalizados (API)
<a name="train-custom-classifier-api"></a>

Para crear y entrenar un clasificador personalizado, usa la [CreateDocumentClassifier](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateDocumentClassifier.html)operación.

Puede supervisar el progreso de la solicitud mediante la [DescribeDocumentClassifier](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeDocumentClassifier.html)operación. Una vez que el campo `Status` pase a `TRAINED`, puede utilizar el clasificador para clasificar los documentos. Si el estado es `TRAINED_WITH_WARNINGS`, revise la carpeta de archivos omitidos en [Resultado del entrenamiento del clasificador](train-classifier-output.md) en la operación `CreateDocumentClassifier`.

**Topics**
+ [Entrenamiento de clasificación personalizada mediante 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)

## Entrenamiento de clasificación personalizada mediante el AWS Command Line Interface
<a name="get-started-api-customclass-cli"></a>

Los siguientes ejemplos muestran cómo utilizar la `CreateDocumentClassifier` operación, la `DescribeDocumentClassificationJob` operación y otros clasificadores personalizados APIs con el AWS CLI. 

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

Cree un clasificador personalizado de texto sin formato con la operación `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
```

Para crear un clasificador personalizado nativo, proporcione los siguientes parámetros adicionales en la solicitud `create-document-classifier`.

1. DocumentType: establezca el valor en SEMI\$1STRUCTURED\$1DOCUMENT.

1. Documentos: la ubicación S3 de los documentos de entrenamiento (y, opcionalmente, de los documentos de prueba).

1. OutputDataConfig: proporcione la ubicación en S3 para los documentos de salida (y una clave KMS opcional). 

1. DocumentReaderConfig: campo opcional para la configuración de extracción de texto.

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

Obtenga información sobre un clasificador personalizado con el clasificador de documentos ARN mediante la operación `DescribeDocumentClassifier`.

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

Elimine un clasificador personalizado mediante la operación `DeleteDocumentClassifier`.

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

Enumere todos los clasificadores personalizados de la cuenta mediante la operación `ListDocumentClassifiers`.

```
aws comprehend list-document-classifiers
     --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 crear y entrenar un clasificador personalizado, consulte [Úselo `CreateDocumentClassifier` con un AWS SDK o CLI](example_comprehend_CreateDocumentClassifier_section.md).