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 bate-papo e o feedback do Amazon Quick Suite usando CloudWatch Logs

Você pode usar o Amazon CloudWatch Logs para fornecer conversas de usuários e feedback de respostas no Amazon Quick Suite para você analisar. Esses registros podem ser entregues para vários destinos CloudWatch, como Amazon S3 ou (taxas padrão aplicáveis). Recomendamos que você configure o registro de conversas e comentários logo após criar seu agente de bate-papo do Amazon Quick Suite.

Veja a seguir exemplos de tarefas que você pode concluir com registros de conversas e feedback de respostas no Amazon Quick Suite:

Destinos de log compatíveis

O Amazon Quick Suite pode entregar registros para os seguintes destinos:

Pré-requisitos

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

Configurar registro em log da

Para habilitar o registro para bate-papo e feedback do Amazon Quick Suite, 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 CloudWatch os registros para o Amazon Quick Suite, 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. ParalogType, especifique CHAT_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"
}

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 registros do Amazon Quick Suite 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:

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

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."

Considerações sobre segurança