

Aviso de fin de soporte: el 15 de septiembre de 2025, AWS dejaremos de ofrecer soporte para Amazon Lex V1. Después del 15 de septiembre de 2025, ya no podrá acceder a la consola de Amazon Lex V1 ni a los recursos de Amazon Lex V1. Si utiliza Amazon Lex V2, consulte en su lugar la [guía Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

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.

# Configuración de registros de conversación
<a name="conversation-logs-configure"></a>

Los registros de conversación se habilitan y deshabilitan mediante la consola o el campo `conversationLogs` de la operación `PutBotAlias`. Puede activar o desactivar los registros de audio, los registros de texto o ambos. El registro comienza en las nuevas sesiones de bot. Los cambios en la configuración del registro no se reflejan en las sesiones activas.

Para almacenar registros de texto, usa un grupo de CloudWatch registros de Amazon Logs en tu AWS cuenta. Puede utilizar cualquier grupo de registro válido. El grupo de registro debe estar en la misma región que el bot de Amazon Lex. Para obtener más información sobre la creación de un grupo de CloudWatch registros, consulte [Trabajar con grupos de registros y transmisiones](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) de * CloudWatch registros en la Guía del usuario de Amazon Logs*.

Para almacenar registros de audio, utilice un bucket de Amazon S3 en su AWS cuenta. Puede utilizar cualquier bucket de S3 válido. El bucket debe estar en la misma región que el bot de Amazon Lex. Para obtener más información acerca de la creación de un bucket de S3, consulte [Creación de un bucket](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html) en la *Guía de introducción de Amazon Simple Storage Service*.

Debe proporcionar un rol de IAM con políticas que permitan a Amazon Lex escribir en el grupo de registro o en el bucket configurado. Para obtener más información, consulte [Crear un rol de IAM y políticas para registros de conversación](conversation-logs-policies.md#conversation-logs-role-and-policy).

Si crea un rol vinculado a un servicio mediante el AWS Command Line Interface, debe añadir un sufijo personalizado al rol mediante la siguiente `custom-suffix` opción:

```
aws iam create-service-linked-role \
    --aws-service-name lex.amazon.aws.com \
    --custom-suffix suffix
```

El rol de IAM que utilice para habilitar los registros de las conversiones debe tener el permiso `iam:PassRole`. La siguiente política debe estar asociada al rol.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "arn:aws:iam::111122223333:role/role"
        }
    ]
}
```

------

## Habilitación de registros de conversación
<a name="conversation-logs-enable"></a>

**Activar los registros mediante la consola**

1. Abra la consola [https://console.aws.amazon.com/lex de Amazon Lex](https://console.aws.amazon.com/lex).

1. En la lista, seleccione un bot.

1. Elija la pestaña **Settings (Configuración)** y, a continuación, en el menú izquierdo elija **Conversation logs (Registros de conversación)**.

1. En la lista de alias, elija el icono de configuración del alias para el que desea configurar los registros de conversación.

1. Seleccione si desea registrar texto, audio o ambos. 

1. Para el registro de texto, introduce el nombre del grupo CloudWatch de registros de Amazon Logs.

1. Para el registro de audio, introduzca la información del bucket de S3.

1. Opcional. Para cifrar los registros de audio, elija la AWS KMS clave que se utilizará para el cifrado.

1. Elija un rol de IAM con los permisos necesarios.

1. Seleccione **Guardar** para iniciar el registro de conversaciones.

**Para activar registros de texto mediante la API**

1. Llame a la operación [PutBotAlias](API_PutBotAlias.md) con una entrada en el miembro `logSettings` del campo `conversationLogs`
   + Establezca el miembro `destination` en `CLOUDWATCH_LOGS`
   + Establezca el miembro `logType` en `TEXT`
   + Defina al `resourceArn` miembro con el nombre de recurso de Amazon (ARN) del grupo de CloudWatch registros que es el destino de los registros

1. Establezca el miembro `iamRoleArn` del campo `conversationLogs` en el nombre de recurso de Amazon (ARN) de un rol de IAM que tenga los permisos necesarios para habilitar los registros de conversaciones en los recursos especificados.

**Para activar los registros de audio mediante la API**

1. Llame a la operación [PutBotAlias](API_PutBotAlias.md) con una entrada en el miembro `logSettings` del campo `conversationLogs`
   + Establezca el miembro `destination` en `S3`
   + Establezca el miembro `logType` en `AUDIO`
   + Establezca el miembro `resourceArn` en el ARN del bucket de Amazon S3 donde se almacenan los registros de audio
   + Opcional. Para cifrar los registros de audio con una AWS KMS clave específica, defina el `kmsKeyArn` miembro del ARN de la clave que se utiliza para el cifrado.

1. Establezca el miembro `iamRoleArn` del campo `conversationLogs` en el nombre de recurso de Amazon (ARN) de un rol de IAM que tenga los permisos necesarios para habilitar los registros de conversaciones en los recursos especificados.

## Deshabilitación de registros de conversación
<a name="conversation-logs-disable"></a>

**Desactivar los registros mediante la consola**

1. Abra la consola [https://console.aws.amazon.com/lex de Amazon Lex](https://console.aws.amazon.com/lex).

1. En la lista, seleccione un bot.

1. Elija la pestaña **Settings (Configuración)** y, a continuación, en el menú izquierdo elija **Conversation logs (Registros de conversación)**.

1. En la lista de alias, elija el icono de configuración del alias para el que desea configurar los registros de conversación.

1. Quite la marca de la casilla de verificación de texto, audio o ambas para desactivar el registro.

1. Seleccione **Guardar** para detener el registro de conversaciones.

**Para desactivar los registros mediante la API**
+ Llame a la operación `PutBotAlias` sin el campo `conversationLogs`.

**Para desactivar los registros de texto mediante la API**
+ 
  + Si está registrando audio
    + Llame a la operación [PutBotAlias](API_PutBotAlias.md) con una entrada `logSettings` solo para `AUDIO`.
    + La llamada a la operación `PutBotAlias` no debe tener una entrada `logSettings` para `TEXT`.
  + Si no está registrando audio
    + Llame a la operación [PutBotAlias](API_PutBotAlias.md) sin el campo `conversationLogs`.

**Para desactivar los registros de audio mediante la API**
+ 
  + Si está registrando texto
    + Llame a la operación [PutBotAlias](API_PutBotAlias.md) con una entrada `logSettings` solo para `TEXT`.
    + La llamada a la operación `PutBotAlias` no debe tener una entrada `logSettings` para `AUDIO`.
  + Si no está registrando texto
    + Llame a la operación [PutBotAlias](API_PutBotAlias.md) sin el campo `conversationLogs`.