Configuración de registros de conversación

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

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.

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

Habilitación de registros de conversación

Activar los registros mediante la consola

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

2. En la lista, seleccione un bot.

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

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

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

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

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

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

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

10. Seleccione Guardar para iniciar el registro de conversaciones.

Para activar registros de texto mediante la API

1. Llame a la operación PutBotAlias 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

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

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

Desactivar los registros mediante la consola

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

2. En la lista, seleccione un bot.

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

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

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

6. 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 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 sin el campo conversationLogs.

Para desactivar los registros de audio mediante la API

• • Si está registrando texto

    • Llame a la operación PutBotAlias 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 sin el campo conversationLogs.