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 uso de Amazon Quick mediante CloudWatch registros

Puedes usar Amazon CloudWatch Logs para ofrecer conversaciones de chat, comentarios de los usuarios y agent/research horas de uso en Amazon Quick para que las analices. Estos registros se pueden entregar a varios destinos CloudWatch, como Amazon S3 o Amazon Data Firehose (se aplican tarifas estándar). Le recomendamos que configure los registros de venta poco después de activar las funciones de Amazon Quick AI.

Los siguientes son ejemplos de tareas que puede realizar con los registros de Amazon Quick:

Destinos de registro compatibles

Amazon Quick 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 de

Para habilitar el registro del chat rápido y los comentarios de Amazon, debe configurar los permisos de IAM, crear una fuente y un destino de entrega y comprobar que los registros se están entregando correctamente.

Configurar permisos de IAM

Para configurar CloudWatch Logs para Amazon Quick, 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 gestionadas 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. Para logTypeCHAT_LOGS, especifique AGENT_HOURS_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"
}

{
    "logType": "AGENT_HOURS_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 registros

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

Esquema y formato del registro

Los registros rápidos de Amazon 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:

{
    "status_code": "success",
    "namespace": "default",
    "user_type": "ADMIN_PRO",
    "conversation_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "system_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "latency": "10000", 
    "time_to_first_token": "10000",
    "message_scope": "all_resources",
    "user_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "user_message": "Hi chat",
    "agent_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "flow_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d?",
    "system_text_message": "Hello user",
    "surface_type": "WEB_EXPERIENCE",
    "web_search": "true"
    "user_selected_resources": [{"resource_type": "Dashboard","resource_id": "146abs-1222-534894"},{"resource_type": "Space","resource_id": "123abs-1234-534894"}],
    "action_connectors": [{"action_connector_id": "quicksight-website"},{"action_connector_id": "123abs-1234-534894"}]
    "cited_resource": [{"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"}],
    "file_attachment": [{"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:

{
    "status_code": "success",
    "namespace": "default",
    "user_type": "ADMIN_PRO",
    "conversation_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "system_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "user_message_id" : "a11b2bbc-c123-3abc-a12b-12a34b5c678d",
    "feedback_type" :"Not Useful / Useful"
    "feedback_reason" : "Too wordy,Issue with sources,Other etc."
    "feedback_details" : "additional text shared by user"
}

Registros de horas de agentes/investigadores

Este tipo de registro captura los registros de uso de los diferentes agentes de su cuenta Quick que se utilizan para fijar los precios:

El siguiente es un ejemplo de los registros de las horas de los agentes:

{
    "subscription_type": "ENTERPRISE",
    "reporting_service": "RESEARCH",
    "usage_group": "Included",
    "usage_hours": 0.3333,
    "service_resource_arn": "arn:aws:quicksight:eu-west-1:111222333444:research/a11b2bbc-c123-3abc-a12b-12a34b5c678d"
}

Consideraciones de seguridad