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à.

# Lavori di analisi per la classificazione personalizzata (API)
<a name="analysis-jobs-custom-class-api"></a>

Dopo aver [creato e addestrato](train-custom-classifier-api.md) un classificatore di documenti personalizzato, è possibile utilizzare il classificatore per eseguire lavori di analisi.

Utilizzate l'[StartDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartDocumentClassificationJob.html)operazione per iniziare a classificare i documenti senza etichetta. Si specifica il bucket S3 che contiene i documenti di input, il bucket S3 per i documenti di output e il classificatore da utilizzare.

Per ottenere il massimo livello di precisione nell'addestramento di un modello, abbina il tipo di input al tipo di modello di classificatore. Il processo di classificazione restituisce un avviso se si inviano documenti nativi a un modello di testo semplice o documenti di testo semplice a un modello di documento nativo. Per ulteriori informazioni, consulta [Modelli di classificazione della formazione](training-classifier-model.md).

 [StartDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartDocumentClassificationJob.html)è asincrono. Una volta avviato il processo, utilizzate l'[DescribeDocumentClassificationJob](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeDocumentClassificationJob.html)operazione per monitorarne l'avanzamento. Quando il `Status` campo della risposta viene visualizzato`COMPLETED`, è possibile accedere all'output nella posizione specificata.

**Topics**
+ [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)

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

I seguenti esempi sono l'`StartDocumentClassificationJob`operazione e altri classificatori personalizzati APIs con. AWS CLI

Gli esempi seguenti utilizzano il formato dei comandi 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 (^).

Esegui un processo di classificazione personalizzato utilizzando l'`StartDocumentClassificationJob`operazione.

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

Ottieni informazioni su un classificatore personalizzato con l'ID del lavoro utilizzando l'`DescribeDocumentClassificationJob`operazione.

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

Elenca tutti i lavori di classificazione personalizzati presenti nel tuo account utilizzando l'`ListDocumentClassificationJobs`operazione.

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

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

Per esempi SDK su come avviare un processo di classificazione personalizzato, consulta. [Utilizzo `StartDocumentClassificationJob` con un AWS SDK o una CLI](example_comprehend_StartDocumentClassificationJob_section.md)