使用 CloudWatch Logs 監控 Connect 中的 Amazon Q - Amazon Connect
必要IAM許可Enable logging (啟用日誌記錄)支援的日誌類型檢查 CloudWatch 日誌配額助理日誌範例偵錯助理日誌的常見查詢範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 CloudWatch Logs 監控 Connect 中的 Amazon Q

若要了解 Amazon Q in Connect 提供給客服人員的即時建議，以及客戶透過自然語言理解所偵測到的意圖，您可以查詢 CloudWatch Logs。 CloudWatch Logs 可讓您了解整個聯絡旅程：對話、觸發條件、意圖、建議。您也可以使用此資訊進行偵錯，或在您聯絡他們尋求協助 AWS Support 時將其提供給 。

本主題說明如何在 Connect 中啟用 Amazon Q 的記錄。

必要IAM許可

在啟用 Amazon Q in Connect 助理的記錄之前，請檢查您是否具有下列 AWS Identity and Access Management 許可。登入 Amazon Connect 主控台的使用者帳戶需要它們：

  • wisdom:AllowVendedLogDeliveryForResource：允許為助理資源交付日誌所需的 。

若要檢視具有特定記錄目的地所有必要許可的範例IAM角色，請參閱需要額外許可 【V2】 的記錄。該主題包含不同日誌目的地的範例，例如傳送至 CloudWatch 日誌和傳送至 Amazon S3 的日誌。範例顯示如何允許更新特定日誌目的地資源。

啟用 Connect 中 Amazon Q 的記錄

若要啟用 Connect 中 Amazon Q 的記錄，您可以使用 CloudWatch API。完成下列步驟。

  1. 取得 Amazon Q in Connect 助理 （也稱為其網域 ） ARN的 。 建立助理 後，您可以從 Amazon Connect ARN 主控台取得，也可以呼叫 GetAssistant API取得。ARN 遵循此格式：

    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 Logs、Amazon S3 或 Amazon Data Firehose 作為儲存日誌的目的地。您必須指定要存放日誌的其中一個目的地選項ARN的 。您可以選擇日誌outputFormat的 作為下列其中一項：json、plain、w3c、raw、parquet。

    下列範例示範如何設定日誌以 Amazon CloudWatch Logs 群組和 JSON 格式存放。

    {
    "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 in Connect 支援下列日誌類型：

  • EVENT_LOGS：在通話和聊天期間追蹤 Amazon Q in Connect 助理事件的日誌。

檢查 CloudWatch 日誌配額

我們建議您檢查 Amazon CloudWatch Logs 端點和配額，以查看是否有任何配額可用於進行 CloudWatch Logs 交付相關API呼叫。Quotas 會設定您可以呼叫 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"