기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CloudWatch Logs를 사용하여 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 Logs를 설정하려면 다음 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 정책의 예는 Amazon CloudWatch Logs 사용 설명서의 AWS 서비스에서 로깅 활성화를 참조하세요.

PutDeliverySource CloudWatch Logs API 작업을 사용하여 전송 소스를 생성합니다. 전송 소스에 이름을 지정하고 resourceArn에 대해 애플리케이션의 ARN을 지정합니다. 의 경우 CHAT_LOGS 또는 logType를 지정합니다. 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 Logs API 작업을 사용하여 사용자 대화 로깅을 활성화하려면 , PutDeliverySource PutDeliveryDestination및 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."

보안 고려 사항