Python Agent v2.2.0

2026년 9월 1일

AI Agent Observability

• New LLM 워크플로우 트랜잭션 계측 추가

  • 애플리케이션 트랜잭션 내의 LLM 실행 구간을 트랜잭션 단위로 수집
  노트

  자세한 내용은 LLM 트랜잭션 설정 문서를 참조하세요.

• New 대화 좌표(User / Session / Turn) 수집 추가

  • 사용자 ID와 세션 ID를 HTTP 헤더 또는 LLM SDK 호출 인자에서 자동 수집
  • 턴 ID는 트랜잭션 진입 시 자동 부여
  노트

  자세한 내용은 Session & User ID 설정하기 문서를 참조하세요.

• New 평가(Evaluation) 판정 모델 설정 옵션 추가

  노트

  자세한 내용은 Evaluation 문서를 참조하세요.

• New llm_prompt_default_version 옵션 추가

  • 타입: String, 기본값: v1

• New 액티브 트라잭토리 추적 기능 추가

• New 액티브 LLM API 추적 기능 추가

• New anthropic SDK 자동 계측 추가

• New langgraph 자동 계측 추가

• New hermes-agent 게이트웨이 자동 계측 추가

• Changed 평가 구간 지정이 전역 설정 및 샘플링과 독립적으로 동작하도록 개선

• Fixed LLM API 스텝의 경과 시간이 실제보다 짧게 수집되던 현상 수정

• Fixed 동시 LLM 호출 시 액티브 게이지가 실제보다 적게 집계되던 현상 수정

• Fixed LLM 호출 건수가 유실되던 현상 수정

공통

• New llm_apm_txn_enabled 옵션 추가

  • 타입: Boolean, 기본값: false
  • 옵션을 켜면 APM 프로젝트에서도 LLM 트랜잭션 조회 가능

• New 프로세스 경계(exec / spawn) 트레이스 전파 추가

  • 자식 프로세스로 트랜잭션 연결 정보를 전달해 멀티 프로세스 구조에서 호출 관계 연결

• New 워커 스레드(ThreadPoolExecutor) 트레이스 컨텍스트 전파 추가

  • ThreadPoolExecutor.submit으로 실행된 작업이 상위 트랜잭션에 연결

• Fixed apm_enabled가 false인 설정에서도 APM UDP 소켓을 생성하던 현상 수정

• Fixed hook_method_patterns 등 패턴 옵션에 지정한 모듈명이 자동 계측 대상 모듈과 겹칠 때 해당 모듈의 계측이 유실되던 현상 수정

• Fixed subprocess.Popen 호출 시 env를 위치 인자로 전달하면 애플리케이션 호출이 실패할 수 있던 현상 수정

노트

Agent download: whatap-python v2.2.0