Surveillez Amazon Q dans Connect à l'aide CloudWatch des journaux - Amazon Connect
IAMAutorisations requisesActiver la journalisationTypes de journaux pris en chargeVérifiez les quotas de CloudWatch logsExemples de journaux d'assistantExemples de requêtes courantes pour déboguer les journaux de l'assistant

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 AWS Support lorsque vous les contactez pour obtenir de l'aide.

Cette rubrique explique comment activer la journalisation pour Amazon Q dans Connect.

IAMAutorisations 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 IAM rôle avec toutes les autorisations requises pour votre destination de journalisation spécifique, voir 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 d'Amazon Q dans Connect, vous utilisez le CloudWatch API. Procédez comme suit.

  1. Obtenez le nom ARN de votre assistant Amazon Q in Connect (également appelé son domaine). Après avoir créé un assistant, vous pouvez l'obtenir ARN depuis la console Amazon Connect ou en appelant le GetAssistantAPI. Le format ARN suivant est le suivant :

    arn:aws:wisdom:your-region:your-account-id:assistant/assistant-id

  2. Appel PutDeliverySource: Utilisez-le CloudWatch API pour créer une source de diffusion pour l'assistant. Passez le nom ARN de l'assistant en tant queresourceArn. PourlogType, spécifiez EVENT_LOGS de 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
}

  3. Appel PutDeliveryDestination: Utilisez-le 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'une ARN des options de destination pour l'emplacement de stockage de vos journaux. Vous pouvez choisir outputFormat l'un des journaux suivants :json,plain, w3craw,parquet.

    L'exemple suivant montre comment configurer les journaux pour qu'ils soient stockés dans un groupe Amazon CloudWatch Logs et au JSON format.

    {
    "deliveryDestinationConfiguration": {
        "destinationResourceArn": "arn:aws:logs:your-region:your-account-id:log-group:your-log-group-name:*"
    },
    "name": "string",
    "outputFormat": "json",
    "tags": {
        "key": "value"
    }
}

  4. Appel CreateDelivery: Utilisez-le CloudWatch API pour lier la source de livraison à la destination de livraison que vous avez créée lors des étapes précédentes. Cette API opération 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 les appels liés à la livraison CloudWatch API des journaux. Les quotas fixent le nombre maximum de fois que vous pouvez appeler une ressource API ou en créer une. Le dépassement de cette limite entraîne une ServiceQuotaExceededException erreur.

Exemples de journaux d'assistant

Voici un exemple de journal des événements. D'autres champs peuvent être visibles en fonction du type d'événement.

{
    "assistant_id": "AssistantId",
    "event_timestamp": 1729530173612,
    "event_type": "TRANSCRIPT_CREATE_SESSION" | "TRANSCRIPT_INTENT_TRIGGERING_REFERENCE" | "TRANSCRIPT_RECOMMENDATION" | "TRANSCRIPT_UTTERANCE" | "TRANSCRIPT_TRIGGER_DETECTION_MODEL_INVOCATION" | "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "session_id": "SessionId",
    "session_name": "SessionName",
    "recommendation": "Recommendation",
    "intent": "Intent",
    "prompt": "Prompt",
    "utterance": "Utterance"
}

D'autres champs peuvent être visibles en fonction du type d'événement. Par exemple, un chat ou un événement vocal contient des informations relatives à l'énoncé. Un événement qui a généré une recommandation contient des informations sur l'intention, le déclencheur ou la recommandation elle-même.

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"