本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 CloudWatch 日志监控 Amazon Quick Suite 聊天和反馈

您可以使用 Amazon CloudWatch Logs 在 Amazon Quick Suite 中提供用户对话和回复反馈供您分析。这些日志可以传送到多个目的地 CloudWatch，例如 Amazon S3 或（适用标准费率）。我们建议您在创建 Amazon Quick Suite 聊天代理后立即设置对话和反馈日志。

以下是您可以在 Amazon Quick Suite 中使用对话日志和回复反馈完成的任务示例：

支持的日志目标

Amazon Quick Suite 可以将日志传送到以下目的地：

先决条件

在启用日志记录之前，请确保您已具备以下条件：

配置日志记录

要启用 Amazon Quick Suite 聊天和反馈的日志记录，您需要配置 IAM 权限，创建传送源和目标，并验证日志是否已成功传送。

设置 IAM 权限

要为 Amazon Quick Suite 设置 CloudWatch 日志，请使用以下 IAM 策略示例来授予必要的权限。

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

您还必须在客户托管 AWS KMS 密钥策略中允许delivery.logs.amazonaws.com服务主体。

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

配置日志订阅

例如，具有特定日志目标所需的所有权限的 IAM 策略，请参阅 A mazon Log CloudWatch s 用户指南中的启用 AWS 服务日志记录。

使用PutDeliverySource CloudWatch 日志 API 操作创建传送源。为传输来源命名，然后为 resourceArn 指定应用程序的 ARN。对于logType，请指定CHAT_LOGS或 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"
}

要使用 CloudWatch 日志 API 操作启用用户对话日志记录，请调用PutDeliverySourcePutDeliveryDestination、和 CreateDelivery API 操作。

验证日志传送

配置完成后，请验证日志是否已传送到您的目的地：

日志架构和格式

Amazon Quick Suite 日志遵循结构化架构，所有日志类型共享公共字段，聊天和反馈日志的特定字段共享这些字段。

通用字段

所有日志事件都包含以下常用字段：

聊天日志

聊天记录会话互动并包含以下字段：

以下是聊天日志的示例：

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

反馈日志

反馈日志记录了用户对聊天的反馈，并包含以下字段：

以下是反馈日志的示例：

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

安全性注意事项