翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 ログ記録を有効にします[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 ログ記録を有効にします。