Python agent release notesRSS

AI 모니터링 서버 측 설정 지원 추가

• 이제 파이썬 에이전트는 AI 모니터링의 서버 측 설정 을 지원합니다. 설정된 경우 서버 측 ai_monitoring.enabled, ai_monitoring.record_content.enabled 및 ai_monitoring.streaming.enabled 값이 로컬 설정보다 우선합니다.

에이전트 프레임워크를 통한 Bedrock 호출에 대한 컨텍스트 전파를 추가합니다.

• Microsoft 에이전트 프레임워크의 Bedrock 통합으로 생성된 스레드 경계를 넘어 트레이스 컨텍스트를 전파합니다. 이를 통해 에이전트의 기존 botocore 계측이 에이전트 프레임워크를 통해 이루어진 Bedrock 호출에 대한 LLM 이벤트를 캡처할 수 있습니다. 이는 에이전트 프레임워크 자체에 대한 전체 계측을 추가하지 않습니다.

Wagtail 사용 시 일관되지 않은 트랜잭션 이름을 수정했습니다.

• 이전에는 Wagtail 을 기반으로 구축된 앱의 트랜잭션 이름이 일관되지 않았으며 다른 페이지 뷰에 대해 동일할 수 있었습니다. 이 문제가 수정되었습니다.

원격 MCP 서버를 기반으로 하는 LangChain 도구의 중복 도구 엔티티를 수정합니다.

• 이전에는 LangChain 도구가 별도로 계측된 원격 MCP 서버에 의해 지원될 때 UI에 중복된 도구 엔티티가 나타났습니다. 알려진 원격 도구가 감지될 때 LangChain 도구에서 하위 구성 요소 속성을 차단하여 이 문제가 해결되었습니다.

LangChain 및 LangGraph MCP 도구 호출에 대한 누락된 사용자 입력 필드를 수정합니다.

• 이전에는 LangChain 또는 LangGraph가 MCP 서버의 도구를 사용했을 때, 입력 메시지가 스트리밍된 시퀀스의 마지막 메시지가 아닌 경우 AI 모니터링 데이터에서 사용자 입력 필드가 누락될 수 있었습니다. 이 문제가 수정되었으며, 이제 에이전트가 이러한 경우에 입력 메시지를 올바르게 추출합니다.

가비지 컬렉션 데이터 샘플러에서 경쟁 조건 위험을 줄입니다.

• 이전에는 에이전트가 설정에 관계없이 가비지 수집기 객체 수를 샘플링하기 위해 항상 gc.get_objects() 을(를) 호출했습니다. 가비지 수집기가 수집한 객체 유형을 추적하지 않는 고객을 위해 불필요한 힙 반복을 방지하도록, top_object_count_limit 이(가) 0보다 높게 설정된 경우에만 gc.get_objects() 이(가) 호출되도록 변경되었습니다.

아웃바운드 Kombu 분산 추적 헤더에서 바이트 인코딩을 제거합니다

• 이전에는 Kombu 계측에 의해 추가된 분산 추적 헤더가 바이트 인코딩되어, 표준 라이브러리 json 모듈을 사용하여 페이로드를 직렬화하는 전송(예: SQLAlchemy 기반 전송)이 손상되었습니다. 이러한 전송이 올바르게 작동하도록 바이트 인코딩이 제거되었습니다.

Google ADK에 대한 계측 추가

• 파이썬 에이전트는 이제 Google ADK (에이전트 개발 키트) AI 에이전트 워크플로우를 계측합니다.

• 계측된 구성 요소는 다음과 같습니다:

  • LlmAgent google.genai을(를) 통해 Gemini 또는 VertexAI 백앤드에 연결됨
  • 사용자 정의 FunctionTool 인스턴스
  • 하위 에이전트 및 AgentTool 인스턴스를 포함하는 하위 에이전트 워크플로우
  • Workflow 클래스와 더 이상 사용되지 않는 LoopAgent, ParallelAgent 및 SequentialAgent 클래스를 포함하는 다중 에이전트 워크플로우

Anthropic, Gemini, OpenAI 및 Bedrock에 대한 토큰 계산 추가

• 파이썬 에이전트는 이제 여러 AI 제공업체의 모든 LLM 호출에 대한 토큰 수를 보고합니다:

  • Anthropic SDK
  • Google 생성형 AI SDK
  • OpenAI SDK
  • botocore 및 aiobotocore를 통한 AWS Bedrock

graphql-core v3.2.10의 계측 충돌 수정

• 이전에 graphql-core v3.2.10에서 ExecutionContext의 errors 속성 이름을 collected_errors (으)로 변경하여 에이전트 충돌이 발생했습니다. 이 문제가 수정되었으며, 이제 에이전트가 graphql-core v3.2.10 이상에서 올바르게 작동합니다.

아웃바운드 tracestate 헤더에서 spanId 제거

• 이전에 에이전트는 아웃바운드 tracestate 헤더에 spanId 을(를) 포함했습니다. spanId 이(가) 이미 traceparent 헤더에 있으므로 이는 불필요한 중복이었습니다. 아웃바운드 헤더 크기를 줄이기 위해 tracestate 에서 spanId 이(가) 제거되었습니다.

LangChain 체인 LLM 이벤트에 추가 모델 정보 추가

• LangChain 체인에서 생성된 LLM 이벤트에 request.model 및 response.model 속성을 추가합니다.
• 이 정보는 최선을 다해 수집되지만 항상 제공되지는 않을 수 있습니다.

LangGraph 스트리밍 계측에서 TypeError 수정

• 이전에 LangGraph에서 스트리밍 API의 하위 집합을 사용할 때, LangGraph의 weakref.WeakMethod 사용으로 인해 에이전트에서 TypeError 이(가) 발생했습니다. 이 문제가 해결되었으며, 이제 에이전트가 해당 LangGraph 스트리밍 메서드에서 정상적으로 작동합니다.

새로운 레디스 v8.8.0 명령어에 대한 계측 추가

• redis-py v8.8.0의 다음 새로운 레디스 명령어 에 대한 계측을 추가합니다:

  • 기타 명령어: INCREX, XNACK
  • 어레이 명령: ARCOUNT, ARDEL, ARDELRANGE, ARGET, ARGETRANGE, ARGREP, ARINFO, ARINSERT, ARLASTITEMS, ARLEN, ARMGET, ARMSET, ARNEXT, AROP, ARRING, ARSCAN, ARSEEK, ARSET

LangGraph 계측의 크래시 수정

• 이전에는 LangGraph 계측을 사용할 때 AsyncBackgroundExecutor의 작업에 대한 컨텍스트 전파 문제로 인해 에이전트가 충돌했습니다. 이 문제는 해결되었으며, 이제 에이전트가 LangGraph와 함께 정상적으로 작동합니다.

하베스트 제한 설정의 처리 및 로깅 개선

• 이제 에이전트는 뉴렐릭 원의 환경 탭에 수집 메서드 및 제한 목록을 더 정확하게 보고합니다.
• 이제 에이전트는 시작 시 수집 제한 설정에 대해 더 일관된 디버그 로깅을 제공합니다.