使用 CloudWatch 日志在 Connect 中监控 Amazon Q - Amazon Connect
所需的 IAM 权限启用日志记录支持的日志类型检查 CloudWatch 日志配额助理日志示例调试助理日志的常见查询示例

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

使用 CloudWatch 日志在 Connect 中监控 Amazon Q

要了解 Amazon Q in Connect 向您的代理提供的实时建议，以及它通过自然语言理解检测到的客户意图，您可以查询 CloudWatch 日志。 CloudWatch 日志可以让你了解整个联系历程：对话、触发因素、意图、推荐。您也可以使用此信息进行调试，或者在联系他们寻求帮助 支持 时将其提供给他们。

本主题介绍如何为 Amazon Q 的 Connect 启用日志记录。

所需的 IAM 权限

在 Connect 助手中启用 Amazon Q 的登录功能之前，请检查您是否具有以下 AWS Identity and Access Management 权限。登录 Amazon Connect 控制台的用户账户需要这些信息：

  • wisdom:AllowVendedLogDeliveryForResource：要求允许为助理资源传送日志。

要查看具有特定日志记录目标所需全部权限的 IAM 角色示例，请参阅需要额外权限的日志记录 [V2]。该主题包含不同日志记录目标的示例，例如发送到日志的 CloudWatch 日志和发送到 Amazon S3 的日志。这些示例展示了如何允许更新您的特定日志目标资源。

启用 Amazon Q 的 Connect 的日志记录

要在 Connect 中启用 Amazon Q 的日志记录，你可以使用 CloudWatch API。完成以下步骤。

  1. 获取 Amazon Q 的 Connect 助理的 ARN（也称为其域）。创建助手后，您可以从 A mazon Connect 控制台或通过调用 API 来获取它的 ARN。GetAssistantARN 遵循以下格式：

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

  2. 调用 PutDeliverySource：使用此 CloudWatch API 为助手创建传送来源。将助理的 ARN 作为 resourceArn 传输。对于 logType，指定 EVENT_LOGS 从助理收集日志。

    {
    "logType": "EVENT_LOGS",
    "name": "your-assistant-delivery-source",
    "resourceArn": "arn:aws:wisdom:your-region:your-account-id:assistant/assistant_id
}

  3. 调用 PutDeliveryDestination：使用此 CloudWatch API 配置日志的存储位置。您可以选择 CloudWatch 日志、亚马逊 S3 或 Amazon Data Firehose 作为存储日志的目标。您必须为日志的存储位置指定其中一个目标选项的 ARN。您可以选择日志的 outputFormat 作为以下选项之一：json、plain、w3c、raw、parquet。

    以下示例说明如何将日志配置为以 JSON 格式存储在 Amazon CloudWatch 日志组中。

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

  4. 调用 CreateDelivery：使用此 CloudWatch API 将传送源链接到您在之前的步骤中创建的配送目的地。此 API 操作将发送源与最终目的地关联起来。

    {
    "deliveryDestinationArn": "string",
    "deliverySourceName": "string",
    "tags": {
        "string": "string"
    }
}

支持的日志类型

Amazon Q 的 Connect 支持以下日志类型：

  • EVENT_LOGS：跟踪 Amazon Q 的 Connect 助理在通话和聊天期间发生的活动的日志。

检查 CloudWatch 日志配额

我们建议您查看 Amazon CloudWatch Logs 终端节点和配额，以查看是否存在与 CloudWatch 日志传输相关的 API 调用的配额。配额设置了您可以调用 API 或创建资源的最大次数。超过限制会导致 ServiceQuotaExceededException 错误。

助理日志示例

以下是活动日志的示例。根据活动类型，可能会有更多可见字段。

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

根据活动类型，可能会有更多可见字段。例如，聊天或语音活动中包含与话语相关的信息。生成推荐的活动包含有关意图、触发因素或推荐本身的信息。

调试助理日志的常见查询示例

您可以使用查询与日志进行交互。例如，您可以使用 SESSION_NAME 查询会话中的所有活动。

以下是返回特定会话生成的所有日志的两个常用查询。

  • filter session_name = "SessionName"

  • filter session_id = "SessionId"