Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Überwachung des Chats und des Feedbacks in Amazon Quick Suite mithilfe von CloudWatch Protokollen

Sie können Amazon CloudWatch Logs verwenden, um Benutzerkonversationen und Feedback zu Antworten in Amazon Quick Suite bereitzustellen, damit Sie es analysieren können. Diese Protokolle können an mehrere Ziele gesendet werden, z. B. CloudWatch an Amazon S3 oder (es gelten Standardtarife). Wir empfehlen Ihnen, die Konversations- und Feedback-Protokollierung kurz nach der Erstellung Ihres Amazon Quick Suite-Chat-Agenten einzurichten.

Im Folgenden finden Sie Beispiele für Aufgaben, die Sie mit Protokollen von Konversationen und Rückmeldungen zu Antworten in Amazon Quick Suite erledigen können:

Unterstützte Protokollziele

Amazon Quick Suite kann Protokolle an die folgenden Ziele liefern:

Voraussetzungen

Bevor Sie die Protokollierung aktivieren können, stellen Sie sicher, dass Sie über Folgendes verfügen:

Konfigurieren der -Protokollierung

Um die Protokollierung für Amazon Quick Suite-Chat und Feedback zu aktivieren, müssen Sie IAM-Berechtigungen konfigurieren, eine Versandquelle und ein Lieferziel erstellen und überprüfen, ob die Protokolle erfolgreich zugestellt wurden.

Richten Sie IAM-Berechtigungen ein

Um CloudWatch Logs für Amazon Quick Suite einzurichten, verwenden Sie die folgenden IAM-Richtlinienbeispiele, um die erforderlichen Berechtigungen zu erteilen.

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

Sie müssen den delivery.logs.amazonaws.com Service Principal auch in Ihrer vom Kunden verwalteten AWS KMS Schlüsselrichtlinie zulassen.

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

Konfigurieren Sie das Protokollabonnement

Beispiele für IAM-Richtlinien mit allen erforderlichen Berechtigungen für Ihr spezifisches Protokollierungsziel finden Sie unter Aktivieren der Protokollierung von AWS Diensten im Amazon CloudWatch Logs-Benutzerhandbuch.

Erstellen Sie eine Lieferquelle mit dem PutDeliverySource CloudWatch Logs-API-Vorgang. Geben Sie der Lieferquelle einen Namen und geben Sie für resourceArn den ARN Ihrer Anwendung an. Geben Sie für logType CHAT_LOGS oder an 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"
}

Um die Protokollierung von Benutzerkonversationen mit den CloudWatch Logs-API-Vorgängen zu aktivierenPutDeliverySource, rufen Sie die CreateDelivery API-OperationenPutDeliveryDestination, und auf.

Überprüfen Sie die Protokollzustellung

Stellen Sie nach der Konfiguration sicher, dass die Protokolle an Ihr Ziel gesendet werden:

Protokollschema und -format

Amazon Quick Suite-Protokolle folgen einem strukturierten Schema mit gemeinsamen Feldern für alle Protokolltypen und spezifischen Feldern für Chat- und Feedback-Protokolle.

Gemeinsame Felder

Alle Protokollereignisse enthalten die folgenden gemeinsamen Felder:

Chat-Protokolle

Chat-Protokolle erfassen Konversationsinteraktionen und enthalten die folgenden Felder:

Im Folgenden finden Sie ein Beispiel für Chat-Protokolle:

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

Feedback-Protokolle

Feedback-Protokolle erfassen Benutzerfeedback im Chat und enthalten die folgenden Felder:

Im Folgenden finden Sie ein Beispiel für Feedback-Protokolle:

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

Sicherheitsüberlegungen