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

# Connect 人工智能代理的日志记录和跟踪
<a name="viewing-logs-for-connect-ai-agents-self-service"></a>

要有效地解决 Connect AI 代理问题，请使用以下日志和跟踪选项。
+ **ListSpans API（推荐用于 Orchestrator AI 代理）**：使用 [ListSpans](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListSpans.html)API 检索会话的 AI 代理执行跟踪。这是调试 Orchestrator AI 代理交互的推荐起点，因为它提供了代理编排流程、LLM 交互和工具调用的精细可见性，允许您跟踪 AI 代理是如何通过请求推理的，以及它选择和执行了哪些工具。
+ **CloudWatch 日志**：按照中的步骤为您的 Connect AI 代理启用 CloudWatch 日志记录[监控 Connect 人工智能代理](monitor-ai-agents.md)。

  传统的自助服务交互会生成事件类型的`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 日志](https://docs.aws.amazon.com/lexv2/latest/dg/error-logs.html)记录。
+ **Amazon Connect 日志记录**：通过在 Amazon Connect 流中添加[设置日志记录行为](set-logging-behavior.md)流数据块来启用 Amazon Connect 日志记录。