View a markdown version of this page

Connect AI 代理器的記錄和追蹤 - Amazon Connect

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

Connect AI 代理器的記錄和追蹤

若要有效疑難排解 Connect AI 代理器問題，請使用下列記錄和追蹤選項。

  • ListSpans API （推薦給協調器 AI 代理器）：使用 ListSpans API 擷取工作階段的 AI 代理程式執行追蹤。這是偵錯協調器 AI 代理程式互動的建議起點，因為它提供代理程式協同運作流程、LLM 互動和工具調用的精細可見性，可讓您追蹤 AI 代理程式如何透過請求推理，以及選取和執行哪些工具。

  • CloudWatch Logs：依照中的步驟啟用 Connect AI 代理器的 CloudWatch LoggingMonitor Connect AI 代理器。

    舊版自助式互動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}"
}

    客服人員自助式互動會使用事件類型 產生日誌項目TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION。這些項目包括完整的協同運作內容，例如具有工具組態的提示、具有工具呼叫和結果的對話歷史記錄、模型完成和 AI 代理程式組態。下列範例顯示金鑰欄位：

    {
    "assistant_id": "{UUID}",
    "event_timestamp": 1772748470993,
    "event_type": "TRANSCRIPT_LARGE_LANGUAGE_MODEL_INVOCATION",
    "session_id": "{UUID}",
    "prompt": "{full prompt including system instructions, tool configs, and conversation history}",
    "prompt_type": "ORCHESTRATION",
    "completion": "{model response with message and tool use}",
    "model_id": "{model id e.g.: us.anthropic.claude-haiku-4-5-20251001-v1:0}",
    "parsed_response": "{parsed customer-facing message}",
    "generation_id": "{UUID}",
    "ai_agent_id": "{UUID}"
}

  • Amazon Lex 記錄 （僅限自助式）：遵循 Amazon Lex V2 中記錄錯誤與錯誤日誌中的步驟來啟用 Amazon Lex 記錄。

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