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

# Analisi in tempo reale per il riconoscimento personalizzato delle entità (API)
<a name="detecting-cer-real-time-api"></a>

Puoi utilizzare l'API Amazon Comprehend per eseguire analisi in tempo reale con un modello personalizzato. Innanzitutto, crei un endpoint per eseguire l'analisi in tempo reale. Dopo aver creato l'endpoint, esegui l'analisi in tempo reale.

Per informazioni sul provisioning della velocità effettiva degli endpoint e sui costi associati, consulta. [Utilizzo degli endpoint Amazon Comprehend](using-endpoints.md)

**Topics**
+ [Creazione di un endpoint per il rilevamento personalizzato delle entità](#detecting-cer-real-time-create-endpoint-api)
+ [Esecuzione del rilevamento di entità personalizzate in tempo reale](#detecting-cer-real-time-run)

## Creazione di un endpoint per il rilevamento personalizzato delle entità
<a name="detecting-cer-real-time-create-endpoint-api"></a>

Per informazioni sui costi associati agli endpoint, consulta. [Utilizzo degli endpoint Amazon Comprehend](using-endpoints.md)

### Creazione di un endpoint con AWS CLI
<a name="detecting-cer-real-time-create-endpoint-examples"></a>

Per creare un endpoint utilizzando il AWS CLI, usa il `create-endpoint` comando:

```
$ aws comprehend create-endpoint \
> --desired-inference-units number of inference units \
> --endpoint-name endpoint name \
> --model-arn arn:aws:comprehend:region:account-id:model/example \
> --tags Key=Key,Value=Value
```

Se il comando ha esito positivo, Amazon Comprehend risponde con l'endpoint ARN:

```
{
   "EndpointArn": "Arn"
}
```

Per ulteriori informazioni su questo comando, i relativi argomenti dei parametri e il relativo output, consulta [https://docs.aws.amazon.com/cli/latest/reference/comprehend/create-endpoint.html](https://docs.aws.amazon.com/cli/latest/reference/comprehend/create-endpoint.html)la sezione Command Reference. AWS CLI 

## Esecuzione del rilevamento di entità personalizzate in tempo reale
<a name="detecting-cer-real-time-run"></a>

Dopo aver creato un endpoint per il tuo modello di riconoscimento delle entità personalizzato, utilizzi l'endpoint per eseguire l'[DetectEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectEntities.html)operazione API. È possibile fornire un input di testo utilizzando il `text` parametro o. `bytes` Immettete gli altri tipi di input utilizzando il `bytes` parametro.

Per i file di immagine e i file PDF, è possibile utilizzare il `DocumentReaderConfig` parametro per sovrascrivere le azioni di estrazione del testo predefinite. Per informazioni dettagliate, vedi [Impostazione delle opzioni di estrazione del testo](idp-set-textract-options.md).

### Rilevamento di entità nel testo utilizzando il AWS CLI
<a name="detecting-cer-real-time-run-cli1"></a>

Per rilevare entità personalizzate nel testo, eseguite il `detect-entities` comando con il testo di input nel `text` parametro.

**Example : utilizza la CLI per rilevare le entità nel testo di input**  

```
$ aws comprehend detect-entities \
> --endpoint-arn arn \
> --language-code en \
> --text  "Andy Jassy is the CEO of Amazon."
```
Se il comando ha esito positivo, Amazon Comprehend risponde con l'analisi. Per ogni entità rilevata da Amazon Comprehend, fornisce il tipo di entità, il testo, la posizione e il punteggio di affidabilità.

### Rilevamento di entità in documenti semistrutturati utilizzando il AWS CLI
<a name="detecting-cer-real-time-run-cli2"></a>

Per rilevare entità personalizzate in PDF, Word o file di immagine, esegui il `detect-entities` comando con il file di input nel `bytes` parametro.

**Example : utilizza la CLI per rilevare le entità in un file di immagine**  
Questo esempio mostra come passare il file di immagine utilizzando l'`fileb`opzione per codificare in base64 i byte dell'immagine. Per ulteriori informazioni, consultate [Binary large objects](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-blob) nella Guida per l'utente. AWS Command Line Interface   
Questo esempio passa anche un file JSON denominato `config.json` per impostare le opzioni di estrazione del testo.  

```
$ aws comprehend detect-entities \
> --endpoint-arn arn \
> --language-code en \
> --bytes fileb://image1.jpg   \
> --document-reader-config file://config.json
```
Il file **config.json** contiene il seguente contenuto.  

```
 {
    "DocumentReadMode": "FORCE_DOCUMENT_READ_ACTION",
    "DocumentReadAction": "TEXTRACT_DETECT_DOCUMENT_TEXT"    
 }
```

Per ulteriori informazioni sulla sintassi dei comandi, consulta [DetectEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectEntities.html)*Amazon Comprehend* API Reference.