View a markdown version of this page

Connect 人工智能代理的日志记录和跟踪 - Amazon Connect

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

Connect 人工智能代理的日志记录和跟踪

要有效地解决 Connect AI 代理问题，请使用以下日志和跟踪选项。

  • ListSpans API（推荐用于 Orchestrator AI 代理）：使用 ListSpansAPI 检索会话的 AI 代理执行跟踪。这是调试 Orchestrator AI 代理交互的推荐起点，因为它提供了代理编排流程、LLM 交互和工具调用的精细可见性，允许您跟踪 AI 代理是如何通过请求推理的，以及它选择和执行了哪些工具。

  • CloudWatch 日志：按照中的步骤为您的 Connect AI 代理启用 CloudWatch 日志记录监控 Connect 人工智能代理。

    传统的自助服务交互会生成事件类型的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 日志记录。