본문으로 건너뛰기

Python Agent v2.2.1

2026년 9월 29일

LLM Observability​

  • New AWS Bedrock Runtime 계측 지원

    • bedrock-runtime의 Converse, ConverseStream, InvokeModel, InvokeModelWithResponseStream 호출을 LLM API 스텝으로 수집
  • New 액티브 트라젝토리 중지 기능 추가

    • 액티브 LLM 화면에서 실행 중인 트라젝토리를 중지 가능

      • 진행 중인 LLM 호출을 끊고 해당 트랜잭션을 종료하며, 이후 같은 트라젝토리에서 발생하는 LLM 호출도 차단함
    • 중지 지점은 트랜잭션 프로파일에 WhaTap: LLM trajectory stopped by control 메시지 스텝으로 기록되어 애플리케이션 오류와 구분 가능

  • New llm_blocked_users String 옵션 추가

    • 기본값: ""

    • 지정한 사용자 ID의 LLM 호출 차단. 쉼표로 구분하며 대소문자는 구분하지 않음.

      • 예: llm_blocked_users=u-1024,abuse@example.com
    • 차단된 호출은 해당 SDK의 연결 오류(예: APIConnectionError)로 반환하고, 트랜잭션 프로파일에 WhaTap: LLM call blocked for user … 메시지 스텝 기록됨

  • New llm_httpc_step_enabled Boolean 옵션 추가

    • 기본값: true
    • LLM 워크플로우 안에서 발생한 HTTP 호출(MCP, REST 도구 호출 등)을 LLM 스텝과 함께 수집
    • false로 설정하면 LLM API 호출만 수집
  • New 트라젝토리 신규 시작 건수 메트릭 추가

    • 액티브 트라젝토리 메트릭에 5초 동안 새로 시작된 트라젝토리 수(new_count) 추가
  • Fixed openai 3.x, anthropic 1.x 환경에서 LLM API 스텝과 API 상태 코드 통계가 수집되지 않던 현상 수정

  • Fixed 짧게 실행하고 종료하는 프로세스에서 LLM 트랜잭션이 유실되던 현상 수정

    • CLI 실행, 자식 프로세스처럼 한 번 실행하고 끝나는 프로세스에서 트랜잭션 종료 정보와 LLM 로그가 전송되지 않던 문제 해소

공통​

  • New httpx2 라이브러리 계측 추가

  • Changed 스트리밍 HTTP 응답의 경과 시간을 응답 종료 시점 기준으로 측정

    • SSE 등 스트리밍 응답은 헤더를 받은 시점이 아니라 응답이 끝난 시점까지를 스텝 경과 시간으로 수집
  • Fixed Linux에서 whatap_code_start를 true로 설정하면 멀티 워커(uvicorn --workers 등) 환경에서 네이티브 에이전트가 워커 수만큼 중복 기동되던 현상 수정

노트

Agent download: whatap-python v2.2.1