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 tuAWS 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 de registros, consulte Uso de grupos de registros y flujos de CloudWatch registros en la Guía del usuario de Amazon Logs.

Para almacenar registros de audio, utilice un bucket de Amazon S3 en suAWS 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 sobre la creación de un bucket de S3, consulte Creación de un bucket en la Guía de introducción a 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 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 un servicio mediante elAWS Command Line Interface, debe añadir un sufijo personalizado al rol mediante la siguientecustom-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 conversaciones debe tener eliam:PassRole permiso. 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 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 el registro de texto, introduzca 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 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

   • EstablezcaresourceArn el nombre de recurso de Amazon (ARN) del grupo de CloudWatch registros de Logs que es el destino de los registros de

2. Configure eliamRoleArn miembro delconversationLogs campo con el nombre de recurso de Amazon (ARN) del rol de IAM que tenga los permisos necesarios para habilitar los registros de conversación en los recursos de la.

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. Configure eliamRoleArn miembro delconversationLogs campo con el nombre de recurso de Amazon (ARN) del rol de IAM que tenga los permisos necesarios para habilitar los registros de conversación en los recursos de la.

Deshabilitación de registros de conversación

Para desactivar los registros mediante la consola

1. Abra la consola de Amazon Lex 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.