Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Monitoraggio della chat e del feedback di Amazon Quick Suite tramite CloudWatch Logs

Puoi utilizzare Amazon CloudWatch Logs per fornire conversazioni tra utenti e rispondere ai feedback in Amazon Quick Suite da analizzare. Questi log possono essere consegnati a più destinazioni, ad esempio CloudWatch Amazon S3 o (si applicano le tariffe standard). Ti consigliamo di configurare la registrazione delle conversazioni e dei feedback subito dopo aver creato il tuo agente di chat Amazon Quick Suite.

Di seguito sono riportati alcuni esempi di attività che puoi completare con i log delle conversazioni e il feedback di risposta in Amazon Quick Suite:

Destinazioni di log supportate

Amazon Quick Suite può fornire log alle seguenti destinazioni:

Prerequisiti

Prima di abilitare la registrazione, assicurati di avere:

Configurazione della registrazione

Per abilitare la registrazione per la chat e il feedback di Amazon Quick Suite, devi configurare le autorizzazioni IAM, creare una fonte e una destinazione di consegna e verificare che i log vengano consegnati correttamente.

Configura le autorizzazioni IAM

Per configurare CloudWatch Logs for Amazon Quick Suite, utilizza i seguenti esempi di policy IAM per concedere le autorizzazioni necessarie.

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

È inoltre necessario includere il responsabile del delivery.logs.amazonaws.com servizio nella politica relativa alle AWS KMS chiavi gestite dai clienti.

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

Configura l'abbonamento al registro

Ad esempio, le politiche IAM con tutte le autorizzazioni richieste per la tua destinazione di registrazione specifica, consulta Enable logging from AWS services nella Amazon CloudWatch Logs User Guide.

Crea una fonte di distribuzione con l'operazione dell'PutDeliverySource CloudWatch API Logs. Assegna un nome alla fonte di resourceArn consegna e specifica l'ARN della tua applicazione. PerlogType, specifica 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"
}

Per abilitare la registrazione delle conversazioni degli utenti con le operazioni dell'API CloudWatch Logs, chiamate le operazioni PutDeliverySourcePutDeliveryDestination, e CreateDelivery API.

Verifica la consegna dei log

Una volta configurato, verifica che i log vengano consegnati a destinazione:

Schema e formato del registro

I log di Amazon Quick Suite seguono uno schema strutturato con campi comuni condivisi tra tutti i tipi di log e campi specifici per i log di chat e feedback.

Campi comuni

Tutti gli eventi di registro includono questi campi comuni:

Registri delle chat

I registri delle chat registrano le interazioni delle conversazioni e contengono i seguenti campi:

Di seguito è riportato un esempio di log delle 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"}]
}

Registri di feedback

I registri di feedback raccolgono il feedback degli utenti sulla chat e contengono i seguenti campi:

Di seguito è riportato un esempio di log di 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."

Considerazioni relative alla sicurezza