對 Amazon Q in Connect 自助式問題進行故障診斷 - Amazon Connect
Enable logging (啟用日誌記錄)非預期的呈報意外終止

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

對 Amazon Q in Connect 自助式問題進行故障診斷

使用此主題來協助診斷和解決 Amazon Q in Connect 自助服務功能的常見問題。

啟用 Amazon Q in Connect 自助式互動的記錄

若要有效疑難排解自助式問題，您需要檢視 Amazon Q in Connect 自助式互動的日誌。使用下列指示來啟用 CloudWatch Logging、Amazon Lex 記錄和 Amazon Connect 記錄。

  • CloudWatch Logs：遵循中的步驟，為 Amazon Q in Connect 執行個體啟用 CloudWatch Logging在 Connect 中監控 Amazon Q。

    自助式互動TRANSCRIPT_SELF_SERVICE_MESSAGE會以下列格式產生事件類型的日誌項目：

    {
    "assistant_id": "{UUID}",
    "event_timestamp": 1751414298692,
    "event_type": "TRANSCRIPT_SELF_SERVICE_MESSAGE",
    "session_id": "{UUID}",
    "utterance": "[CUSTOMER]...",
    "prompt": "{prompt used}",
    "prompt_type": "SELF_SERVICE_PRE_PROCESS|SELF_SERVICE_ANSWER_GENERATION",
    "completion": "{Response from model}",
    "model_id": "{model id e.g.: us.amazon.nova-pro-v1:0}",
    "session_message_id": "{UUID}",
    "parsed_response": "{model response}"
}

  • Amazon Lex 記錄：遵循 Amazon Lex V2 中記錄錯誤與錯誤日誌中的步驟來啟用 Amazon Lex 記錄。

  • Amazon Connect 記錄：在 Amazon Connect 流程中新增設定日誌記錄行為流程區塊，以啟用 Amazon Connect 記錄。

客戶意外收到「升級至客服人員...」

當自助式機器人互動期間發生錯誤，或模型未產生 的有效tool_use回應時，就會發生非預期的客服人員呈報SELF_SERVICE_PRE_PROCESS。

疑難排解步驟

  1. 檢查 Amazon Q in Connect 日誌：檢查相關聯日誌項目中的completion屬性。

  2. 驗證停止原因：確認 stop_reason為 tool_use。

  3. 驗證剖析的回應：檢查是否已填入 parsed_response 欄位，因為這代表您將從模型收到的回應。

Claude 3 Haiku 的已知問題

如果您使用 Claude 3 Haiku 進行自助式預先處理，則存在已知問題，它會以文字形式產生 tool_use JSON，導致 stop_reasonend_turn而不是 tool_use。

解決方案：透過新增此指示，更新您的自訂提示，以在<tool>標籤內包裝 tool_use JSON 字串：

You MUST enclose the tool_use JSON in the <tool> tag

自助式聊天或語音通話意外終止

此問題可能是因為逾時或來自 Amazon Lex 的錯誤或不正確的 Amazon Nova Pro 組態而發生。這些問題如下所述。

來自 Amazon Lex 的逾時

  • 徵狀：Amazon Connect 日誌顯示取得客戶輸入內容區塊的「內部伺服器錯誤」

  • 原因：您的自助式機器人在 10 秒限制內提供結果時逾時。逾時錯誤不會出現在 Amazon Q in Connect 日誌中。

  • 解決方案：透過移除複雜的推理來簡化您的提示，以減少處理時間。

來自 Amazon Lex 的錯誤

  • 缺少 Amazon Q in Connect 流程區塊：確保您已將Amazon Q in Connect區塊新增至 Amazon Connect 流程。常見的監督缺少此區塊，這會導致下列錯誤：

    com.amazonaws.services.lexruntimev2.model.ValidationException: Amazon Lex needs active session for Amazon Q in Connect. 
                            Please provide valid session attribute x-amz-lex:q-in-connect:session-arn

  • 一般 Amazon Lex 錯誤：檢查 Amazon Lex 日誌是否有任何錯誤，並相應地解決它們。

Amazon Nova Pro 組態

如果您將 Amazon Nova Pro 用於自訂 AI 提示，請確保 tool_use 範例遵循 Python 相容格式。