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, utilice un grupo de registro de Registros de Amazon CloudWatch en su cuenta de AWS. 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 registro de Registros de CloudWatch, consulte Trabajar con grupos de registro y flujos de registro en la Guía del usuario de Registros de Amazon CloudWatch.

Para almacenar registros de audio, use un bucket de S3 en su cuenta de AWS. 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 Creación de un rol de IAM y políticas para registros de conversación.

Si crea un rol vinculado a servicios mediante la AWS Command Line Interface, debe agregar un sufijo personalizado al rol mediante la opción custom-suffix, tal como se indica a continuació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

Para activar los registros mediante la consola

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

2. En la lista, elija 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 los registros de texto, introduzca el nombre del grupo de registro de Registros de Amazon CloudWatch.

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

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

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

10. Elija Save (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

   • Establezca el miembro resourceArn en el nombre de recurso de Amazon (ARN) del grupo de registro de Registros de CloudWatch 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 registros de audio con una clave de AWS KMS específica, establezca el miembro kmsKeyArn 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

Para desactivar los registros mediante la consola

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

2. En la lista, elija 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. Elija Save (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.