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.

# Análisis en tiempo real para el reconocimiento personalizado de entidades (API)
<a name="detecting-cer-real-time-api"></a>

Puede utilizar la consola Amazon Comprehend para llevar a cabo un análisis en tiempo real con un modelo personalizado. En primer lugar, debe crear un punto de conexión para llevar a cabo el análisis en tiempo real. Tras crear el punto de conexión, realice el análisis en tiempo real.

Para obtener información sobre el aprovisionamiento, el rendimiento de los puntos de conexión y los costes asociados, consulte [Uso de puntos de conexión de Amazon Comprehend](using-endpoints.md).

**Topics**
+ [

## Creación de un punto de conexión para la detección personalizada de entidades
](#detecting-cer-real-time-create-endpoint-api)
+ [

## Detección de entidades personalizadas en ejecución en tiempo real
](#detecting-cer-real-time-run)

## Creación de un punto de conexión para la detección personalizada de entidades
<a name="detecting-cer-real-time-create-endpoint-api"></a>

Para obtener información acerca de los costes asociados a los puntos de conexión, consulte [Uso de puntos de conexión de Amazon Comprehend](using-endpoints.md).

### Creación de un punto final con AWS CLI
<a name="detecting-cer-real-time-create-endpoint-examples"></a>

Para crear un punto final mediante el AWS CLI, utilice el `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
```

Si el comando se ejecuta correctamente, Amazon Comprehend responde con el ARN del punto de conexión:

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

Para obtener más información sobre este comando, los argumentos de los parámetros y su salida, consulte [https://docs.aws.amazon.com/cli/latest/reference/comprehend/create-endpoint.html](https://docs.aws.amazon.com/cli/latest/reference/comprehend/create-endpoint.html) en la Referencia de comandos AWS CLI .

## Detección de entidades personalizadas en ejecución en tiempo real
<a name="detecting-cer-real-time-run"></a>

Tras crear un punto final para su modelo de reconocimiento de entidades personalizado, utilice el punto final para ejecutar la operación de la [DetectEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectEntities.html)API. Puede introducir texto utilizando el parámetro `text` o `bytes`. Introduzca los demás tipos de entrada mediante el parámetro `bytes`.

En el caso de los archivos de imagen y los archivos PDF, puede utilizar el parámetro `DocumentReaderConfig` para anular las acciones de extracción de texto predeterminadas. Para obtener más información, consulte [Configuración de las opciones de extracción de texto](idp-set-textract-options.md).

### Detectar entidades en el texto mediante el AWS CLI
<a name="detecting-cer-real-time-run-cli1"></a>

Para detectar entidades personalizadas en el texto, ejecute el comando `detect-entities` con el texto introducido en el parámetro `text`.

**Example : Utilice la CLI para detectar entidades en el texto de entrada**  

```
$ aws comprehend detect-entities \
> --endpoint-arn arn \
> --language-code en \
> --text  "Andy Jassy is the CEO of Amazon."
```
Si el comando se ejecuta correctamente, Amazon Comprehend responde con el análisis. Para cada entidad que Amazon Comprehend detecta, proporciona el tipo de entidad, el texto, la ubicación y la puntuación de confianza.

### Detectar entidades en documentos semiestructurados mediante el AWS CLI
<a name="detecting-cer-real-time-run-cli2"></a>

Para detectar entidades personalizadas en un archivo PDF, Word o de imagen, ejecute el comando `detect-entities` con el archivo de entrada en el parámetro `bytes`.

**Example : Utilice la CLI para detectar entidades en un archivo de imagen**  
Este ejemplo muestra cómo pasar el archivo de imagen utilizando la opción `fileb` de codificación base64 de los bytes de la imagen. Para obtener más información, consulte [Objetos binarios grandes](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-types.html#parameter-type-blob) en la Guía del AWS Command Line Interface usuario.   
En este ejemplo, también se incluye un archivo JSON denominado `config.json`, destinado a configurar las opciones de extracción de texto.  

```
$ aws comprehend detect-entities \
> --endpoint-arn arn \
> --language-code en \
> --bytes fileb://image1.jpg   \
> --document-reader-config file://config.json
```
El archivo **config.json** contiene la salida siguiente.  

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

Para obtener más información sobre la sintaxis de los comandos, consulte la [DetectEntities](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DetectEntities.html)referencia de la *API de Amazon Comprehend*.