View a markdown version of this page

AI 代理的记录和跟踪 - Amazon Connect Customer

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

AI 代理的记录和跟踪

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

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

  • CloudWatch 日志：按照中的步骤为您的 AI 代理启用 CloudWatch 日志记录使用监控 AI 代理 CloudWatch。

    传统的自助服务交互会生成事件类型的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}"
}

  • 亚马逊 Lex 日志记录（仅限自助服务）：按照 Amazon Lex V2 中的错误日志记录错误中的步骤启用亚马逊 Lex 日志记录。

  • 连接客户日志：通过在 Connect 客户流程中添加设置日志记录行为流程块来启用 Connect 客户日志记录。