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.
Surveillez Amazon Q dans Connect à l'aide CloudWatch des journaux
Pour avoir une meilleure visibilité sur les recommandations en temps réel qu'Amazon Q in Connect fournit à vos agents et sur les intentions des clients détectées grâce à la compréhension du langage naturel, vous pouvez interroger CloudWatch Logs. CloudWatch Les journaux vous donnent une visibilité sur l'ensemble du parcours de contact : la conversation, les déclencheurs, les intentions, les recommandations. Vous pouvez également utiliser ces informations pour le débogage ou les fournir Support lorsque vous les contactez pour obtenir de l'aide.
Cette rubrique explique comment activer la journalisation pour Amazon Q dans Connect.
Table des matières
Autorisations IAM requises
Avant d'activer la journalisation pour un assistant Amazon Q in Connect, vérifiez que vous disposez des AWS Identity and Access Management autorisations suivantes. Ils sont obligatoires pour le compte utilisateur connecté à la console Amazon Connect :
-
wisdom:AllowVendedLogDeliveryForResource: Nécessaire pour autoriser la livraison des journaux pour la ressource adjointe.
Pour voir un exemple de rôle IAM avec toutes les autorisations requises pour votre destination de journalisation spécifique, consultez la section Journalisation nécessitant des autorisations supplémentaires [V2]. Cette rubrique contient des exemples pour différentes destinations de journalisation, telles que les journaux envoyés à CloudWatch Logs et les journaux envoyés à Amazon S3. Les exemples montrent comment autoriser les mises à jour de votre ressource de destination de journalisation spécifique.
Activer la journalisation pour Amazon Q dans Connect
Pour activer la journalisation pour Amazon Q dans Connect, vous utilisez l' CloudWatch API. Procédez comme suit.
-
Obtenez l'ARN de votre assistant Amazon Q in Connect (également connu sous le nom de domaine). Après avoir créé un assistant, vous pouvez obtenir son ARN depuis la console Amazon Connect ou en appelant l'GetAssistantAPI. L'ARN suit le format suivant :
arn:aws:wisdom:your-region:your-account-id:assistant/assistant-id -
Appel PutDeliverySource: utilisez cette CloudWatch API pour créer une source de diffusion pour l'assistant. Transmettez l'ARN de l'assistant en tant que
resourceArn. PourlogType, spécifiezEVENT_LOGSde collecter les journaux auprès de votre assistant.{ "logType": "EVENT_LOGS", "name": "your-assistant-delivery-source", "resourceArn": "arn:aws:wisdom:your-region:your-account-id:assistant/assistant_id} -
Appel PutDeliveryDestination: utilisez cette CloudWatch API pour configurer l'endroit où les journaux doivent être stockés. Vous pouvez choisir CloudWatch Logs, Amazon S3 ou Amazon Data Firehose comme destination pour le stockage des journaux. Vous devez spécifier l'ARN de l'une des options de destination pour l'emplacement de stockage de vos journaux. Vous pouvez choisir
outputFormatl'un des journaux suivants :json,plain,w3craw,parquet.L'exemple suivant montre comment configurer les journaux à stocker dans un groupe Amazon CloudWatch Logs et au format JSON.
{ "deliveryDestinationConfiguration": { "destinationResourceArn": "arn:aws:logs:your-region:your-account-id:log-group:your-log-group-name:*" }, "name": "string", "outputFormat": "json", "tags": { "key": "value" } } -
Appel CreateDelivery: utilisez cette CloudWatch API pour lier la source de livraison à la destination de livraison que vous avez créée lors des étapes précédentes. Cette opération d'API associe la source de livraison à la destination finale.
{ "deliveryDestinationArn": "string", "deliverySourceName": "string", "tags": { "string": "string" } }
Types de journaux pris en charge
Amazon Q in Connect prend en charge le type de journal suivant :
-
EVENT_LOGS: journaux qui suivent les événements d'un assistant Amazon Q in Connect pendant les appels et les discussions.
Vérifiez les quotas de CloudWatch logs
Nous vous recommandons de vérifier les points de terminaison et les quotas Amazon CloudWatch Logs pour voir s'il existe des quotas pour effectuer des appels d'API liés à la diffusion CloudWatch des journaux. Les quotas définissent le nombre maximal de fois que vous pouvez appeler une API ou créer une ressource. Le dépassement de cette limite entraîne une ServiceQuotaExceededException erreur.
Documenter les CloudWatch événements à l'aide du gestionnaire interactif
Définitions des types d'événements
Le tableau suivant décrit chaque type d'événement. Notez que les différents types d'événements contiennent des champs différents. Reportez-vous à la Définitions des champs section pour obtenir des informations détaillées sur chaque champ.
| EventType | Définition |
|---|---|
| TRANSCRIPT_CRÉER_SESSION | Enregistré lors de la création d'une nouvelle session Amazon Q in Connect. Cela marque le début d'une conversation. |
| TRANSCRIPT_INTENT_TRIGGERING_REFERENCE | Enregistré lorsqu'une intention spécifique du client est détectée dans la conversation, ce qui peut déclencher des réponses ou des flux de travail automatisés. |
| TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION | Enregistré lorsqu'un modèle de langage étendu (LLM) est invoqué pour générer des réponses ou traiter le contenu d'une conversation. Enregistre les entrées et les sorties du LLM. |
| ASSISTANT DE REQUÊTE DE TRANSCRIPTION | Enregistré lorsqu'une recherche manuelle ou une requête directe est envoyée à Amazon Q dans Connect |
| RECOMMANDATION_TRANSCRIPTION | Enregistré lorsque le système fournit une recommandation à un agent ou à un client, qui peut inclure des articles de connaissances, des réponses générées ou des suggestions d'actions. |
| TRANSCRIPT_RESULT_FEEDBACK | Enregistré lorsque des commentaires sont fournis sur l'utilité ou la pertinence d'une recherche ou d'un résultat de requête. |
| TRANSCRIPT_SELF_SERVICE_MESSAGE | Enregistré lorsqu'un client interagit avec les composants en libre-service d'Amazon Q dans Connect |
| TRANSCRIPT_SESSION_INTERROGÉE | Enregistré lorsque le système détecte qu'un agent est connecté à une session (une session est interrogée lorsqu'un appel d' GetRecommendations API a été effectué) |
| TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION | Enregistré lorsque le modèle de détection du déclencheur est invoqué pour déterminer si une conversation a des intentions |
| TRANSCRIPTION_ÉNONCIATION | Enregistré lorsqu'un message est envoyé par un participant à la conversation, enregistrement du contenu réel de la conversation. |
Définitions des champs
Le tableau suivant décrit chaque champ.
| Champ | Définition |
|---|---|
| ai_agent_id | Identifiant unique pour la ressource d'agent Amazon Q in Connect AI. |
| identifiant_assistant | Identifiant unique pour la ressource d'assistant Amazon Q in Connect. |
| réalisation | Le texte de complétion brut renvoyé par le LLM ou généré pour le message. |
| connect_utilisateur_arn | Amazon Resource Name (ARN) de l'utilisateur Connect accédant à la session. |
| event_timestamp | Horodatage Unix (en millisecondes) lorsque l'événement s'est produit. |
| event_type | Type de l'événement, indiquant quelle action ou quel processus s'est produit dans le système. |
| identifiant_génération | Identifiant unique pour une réponse spécifique générée par l'IA. |
| intention | Le texte ou la description de l'intention. |
| intent_cliqué | Booléen indiquant si la recommandation a été déclenchée par une intention cliquée. |
| identifiant_intention | Identifiant unique pour l'intention détectée. |
| probabilité_problème | Probabilité numérique (0,0-1,0) qu'un problème ait été détecté dans la conversation (une probabilité supérieure à 0,5 provoquera la génération d'une intention) |
| La recommandation est-elle utile | Booléen indiquant si l'utilisateur a trouvé le résultat utile. |
| est un déclencheur valide | Booléen indiquant si l'analyse du modèle de détection a abouti à un déclencheur valide. |
| identifiant_modèle | Identifiant du modèle d'IA utilisé pour invoquer le LLM. |
| réponse_analysée | processed/parsed Version de la réponse du modèle linguistique, souvent dans un format structuré. |
| rapide | L'invite de saisie utilisée pour appeler le LLM. |
| prompt_type | Type d'invite Amazon Q dans Connect utilisée pour traiter le message ou la requête. |
| recommandation | Le contenu réel du texte de recommandation fourni à l'utilisateur |
| id_de recommandation | Identifiant unique pour la recommandation. |
| réponse | Le texte de réponse final généré pour l'utilisateur après le traitement. |
| identifiant_événement_session | Identifiant unique pour un événement spécifique au cours de la session. |
| identifiants d'événement_session | Liste des identifiants d'événements de session. |
| session_id | Identifiant unique pour la session Amazon Q in Connect. |
| ID du message_session | Identifiant unique pour un message en libre-service au cours d'une session. |
| nom_session | Nom de la session. |
| énoncé | Le texte réel du message échangé au cours de la conversation. |
Exemples de journaux d'assistant
Vous trouverez ci-dessous des exemples de journaux d'événements différents pour chaque type d'événement. Reportez-vous à la Définitions des types d'événements section pour obtenir des explications détaillées sur chaque type d'événement.
CreateSession
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173612, "event_type": "TRANSCRIPT_CREATE_SESSION", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa", "session_name": "nabbccdd-9999-4b23-aaee-112233445566" }
IntentTriggeringReference
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173623, "event_type": "TRANSCRIPT_INTENT_TRIGGERING_REFERENCE", "intent": "To learn about how to autoscale DynamoDB.", "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
LargeLanguageModelInvocation
Reformulation de requêtes
{ "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab", "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "completion": "<query>The customer is asking for information on how to autoscale DynamoDB.</query>", "event_timestamp": 1729530173645, "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION", "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef", "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5" "model_id": "us.amazon.nova-lite-v1:0", "parsed_response": "The customer is asking for information on how to autoscale DynamoDB.", "prompt": "{\"anthropic_version\":\"bedrock-2023-05-31\",\"max_tokens\":1024,\"system\":\"You are a...\"}", "prompt_type": "BEDROCK_KB_QUERY_REFORMULATION", "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
Détection d'intention
{ "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab", "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "completion": "no</malice>\n - Step 2. <specific>yes</specific>\n - Step 3. <intent>To learn how to autoscale DynamoDB.</intent>", "event_timestamp": 1729530173645, "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION", "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef", "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5" "model_id": "us.amazon.nova-lite-v1:0", "parsed_response": "To learn how to autoscale DynamoDB.", "prompt": "{\"anthropic_version\":\"bedrock-2023-05-31\",\"max_tokens\":1024,\"system\":\"You are a...\"}", "prompt_type": "GENERATIVE_INTENT_DETECTION", "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
Génération d'intentions et de réponses
{ "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab", "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "completion": "{\"citations\":[{\"citation\":{\"generatedResponsePart\":{\"textResponsePart\":{\"span\":{\"end\":1065,\"start\":0},\"text\":\"\\nDynamoDB auto s\"}}}}]}", "event_timestamp": 1729530173645, "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION", "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef", "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5", "model_id": "us.anthropic.claude-3-7-sonnet-20250219-v1:0", "parsed_response": "DynamoDB auto scaling works by creating CloudWatch alarms that monitor your table's activity. When the...", "prompt": "{\"input\":{\"text\":\"The customer is seeking information on how to autoscale DynamoDB. Key utterance: \\\"How can \"}}", "prompt_type": "BEDROCK_KB_GENERATIVE_ANSWER", "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
Génération de recherche manuelle
{ "ai_agent_id": "ai112233-7a85-4b3c-8def-0123456789ab", "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "completion": "no</malice>\n - Step 2. <specific>yes</specific>\n - Step 3. <intent>To learn how to autoscale DynamoDB.</intent>", "event_timestamp": 1729530173645, "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION", "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef", "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5", "model_id": "us.anthropic.claude-3-7-sonnet-20250219-v1:0", "parsed_response": "DynamoDB auto scaling works by creating CloudWatch alarms that monitor...", "prompt": "{\"anthropic_version\":\"bedrock-2023-05-31\",\"max_tokens\":1024,\"system\":\"You are a...\"}", "prompt_type": "BEDROCK_KB_GENERATIVE_ANSWER", "session_id": "******************-*****************" }
QueryAssistant
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173667, "event_type": "TRANSCRIPT_QUERY_ASSISTANT", "recommendation_id": "r0001112-3f4e-4fa5-9111-aabbccddeeff", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
Recommandation
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173656, "event_type": "TRANSCRIPT_RECOMMENDATION", "intent_clicked": 1, "intent_id": "i78bc90-1234-4dce-8012-f0e1d2c3b4a5", "recommendation_id": "r0001112-3f4e-4fa5-9111-aabbccddeeff", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
ResultFeedback
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173667, "event_type": "TRANSCRIPT_RESULT_FEEDBACK", "generation_id": "gabc1234-9def-47ff-bb88-abcdefabcdef", "is_recommendation_useful": 1, "recommendation_id": "r0001112-3f4e-4fa5-9111-aabbccddeeff" }
SelfServiceMessage
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "completion": "{\"citations\":[{\"generatedResponsePart\":{\"textResponsePart\":{\"span\":{\"end\":276,\"start\":0},\"text\":\"To autoscale Amazon DynamoDB...\"}}]}", "event_timestamp": 1729530173678, "event_type": "TRANSCRIPT_SELF_SERVICE_MESSAGE", "model_id": "us.amazon.nova-pro-v1:0", "parsed_response": "To autoscale Amazon DynamoDB, follow these steps:...", "prompt": "{\"input\":{\"text\":\"how to autoscale dynamodb\"},\"retrieveAndGenerateConfiguration\":...}", "prompt_type": "SELF_SERVICE_ANSWER_GENERATION", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa", "session_message_id": "mdee1234-5678-4eab-9333-ffeebb998877", "utterance": "[Customer] How can I autoscale DyanmoDB?" }
TranscriptSessionPolled
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "connect_user_arn": "arn:aws:connect:us-east-1:204585150770:instance/seaa9988-2233-4f44-8899-abcabcabcabc/agent/agbbccdd-9999-4b23-aaee-112233445566", "event_timestamp": 1729530173623, "event_type": "TRANSCRIPT_SESSION_POLLED", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa", "session_name": "nabbccdd-9999-4b23-aaee-112233445566" }
TriggerDetectionModelInvocation
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173634, "event_type": "TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION", "is_valid_trigger": 1, "issue_probability": "0.87", "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc", "session_event_ids": ["seaa9988-2233-4f44-8899-abcabcabcabc"], "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa" }
Énoncé
{ "assistant_id": "a1c2d3e4-5b67-4a89-9abc-def012345678", "event_timestamp": 1729530173623, "event_type": "TRANSCRIPT_UTTERANCE", "session_event_id": "seaa9988-2233-4f44-8899-abcabcabcabc", "session_id": "s9f8e7d6-1234-4cde-9abc-ffeeddccbbaa", "utterance": "[Customer] My laptop won't connect to WiFi after the recent update" }
Exemples de requêtes courantes pour déboguer les journaux de l'assistant
Vous pouvez interagir avec les journaux à l'aide de requêtes. Par exemple, vous pouvez rechercher tous les événements d'une session en utilisantSESSION_NAME.
Voici deux requêtes courantes pour renvoyer tous les journaux générés pour une session spécifique.
-
filter session_name = "SessionName" -
filter session_id = "SessionId"
