기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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 로깅을 활성화합니다.