As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Monitorando o uso do Amazon Quick usando CloudWatch registros

Você pode usar o Amazon CloudWatch Logs para fornecer conversas de bate-papo, feedback de usuários e agent/research horas de uso no Amazon Quick para você analisar. Esses registros podem ser entregues para vários destinos CloudWatch, como Amazon S3 ou Amazon Data Firehose (taxas padrão aplicáveis). Recomendamos que você configure os registros vendidos logo após ativar os recursos do Amazon Quick AI.

Veja a seguir exemplos de tarefas que você pode concluir com os registros do Amazon Quick:

Destinos de log compatíveis

O Amazon Quick pode entregar registros para os seguintes destinos:

Pré-requisitos

Antes de ativar o registro, verifique se você tem:

Configurar o registro em log da

Para habilitar o registro no Amazon Quick Chat and Feedback, você precisa configurar as permissões do IAM, criar uma fonte e um destino de entrega e verificar se os registros estão sendo entregues com sucesso.

Configurar permissões do IAM

Para configurar o CloudWatch Logs para o Amazon Quick, use os seguintes exemplos de políticas do IAM para conceder as permissões necessárias.

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

Você também deve permitir que o diretor delivery.logs.amazonaws.com de serviço inclua sua política de AWS KMS chaves gerenciadas pelo 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:*"
        }
    }
}

Configurar assinatura de registro

Por exemplo, políticas do IAM com todas as permissões necessárias para seu destino de registro específico, consulte Habilitar o registro de AWS serviços no Guia do usuário do Amazon CloudWatch Logs.

Crie uma fonte de entrega com a operação da API PutDeliverySource CloudWatch Logs. Dê um nome à fonte de entrega e, para resourceArn, especifique o ARN da sua aplicação. Para logTypeCHAT_LOGS, especificar AGENT_HOURS_LOGS ou 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 ativar o registro de conversas do usuário com as operações da API CloudWatch Logs PutDeliverySourcePutDeliveryDestination, você chama as operações CreateDelivery da API, e.

Verifique a entrega do registro

Depois de configurado, verifique se os registros estão sendo entregues ao seu destino:

Esquema e formato do log

Os Amazon Quick Logs seguem um esquema estruturado com campos comuns compartilhados em todos os tipos de registros e campos específicos para registros de bate-papo e feedback.

Campos comuns

Todos os eventos de registro incluem esses campos comuns:

Registros de bate-papo

Os registros de bate-papo capturam as interações da conversa e contêm os campos abaixo:

Veja a seguir um exemplo de registros de bate-papo:

{
    "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 feedback

Os registros de feedback capturam o feedback do usuário no chat e contêm os campos abaixo:

Veja a seguir um exemplo de registros de feedback:

{
    "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 do agente/pesquisa

Esse tipo de registro captura os registros de uso de diferentes agentes em sua conta Quick usados para preços:

Veja a seguir um exemplo de registros de horas do agente:

{
    "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"
}

Considerações sobre segurança