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

# Connect AI 代理器的記錄和追蹤
<a name="viewing-logs-for-connect-ai-agents-self-service"></a>

若要有效疑難排解 Connect AI 代理器問題，請使用下列記錄和追蹤選項。
+ **ListSpans API （推薦給協調器 AI 代理器）**：使用 [ListSpans](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_ListSpans.html) API 擷取工作階段的 AI 代理程式執行追蹤。這是偵錯協調器 AI 代理程式互動的建議起點，因為它提供代理程式協同運作流程、LLM 互動和工具調用的精細可見性，可讓您追蹤 AI 代理程式如何透過請求推理，以及選取和執行哪些工具。
+ **CloudWatch Logs**：依照中的步驟啟用 Connect AI 代理器的 CloudWatch Logging[Monitor Connect AI 代理器](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 記錄。