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.

Supervisión del chat y los comentarios de Amazon Quick Suite mediante CloudWatch registros

Puede utilizar Amazon CloudWatch Logs para ofrecer conversaciones de usuarios y comentarios de respuesta en Amazon Quick Suite para que los analice. Estos registros se pueden entregar a varios destinos CloudWatch, como Amazon S3 o (se aplican tarifas estándar). Le recomendamos que configure el registro de conversaciones y comentarios poco después de crear su agente de chat de Amazon Quick Suite.

Los siguientes son ejemplos de tareas que puede completar con registros de conversaciones y comentarios de respuesta en Amazon Quick Suite:

Destinos de registro compatibles

Amazon Quick Suite puede entregar registros a los siguientes destinos:

Requisitos previos

Antes de poder habilitar el registro, asegúrese de que dispone de lo siguiente:

Configuración de registros

Para habilitar el registro de los chats y comentarios de Amazon Quick Suite, debe configurar los permisos de IAM, crear una fuente y un destino de entrega y verificar que los registros se entreguen correctamente.

Configurar permisos de IAM

Para configurar CloudWatch Logs para Amazon Quick Suite, utilice los siguientes ejemplos de políticas de IAM para conceder los permisos necesarios.

{
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [{
        "Sid": "QuicksightLogDeliveryPermissions",
        "Effect": "Allow",
        "Action": "quicksight:AllowVendedLogDeliveryForResource",
        "Resource": "arn:aws:quicksight:region:account-id:account/account-id"
    }]
}

También debes incluir el principio de delivery.logs.amazonaws.com servicio en tu política de AWS KMS claves administradas por el cliente.

{
    "Effect": "Allow"		 	 	 ,
    "Principal": {
        "Service": "delivery.logs.amazonaws.com"
    },
    "Action": [
        "kms:GenerateDataKey",
        "kms:Decrypt"
    ],
    "Resource": "*",
    "Condition": {
        "StringEquals": {
            "kms:EncryptionContext:SourceArn": "arn:partition:logs:region:account-id:*"
        }
    }
}

Configure la suscripción de registros

Por ejemplo, políticas de IAM con todos los permisos necesarios para su destino de registro específico, consulte Habilitar el registro desde AWS los servicios en la Guía del usuario de Amazon CloudWatch Logs.

Cree una fuente de entrega con la operación de la API PutDeliverySource CloudWatch Logs. Asigne un nombre al origen de entrega y para resourceArn, especifique el ARN de la aplicación. ParalogType, especifique CHAT_LOGS o FEEDBACK_LOGS

{
    "logType": "CHAT_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}

{
    "logType": "FEEDBACK_LOGS",
    "name": "my-quick-suite-delivery-source",
    "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id"
}

Para habilitar el registro de las conversaciones de los usuarios con las operaciones de la API de CloudWatch registros PutDeliverySourcePutDeliveryDestination, debe llamar a las operaciones de la CreateDelivery API y.

Verifique la entrega de los registros

Una vez configurado, compruebe que los registros se entreguen a su destino:

Esquema y formato del registro

Los registros de Amazon Quick Suite siguen un esquema estructurado con campos comunes compartidos en todos los tipos de registro y campos específicos para los registros de chat y comentarios.

Campos comunes

Todos los eventos de registro incluyen los siguientes campos comunes:

Registros de chat

Los registros de chat capturan las interacciones de las conversaciones y contienen los siguientes campos:

El siguiente es un ejemplo de registros de chat:

{
    "conversationId": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "systemMessageId": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "latency": "10000", 
    "timeToFirstToken": "10000",
    "messageScope": "General Knowledge, ALL etc",
    "userMessageId": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "userMessage": "What is the status of my project?",
    "agentId": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "flowId": "a11b2bbc-c123-3abc-a12b-12a34b5c678d?",
    "systemTextMessage": "What is the status of my project?",
    "surfaceType": "Slack, WebApp etc.",
    "webSearch": "TRUE"
    "userSelectedResources": [{"resource_type": "Dashboard","resource_id": "146abs-1222-534894"},{"resource_type": "Space","resource_id": "123abs-1234-534894"}],
    "actionConnectors": [{"user_selected_resource_type": "Dashboard","resource_id": "146abs-1222-534894"},{"user_selected_resource_type": "Space","resource_id": "123abs-1234-534894"}]
    "citedResource": [{"cited_resource_name": "Dashboard","cited_resource_id": "146abs-1222-534894","cited_resource_name": "ds1"},{"cited_resource_name": "Space","cited_resource_id": "123abs-1234-534894","cited_resource_name": "space1"}],
    "fileAttachment": [{"file_attachmet_type": "pdf","file_attachment_name": "file1.pdf"},{"file_attachmet_type": "txt","file_attachment_name": "file2.txt"}]
}

Registros de comentarios

Los registros de comentarios recopilan los comentarios de los usuarios en el chat y contienen los siguientes campos:

El siguiente es un ejemplo de registros de comentarios:

Chat Feedback: 
    "conversationId": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "researchId": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "systemMessageId": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "userMessageId" : "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "feedback_type" :"thumbsUp,thumbsDown,ease_of_use etc."
    "feedback_reason" : "Too wordy,Issue with sources,Other etc."
    "feedback_details" : "additional text shared by user"
    "rating" : "thumbsUp,thumbsDown,ease_of_use etc."

Consideraciones de seguridad