View a markdown version of this page

Connect AI 에이전트에 대한 로깅 및 추적 - Amazon Connect

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

Connect AI 에이전트에 대한 로깅 및 추적

Connect AI 에이전트 문제를 효과적으로 해결하려면 다음 로깅 및 추적 옵션을 사용합니다.

  • ListSpans API(오케스트레이터 AI 에이전트에 권장): ListSpans API를 사용하여 세션에 대한 AI 에이전트 실행 추적을 검색합니다. 이는 오케스트레이터 AI 에이전트 상호 작용을 디버깅하는 데 권장되는 시작점으로, 에이전트 오케스트레이션 흐름, LLM 상호 작용 및 도구 호출에 대한 세분화된 가시성을 제공하므로 요청을 통해 AI 에이전트가 추론한 방식과 선택 및 실행한 도구를 추적할 수 있습니다.

  • CloudWatch Logs:의 단계에 따라 Connect AI 에이전트에 대해 CloudWatch 로깅을 활성화합니다Connect AI 에이전트 모니터링.

    레거시 셀프 서비스 상호 작용은 이벤트 유형이 다음 형식인 로그 항목을 생성합니다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 로깅을 활성화합니다.

  • Amazon Connect 로깅: Amazon Connect 흐름에 로깅 동작 설정 흐름 블록을 추가하여 Amazon Connect 로깅을 활성화합니다.