Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Surveillance du chat et des commentaires sur Amazon Quick Suite à l'aide CloudWatch des journaux

Vous pouvez utiliser Amazon CloudWatch Logs pour diffuser des conversations avec les utilisateurs et des commentaires de réponse dans Amazon Quick Suite afin que vous puissiez les analyser. Ces journaux peuvent être envoyés vers plusieurs destinations CloudWatch, telles qu'Amazon S3 ou (les tarifs standard s'appliquent). Nous vous recommandons de configurer l'enregistrement des conversations et des commentaires peu après avoir créé votre agent de chat Amazon Quick Suite.

Voici des exemples de tâches que vous pouvez effectuer à l'aide des journaux des conversations et des commentaires de réponse dans Amazon Quick Suite :

Destinations de journal prises en charge

Amazon Quick Suite peut envoyer des journaux vers les destinations suivantes :

Prérequis

Avant de pouvoir activer la journalisation, assurez-vous d'avoir :

Configurer la journalisation

Pour activer la journalisation pour le chat et les commentaires Amazon Quick Suite, vous devez configurer les autorisations IAM, créer une source et une destination de diffusion, et vérifier que les journaux sont correctement envoyés.

Configurer les autorisations IAM

Pour configurer CloudWatch les journaux pour Amazon Quick Suite, utilisez les exemples de politique IAM suivants pour accorder les autorisations nécessaires.

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

Vous devez également autoriser le principal du delivery.logs.amazonaws.com service dans votre politique de AWS KMS clés gérées par le client.

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

Configuration de l'abonnement au journal

Par exemple, des politiques IAM avec toutes les autorisations requises pour votre destination de journalisation spécifique, consultez la section Activer la journalisation à partir AWS des services dans le guide de l'utilisateur Amazon CloudWatch Logs.

Créez une source de diffusion à l'aide de l'opération PutDeliverySource CloudWatch Logs API. Donnez un nom à la source de diffusion etresourceArn, pour, spécifiez l'ARN de votre application. PourlogType, spécifiez 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"
}

Pour activer la journalisation des conversations des utilisateurs à l'aide des opérations de l'API CloudWatch Logs, vous devez appeler les opérations PutDeliverySourcePutDeliveryDestination, et de CreateDelivery l'API.

Vérifier la livraison du journal

Une fois configuré, vérifiez que les journaux sont livrés à votre destination :

Schéma et format du journal

Les journaux Amazon Quick Suite suivent un schéma structuré avec des champs communs partagés entre tous les types de journaux et des champs spécifiques pour les journaux de discussion et de commentaires.

Champs communs

Tous les événements du journal incluent les champs communs suivants :

Journaux de discussion

Les journaux de discussion enregistrent les interactions de conversation et contiennent les champs ci-dessous :

Voici un exemple de journaux de discussion :

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

Journaux de commentaires

Les journaux de commentaires enregistrent les commentaires des utilisateurs sur le chat et contiennent les champs ci-dessous :

Voici un exemple de journaux de commentaires :

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

Considérations sur la sécurité