Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Addestra classificatori personalizzati (API)
<a name="train-custom-classifier-api"></a>

Per creare e addestrare un classificatore personalizzato, utilizzate l'[CreateDocumentClassifier](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_CreateDocumentClassifier.html)operazione.

È possibile monitorare l'avanzamento della richiesta utilizzando l'[DescribeDocumentClassifier](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeDocumentClassifier.html)operazione. Dopo la transizione del `Status` campo a`TRAINED`, è possibile utilizzare il classificatore per classificare i documenti. Se lo stato è`TRAINED_WITH_WARNINGS`, esaminate la cartella dei file ignorati contenuta nel modulo dell'[Risultati formativi di Classifier](train-classifier-output.md)operazione. `CreateDocumentClassifier`

**Topics**
+ [Addestramento: classificazione personalizzata utilizzando il AWS Command Line Interface](#get-started-api-customclass-cli)
+ [Usare AWS SDK per Java o SDK per Python](#get-started-api-customclass-java)

## Addestramento: classificazione personalizzata utilizzando il AWS Command Line Interface
<a name="get-started-api-customclass-cli"></a>

Negli esempi seguenti viene illustrato come utilizzare l'`CreateDocumentClassifier`operazione, l'`DescribeDocumentClassificationJob`operazione e altri classificatori personalizzati APIs con. AWS CLI

Gli esempi sono formattati per Unix, Linux e macOS. Per Windows, sostituisci il carattere di continuazione UNIX barra rovesciata (\$1) al termine di ogni riga con un accento circonflesso (^).

Crea un classificatore personalizzato in testo semplice utilizzando l'operazione. `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
```

Per creare un classificatore personalizzato nativo, fornite i seguenti parametri aggiuntivi nella richiesta. `create-document-classifier`

1. DocumentType: impostate il valore su SEMI\$1STRUCTURED\$1DOCUMENT.

1. Documenti: la posizione S3 per i documenti di formazione (e, facoltativamente, i documenti dei test).

1. OutputDataConfig: fornisce la posizione S3 per i documenti di output (e una chiave KMS opzionale). 

1. DocumentReaderConfig: Campo opzionale per le impostazioni di estrazione del testo.

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

Ottieni informazioni su un classificatore personalizzato con il classificatore di documenti ARN utilizzando l'operazione. `DescribeDocumentClassifier`

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

Eliminare un classificatore personalizzato utilizzando l'operazione. `DeleteDocumentClassifier`

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

Elenca tutti i classificatori personalizzati presenti nell'account utilizzando l'operazione. `ListDocumentClassifiers`

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

## Usare AWS SDK per Java o SDK per Python
<a name="get-started-api-customclass-java"></a>

Per esempi SDK su come creare e addestrare un classificatore personalizzato, consulta. [Utilizzo `CreateDocumentClassifier` con un AWS SDK o una CLI](example_comprehend_CreateDocumentClassifier_section.md)