> ## Documentation Index > Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt > Use this file to discover all available pages before exploring further. # Weave SDK 릴리스 > Weave Python SDK(`weave` 패키지)의 버전별 릴리스 노트를 확인하세요. 새로운 기능, 버그 수정, 성능 개선 사항이 포함되어 있습니다. 이 페이지에서는 [Weave Python SDK](https://pypi.org/project/weave/)(`weave` 패키지)의 릴리스 노트를 제공합니다. W\&B Models Python SDK(`wandb` 패키지)의 릴리스 노트는 [W\&B SDK 릴리스](/ko/release-notes/sdk-releases)를 참조하세요. 릴리스 패키지와 커밋별 기록은 [`wandb/weave`의 GitHub Releases](https://github.com/wandb/weave/releases)에서 확인할 수 있습니다. 이 항목에서는 사용자에게 영향을 주는 SDK 및 트레이스 서버 변경 사항을 요약하며, 내부 전용 테스트, CI, 리팩터링 작업에 대한 세부 정보는 생략합니다. 병합된 모든 변경 사항은 해당 태그의 GitHub 릴리스 항목을 참조하세요. 태그에 GitHub 릴리스 항목이 없으면 이전 태그와 비교하세요(예: [`v0.53.10...v0.53.11`](https://github.com/wandb/weave/compare/v0.53.10...v0.53.11)).

변경됨

* 대화 SDK span은 `wandb.sdk.name`, `wandb.sdk.version`, `wandb.sdk.language` OpenTelemetry 리소스 속성으로 SDK를 식별합니다.

수정됨

* `opentelemetry-exporter-otlp-proto-http` 1.45.0 릴리스 이후 `weave.init()`이 `AttributeError: 'OTLPSpanExporter' object has no attribute '_session'` 오류로 실패하던 문제를 수정했습니다. 이제 `weave`에는 1.45 미만 버전이 필요합니다. * 시작 시간이 같은 형제 에이전트 span은 종료 시간이 빠른 순으로 정렬됩니다.

추가됨

* 에이전트 span 쿼리 및 통계에서 `insight_filters`를 지원하므로 의도 범주, 실패 범주, 실패 심각도, 의도 및 실패 클러스터, 의도 감성별로 필터링할 수 있습니다. * 트레이스 서버에서 플레이그라운드 Chat Completion을 Dedicated Inference 연결로 라우팅할 수 있도록 지원을 추가했습니다.

변경됨

* SDK는 기본적으로 생성된 트레이스 서버 클라이언트를 사용합니다. 이전 클라이언트를 사용하려면 `WEAVE_USE_STAINLESS_SERVER=false`를 설정하세요. * 공급자가 보고한 토큰 합계는 0인 경우를 포함해 그대로 유지됩니다.

수정됨

* Google GenAI Call이 원래 값 대신 트레이스된 Weave 값을 전달받던 문제를 수정했습니다. * Gemini 콘텐츠 파트가 원래 순서를 유지합니다. * 에이전트 채팅 메시지에 span의 `error_type` 및 `status_message`가 포함됩니다. * 잘못된 쿼리 인수에 대해 `403` 대신 `400`을 반환합니다.

변경됨

* 옵트인 방식의 생성된 트레이스 서버 클라이언트(`WEAVE_USE_STAINLESS_SERVER=true`)가 나머지 트레이스 서버 경로와 `calls_complete` 쓰기 경로를 모두 지원합니다. * 모델 공급자 및 비용 데이터를 업데이트했습니다.

수정됨

* 시작 시 서버 정보 요청이 실패하면 `weave.init()`이 일반적인 메시지 대신 TLS 인증서 오류 등 근본 원인을 보고합니다. * 생성된 트레이스 서버 클라이언트에서 `WEAVE_INSECURE_DISABLE_SSL`과 SDK 요청 타임아웃이 적용되며, 병렬 청크 테이블 업로드가 활성화됩니다. * 생성된 트레이스 서버 클라이언트에서 영구적인 `4xx` 오류는 재시도하지 않고 첫 응답에서 바로 실패 처리하며, 유실된 Call을 알려 줍니다.

추가됨

* 페더레이션 ID 지원을 추가했습니다. `WANDB_IDENTITY_TOKEN_FILE`이 JWT를 가리키면 SDK는 `wandb` SDK와 마찬가지로 이를 액세스 토큰으로 교환하고, 해당 토큰을 자격 증명 파일(`WANDB_CREDENTIALS_FILE`)에 캐시합니다.

변경됨

* 모델 비용 데이터를 업데이트했습니다.

추가됨

* `EvaluationLogger`에서 `trace_scores`를 지원합니다. 점수마다 별도의 Call을 생성하지 않고 `Evaluation.predict_and_score`에 점수 값을 기록하려면 `trace_scores=False`를 설정하세요. 기본값은 `True`입니다.

변경됨

* 트레이스 서버에 `clickhouse-connect` 1.6이 필요합니다.

수정됨

* `weave[trace_server]` 설치 후 트레이스 서버를 임포트할 때 발생하던 `ImportError`를 수정했습니다. 이제 이 extra에 트레이스 서버가 임포트하는 모든 패키지가 선언되어 있습니다. * 데이터셋 이름이 128자 제한에 도달하면 이름 없는 평가가 데이터셋과 같은 객체 ID를 갖게 되어 저장에 실패하던 문제를 수정했습니다. * 평가 요약에서 점수가 생성되지 않은 행도 유지됩니다. * ClickHouse 스트림 실패 시 `502`를 반환하며, 트레이스 서버가 구조화된 ClickHouse 오류 코드를 읽습니다.

추가됨

* `@weave.op` Call이 자신이 생성한 에이전트 span에 연결되며, Call에는 자신을 호출한 에이전트 span이 기록됩니다. * Conversation SDK의 `Tool`, `LLM`, `SubAgent`, `Turn` span에서 `record_error()`를 사용하면 span을 종료하지 않고도 예외를 기록할 수 있습니다. * Claude Agent SDK 인테그레이션에서 서브에이전트를 트레이스합니다.

수정됨

* 플레이그라운드 및 Inference의 스트리밍 Chat Completion이 스트림을 모두 소비하기 전에 닫히던 문제를 수정했습니다. * Claude Agent SDK의 비동기 이터러블 쿼리가 턴별로 트레이스되지 않던 문제와 턴이 다른 비동기 쿼리에 잘못 귀속되던 문제를 수정했습니다. * MCP `read_resource` 래퍼에서 발생하던 `UnboundLocalError`를 수정했습니다. * OpenAI Agents SDK telemetry가 중복되던 문제를 수정했습니다. * OpenAI 캐시 쓰기 토큰의 매핑을 수정했습니다. * 트레이스에 OpenTelemetry 예외 이벤트의 세부 정보가 표시됩니다. * 지연 시간 통계에서 완료되지 않은 Call을 제외하며, 루트 사용량 통계에 OpenTelemetry span이 포함됩니다. * 비용 타임스탬프가 UTC 기준으로 생성됩니다. * 데이터베이스 스키마가 이미 최신 상태일 때 새 모델 비용이 추가되지 않던 문제를 수정했습니다.

추가됨

* `WeaveClient.register_custom_runtime()`으로 맞춤형 런타임을 등록하거나 교체할 수 있습니다. 맞춤형 런타임은 런타임 ID 목록을 갖는 OpenAI 호환 엔드포인트입니다. `weave.CustomRuntimeID`로 개별 ID의 토큰 한도를 설정할 수 있습니다. * Conversation SDK 턴에서 `Turn.output_messages`와 `Turn.record()`의 `output_messages` 인수를 통해 출력 메시지를 기록합니다. * Claude Agent SDK 인테그레이션에서 이미지 프롬프트를 트레이스합니다. * 연결 문자열이나 계정 키가 설정되지 않은 경우, Azure의 트레이스 파일 저장소에서 `DefaultAzureCredential`을 통한 워크로드 ID를 지원합니다. * Claude Opus 5의 비용 데이터가 추가되었습니다.

변경됨

* Claude Agent SDK OpenTelemetry 인테그레이션이 Conversation SDK 기반으로 변경되었습니다. * 트레이스 서버가 알 수 없는 요청 필드를 받으면 요청을 거부하지 않고 로그를 남긴 뒤 해당 필드를 무시합니다.

수정됨

* 비용 쿼리가 요청한 프로젝트 범위로 한정됩니다. * 트레이스 서버가 쿼리의 필드 한정자를 검증합니다. * 모델 선택기에서 사용자 정의 프로바이더 이름이 유지됩니다.

추가됨

* `WeaveClient.add_cost()`에서 캐시 읽기 및 캐시 생성 토큰 가격을 지정할 수 있으며, `query_costs()`가 이 값을 반환합니다. * Completions API에서 `reasoning_effort`를 지원합니다. * 에이전트 대시보드 설정을 저장, 로드, 포크할 수 있는 `AgentDashboard` 객체 유형이 추가되었습니다. * 피드백 쿼리가 `total_count`를 반환합니다. * 평가 메타데이터가 지정된 에이전트 span이 평가 결과에 연결됩니다.

수정됨

* 불리언 매개변수와 정수 매개변수 간 충돌로 인해 Call 쿼리가 `400` 오류로 실패하던 문제를 수정했습니다. * OpenTelemetry span의 OpenAI `cached_tokens` 값이 캐시 읽기 토큰으로 집계됩니다. * OpenAI SDK로 호출한 Serverless Inference Call의 트레이스에 요청한 모델이 표시됩니다. * Claude Agent SDK 인테그레이션의 캐시된 입력 토큰을 정규화했습니다.

추가됨

* `WeaveClient.get_agent_span_feedback()`, `get_agent_turn_feedback()`, `get_agent_conversation_feedback()`는 에이전트 span, 턴, 대화에 대한 피드백 쿼리를 반환합니다. 이 메서드로 추가한 반응은 에이전트 뷰에 엄지 아이콘으로 표시됩니다. * `SubAgent.start_subagent()`로 하위 에이전트를 다른 하위 에이전트 아래에 중첩할 수 있습니다. * 에이전트 span에 대한 서버 측 샘플링이 추가되었습니다. `WEAVE_INGEST_SAMPLE_RATE` 등 기존 Call 샘플링 설정이 span에도 적용되며, `weave.eval.*` 속성이 있는 트레이스는 항상 유지됩니다. * 트레이스 서버는 SDK 트레이스와 마찬가지로 에이전트 OpenTelemetry 내보내기에 포함된 base64 및 데이터 URL 콘텐츠를 콘텐츠 객체로 저장합니다. * 객체 삭제 응답에 삭제된 버전이 포함됩니다. * GPT-5.6을 비롯한 새 모델의 비용 및 공급자 데이터가 추가되었습니다.

변경됨

* `Turn` 및 `SubAgent` 팩토리 메서드의 이름이 `start_llm()`, `start_tool()`, `start_subagent()`로 변경되었습니다. 기존 `llm()`, `tool()`, `subagent()` 메서드도 계속 작동하지만 `DeprecationWarning`이 발생합니다. * `calls_complete` 저장소의 읽기 및 쓰기 성능이 개선되었습니다.

수정됨

* `use_otel_v2`가 켜져 있을 때(기본값) 직접 `openai` Call이 다시 트레이싱됩니다. 0.52.43부터 0.53.1까지는 `weave.integrations.patch_openai()`를 호출하지 않으면 직접 Call이 트레이싱되지 않았습니다. * 자식 span이 부모의 `with` 블록이 종료된 후 시작될 때(다른 스레드에서 시작되는 경우 포함) 부모에서 분리되는 문제를 수정했습니다. * 스트리밍 Converse 응답에서 Bedrock 캐시 토큰이 누락되는 문제를 수정했습니다. * Serverless Inference 모델 Call의 비용이 누락되는 문제를 수정했습니다. * 요약의 `input_tokens`에 Anthropic 프롬프트 캐시 토큰이 포함됩니다. * 문자열이 아닌 키를 가진 딕셔너리에서도 클라이언트 측 다이제스트가 일관되게 생성됩니다. * `google-adk` 2.3.0 이상을 지원합니다. * 깊게 중첩된 페이로드에서 ref를 변환할 때 발생하는 재귀 오류를 수정했습니다. * 요청 검증에 실패하면 `500` 대신 `400`을 반환합니다. * ClickHouse 마이그레이션이 멱등성을 갖게 되었으며, 부분적으로 실행된 경우 자동으로 복구됩니다.

추가됨

* `Conversation`에서 `agent_id`, `agent_description`, `agent_version` 기본값을 지정할 수 있으며, 각 턴이 이 값을 상속합니다. `start_turn()`도 동일한 인수를 받습니다. * Evaluation 결과 요약에 예측 전용 비용 합계가 포함됩니다. * `wandb/weave` 저장소의 `weave-instrument` 에이전트 스킬을 사용하면 코딩 에이전트가 Python 또는 TypeScript 코드베이스에 Weave 트레이싱을 추가할 수 있습니다. * Claude Sonnet 5를 비롯한 새 모델의 비용 및 공급자 데이터가 추가되었습니다.

변경됨

* Conversation SDK span의 `add_event()`는 사용 중단되었습니다. 대신 `set_attributes()`를 사용하세요. * `trace_server` extra에서 더 이상 `ddtrace`를 설치하지 않습니다. * 모든 쓰기 작업에서 첨부 파일이 병렬로 업로드됩니다.

수정됨

* `weave.init()`을 다시 호출하면 에이전트 트레이스가 활성 프로젝트로 전송됩니다. * 완료 오류 페이로드에 공급자의 HTTP 상태 코드가 유지됩니다. * 음수 JSON 경로 배열 인덱스에 대해 `502` 대신 `422`를 반환합니다.

추가됨

* 에이전트 데이터를 조회하는 `WeaveClient` 메서드가 추가되었습니다. `get_agents()`, `get_agent_versions()`, `get_agent_spans()`, `get_agent_turn()`, `get_agent_turns()`, `get_agent_span_stats()`가 포함됩니다. * `Turn.record()` 및 `SubAgent.record()`로 한 번의 호출에서 여러 필드를 설정할 수 있으며, `log_turn()`에서 `agent_id`, `agent_description`, `agent_version`을 지정할 수 있습니다. * `start_conversation()`, `log_turn()`, `log_conversation()`에서 맞춤형 `attributes`를 지정할 수 있으며, 이 속성은 대화의 모든 span에 기록됩니다. * 턴 및 하위 에이전트 span에 시스템 지침이 기록됩니다. * OpenAI Realtime 인테그레이션용 OpenTelemetry 네이티브 익스포터가 추가되었으며, 기본으로 선택됩니다. * 평가 결과에서 여러 평가에 걸친 match-any 및 match-all 필터링과 입력 기준 필터링을 지원합니다. * 평가 결과 요약에 predict 전용 토큰 합계가 포함됩니다. * 에이전트 span 및 통계 API에 쿼리 시점 비용이 포함됩니다.

변경됨

* Session SDK의 이름이 Conversation SDK로 변경되었습니다. `Conversation`, `weave.start_conversation()`, `weave.end_conversation()`, `weave.get_current_conversation()`, `weave.log_conversation()` 또는 `weave.conversation` 모듈을 사용하세요. 기존 session 이름도 계속 작동하지만 `DeprecationWarning`이 발생하며, `session_id` 및 `session_name` 인수는 각각 `conversation_id` 및 `conversation_name`에 매핑됩니다. * 선언적 평가에서 생성된 Call에도 `EvaluationLogger`와 마찬가지로 평가 메타데이터가 포함됩니다. * 평가 결과 및 Call 통계의 쿼리 성능이 개선되었습니다.

수정됨

* `repr()` 출력에 메모리 주소가 포함되어 DSPy, GEPA, LangChain 인테그레이션이 run마다 새 객체 버전을 게시하던 문제를 수정했습니다. * 이제 `weave`를 `google-adk`와 함께 설치할 수 있습니다. * `dictify`가 참조 순환에 빠지던 문제를 수정했습니다. * `LLMAsAJudgeScorer`가 더 이상 게시된 페이로드에 op 메서드를 포함하지 않습니다. * invoke API 사용 시 Bedrock 추론 프로필 ARN에서 모델 ID를 감지하지 못하던 문제를 수정했습니다. * 프로젝트에 대한 액세스 권한이 없을 때 더 명확한 오류가 표시됩니다. * 잘못된 쿼리 매개변수나 형식이 잘못된 어노테이션 사양에 대해 트레이스 서버가 `500` 대신 `400`을 반환하며, 잘못된 필드 오류에 허용되는 필드 목록이 표시됩니다.

추가됨

* Session SDK의 `Turn`, `LLM`, `Tool`, `SubAgent` span에 `set_attributes()` 및 `add_event()`가 추가되었습니다. * 인테그레이션이 생성하는 Call과 span에 인테그레이션 메타데이터가 기록됩니다. * `allow_unsafe_custom_obj_decode` 설정이 추가되었으며 기본값은 `True`입니다. 서버 측 평가 워커는 이 설정을 끄므로 이미지, 오디오 같은 데이터 전용 유형은 디코딩하지만 op를 비롯해 코드가 포함된 객체는 거부합니다. * Claude Fable 5를 포함한 새 모델의 비용 및 공급자 데이터가 추가되었습니다.

변경됨

* OpenTelemetry 기반 인테그레이션이 기본으로 활성화됩니다(`use_otel_v2`, `WEAVE_USE_OTEL_V2`). 이 모드에서는 `openai`를 직접 호출하면 자동으로 트레이스되지 않습니다. 이를 트레이스하려면 `weave.integrations.patch_openai()`를 호출하거나 `WEAVE_USE_OTEL_V2=false`를 설정하세요. * 다른 유형의 객체가 이미 사용 중인 이름으로 객체를 게시하면 `400` 오류와 함께 실패합니다. * `jsonschema`를 필요할 때만 임포트하도록 변경되어 `import weave` 속도가 빨라졌습니다. * SQLite 트레이스 서버가 제거되었습니다.

수정됨

* 문서 예시처럼 op 이름으로 모니터를 생성할 때 발생하던 문제를 수정했습니다. * `import weave` 이후에 `WEAVE_INSECURE_DISABLE_SSL`을 설정해도 적용됩니다. * `calls_complete`가 켜져 있을 때 짝이 맞지 않는 eager Call로 인해 `flush()`가 멈추던 문제를 수정했습니다. * `PaginatedIterator` 인스턴스가 하나의 페이지 캐시를 공유하던 문제를 수정했습니다. * 스트리밍 Call에서 호출자가 설정한 `started_at` 및 `ended_at` 값이 유지됩니다. * Bedrock 스트리밍에서 도구 사용 및 추론 델타가 제대로 처리되지 않던 문제를 수정했습니다. * `libmagic`이 `application/octet-stream`을 반환할 때 메모리 내 오디오를 WAV로 감지하지 못하던 문제를 수정했습니다. * `BaseModel`과 `WeaveDict` 결과가 섞여 있을 때 Scorer `auto_summarize`가 제대로 작동하지 않던 문제를 수정했습니다. * `parent_span_id`가 모두 0인 OpenTelemetry span은 루트 span으로 처리됩니다. * 지원되지 않거나 선택할 수 없는 필드에 대해 트레이스 서버가 `500` 대신 `4xx` 오류를 반환합니다.

추가됨

* 어노테이션 큐를 관리하는 `WeaveClient` 메서드(`create_annotation_queue()`, `add_calls_to_annotation_queue()`, `get_annotation_queue()` 등)가 추가되었습니다. * OpenTelemetry를 통해 에이전트 span을 자동으로 트레이스하는 Google ADK 인테그레이션이 미리 보기로 제공됩니다. * OpenAI Agents SDK와 Claude Agent SDK용 OpenTelemetry 기반 인테그레이션이 추가되었습니다. * 에이전트 span 사용량에 캐시 생성 입력 토큰, 캐시 읽기 입력 토큰, 추론 출력 토큰이 포함됩니다. * 기존 평가 run을 대상으로 Scorer를 다시 실행하고 새 평가 run을 생성하는 트레이스 서버 `rescore` 엔드포인트가 추가되었습니다. * Claude Opus 4.8을 비롯한 신규 모델의 비용 및 공급자 데이터가 추가되었습니다.

변경됨

* `use_calls_complete` 설정의 기본값이 `True`로 변경되었습니다. SDK는 각 Call의 시작과 종료를 짝지어 하나의 레코드로 기록합니다. * Session SDK가 `WEAVE_DISABLED`, `WEAVE_REDACT_PII`, `WEAVE_CAPTURE_CLIENT_INFO`, `WEAVE_CAPTURE_SYSTEM_INFO`를 적용합니다.

수정됨

* `str(ref)`가 Weave URI를 반환하므로, `str(ref)`로 만든 리더보드 열이 평가 결과와 일치합니다. * `include_content=False`일 때 출력 메시지에 `LLM.reasoning`이 표시되던 문제를 수정했습니다. * 프로젝트 트레이스 저장소 크기에 OpenTelemetry span 데이터가 포함됩니다. * 피드백 `created_at` 타임스탬프를 UTC 기준으로 읽습니다. * 트레이스 서버가 이미지 완료 요청 시 이미지 URL을 가져오기 전에 유효성을 검사합니다. * Azure 파일 저장소가 더 이상 기존 blob을 덮어쓰지 않습니다.

추가됨

* 평가의 `predict_and_score` Call 내부에서 GenAI 인테그레이션이 내보내는 span이 해당 평가에 자동으로 연결됩니다. * 동적 JSON 필터의 유형 캐스트 추론이 피드백 쿼리에도 적용됩니다.

변경됨

* 객체를 게시할 때마다 명시적인 `latest` 별칭이 기록됩니다. 기존 콘텐츠를 다시 게시하면 해당 콘텐츠가 `latest` 버전이 되고, `latest` 버전을 삭제하면 `latest`는 남아 있는 다음 버전을 가리킵니다. * MCP 인테그레이션의 이름이 FastMCP로 변경되었습니다. `weave.integrations.patch_mcp()`는 `patch_fastmcp()`로, `weave.integrations.mcp` 모듈은 `weave.integrations.fastmcp`로, `mcp` extra는 `fastmcp`로 바뀌었습니다. * OTLP 익스포터가 `WEAVE_INSECURE_DISABLE_SSL`을 적용합니다.

수정됨

* `weave`보다 `wandb`를 먼저 설치했을 때 `import weave`가 protobuf `TypeError`로 실패하던 문제를 수정했습니다. 이제 `weave`에는 버전 1.28.0 이상의 `opentelemetry` 패키지가 필요합니다. * 저장된 뷰에 `expand_columns`가 유지됩니다. * 실패한 파일 업로드가 더 이상 캐시되지 않으므로, 이후 같은 파일을 업로드하면 다시 시도됩니다. 이 릴리스는 protobuf 관련 문제로 PyPI에서 철회(yank)되었습니다. `wandb`를 먼저 설치했을 때 `import weave`가 실패하는 문제가 수정된 0.52.41 이상을 사용하세요.

추가됨

* Call 필터가 비교 값을 바탕으로 `inputs`, `output`, `attributes`, `summary` 아래 동적 JSON 필드의 유형 캐스트를 추론하므로, 대부분의 숫자 및 불리언 비교에 더 이상 `$convert`가 필요하지 않습니다. * 트레이스 서버가 에이전트 span, 턴, 대화에 대한 피드백을 지원합니다.

변경됨

* 비동기 함수를 트레이스할 때 op별 오버헤드가 줄었습니다. * ClickHouse 트레이스 서버가 기본적으로 비동기 삽입을 사용합니다.

수정됨

* 대용량 필드에서 `$contains`, `$eq`, `$in`을 감싼 `$not` 필터가 Call을 실제보다 적게 반환하던 문제를 수정했습니다. * 스트리밍 accumulator에서 발생할 수 있는 메모리 누수를 수정했습니다. 이 릴리스는 protobuf 관련 문제로 PyPI에서 철회(yanked)되었습니다. `wandb`가 먼저 설치된 경우 `import weave`가 실패하는 문제를 수정한 0.52.41 이상 버전을 사용하세요.

추가됨

* Session SDK가 OpenTelemetry GenAI 시맨틱 규칙을 따르는 span을 내보내며, `weave.start_tool()`, `weave.start_subagent()`, `MediaAttachment`가 추가되었습니다. * GenAI 에이전트 span을 저장하고 쿼리하는 기능이 트레이스 서버에 추가되었습니다. * Grok 4.3 등 새 모델의 비용 및 공급자 데이터가 추가되었습니다.

변경됨

* 이제 `weave`는 `opentelemetry-api`, `opentelemetry-sdk`, `opentelemetry-exporter-otlp-proto-http`에 의존합니다. * 서버 정보를 한 번만 요청하도록 개선되어 `weave.init()`이 더 빨라졌습니다. * `WANDB_ERROR_REPORTING=false`로 설정하면 Weave SDK의 Sentry 오류 보고가 비활성화됩니다.

수정됨

* `EvaluationLogger`가 루트 Call의 시작을 즉시 전송하므로, `log_summary()`가 실행되기 전에도 평가가 UI에 표시됩니다. * 연결된 백그라운드 작업이 끝나기 전에 플러시가 반환되던 문제를 수정했습니다. * 최신 OpenAI Agents SDK span 유형 처리를 수정했습니다. * 트레이스 데이터의 유효하지 않은 UTF-8 서로게이트 처리를 수정했습니다.

추가됨

* `weave.link_prompt_to_registry()` 및 이에 대응하는 `WeaveClient` 메서드를 사용해 게시된 프롬프트 또는 객체 버전을 레지스트리에 연결할 수 있습니다. * 에이전트를 수동으로 계측하기 위한 Session SDK API가 추가되었습니다. `Session`, `Turn`, `LLM`, `Tool`, `SubAgent`와 `weave.start_session()`, `weave.start_turn()` 등의 함수가 포함됩니다. 이 릴리스의 API는 span을 내보내지 않는 스텁입니다. * 트레이스를 Weave에 자동으로 로깅하는 GEPA 인테그레이션이 프리뷰로 추가되었으며, `gepa` extra로 설치할 수 있습니다. * `/eval_results` API가 서버 측 정렬, 필터링, 페이지네이션을 지원하며, 데이터셋 기반 평가 입력을 해석합니다. * GPT-5.5 등 새 모델의 비용 및 공급자 데이터가 추가되었습니다.

변경됨

* `wandb`가 다시 선택 종속성으로 변경되었습니다. * 복제 클러스터의 ClickHouse 마이그레이션에서 `Replicated` 데이터베이스 엔진 대신 `ReplicatedMergeTree` table과 `ON CLUSTER` 문을 사용하는 `Atomic` 데이터베이스를 사용합니다.

수정됨

* 레플리카 지연으로 인해 `404`로 실패한 객체 조회를 SDK가 재시도합니다. * OpenAI Agents SDK의 `responses.create` Call이 에이전트 트레이스에 연결되지 않던 문제를 수정했습니다. * 원시 OpenAI 응답을 언래핑할 때의 오류 처리를 수정했습니다.

추가됨

* OpenTelemetry 인테그레이션이 최신 시맨틱 규칙을 따릅니다. * 비용 계산 및 공급자 인테그레이션에 캐시 토큰 사용량이 포함됩니다.

변경됨

* 중첩된 하위 쿼리를 선택적으로 건너뛰어 일부 Call 쿼리의 성능을 개선했습니다. * 이제 최상위 `weave` 패키지에서 `ClassifierMonitor`를 내보냅니다. * Call API에서 더 세밀한 필터링을 위한 선택 사항인 `query` 매개변수를 지원합니다.

수정됨

* 일부 필터 조합에서 평가 결과 API의 SQL 문제를 수정했습니다. * TypeScript SDK가 `WANDB_BASE_URL`에서 URL 스킴을 누락할 수 있던 버그를 수정했습니다. * 피드백 행이 여러 개인 Call이 목록 결과에 중복으로 표시될 수 있던 버그를 수정했습니다. * ClickHouse 기반 쿼리의 ISO-8601 타임스탬프 처리를 수정했습니다. * 분산 ClickHouse 뮤테이션에서 table 이름에 `_local` 접미사가 올바르지 않게 추가되던 문제를 수정했습니다. * OpenAI Agents SDK 플로우를 트레이싱할 때 span이 누락되던 문제를 수정했습니다. * 응답에 텍스트가 아닌 부분이 포함된 경우 Google GenAI 트레이싱이 제대로 동작하지 않던 문제를 수정했습니다. * 메모리 내 트레이스 파일 아티팩트의 경로 정리와 HTTP 클라이언트의 공급자 호스트 이름 처리를 수정했습니다.

추가됨

* Call 쿼리에서 사람이 읽을 수 있는 사용자 이름을 확인할 수 있습니다. * 일부 플로우에서는 클라이언트를 명시적으로 초기화하지 않아도 `ref.get()`이 작동합니다. * 텍스트 기반 평가 결과를 위한 API 및 저장소 경로가 추가되었으며, 대규모 평가 세트 처리가 개선되었습니다.

변경됨

* 번들된 인테그레이션과의 호환성을 위해 LiteLLM 버전을 고정했습니다. * Moonshot을 모델 공급자로 사용할 수 있습니다. * 기반 쓰기 전 로깅 인프라를 개선하여 트레이스 쓰기의 내구성이 향상되었습니다.

수정됨

* 스트리밍 제너레이터를 중단할 때 `GeneratorExit`가 올바르지 않게 노출될 수 있던 버그를 수정했습니다. * 저장된 객체에 추가 메타데이터 필드가 포함된 경우의 역직렬화 문제를 수정했습니다. * Call에 피드백 행이 여러 개 있을 때 피드백 필터가 제대로 동작하지 않던 문제를 수정했습니다. * SQLite 기반 Call 비용 추적과 배치 업서트의 유효하지 않은 `trace_id` 처리를 수정했습니다. * 일시적 오류 발생 시 재시도, 더 명확한 마이그레이터 종료 상태 등 ClickHouse 마이그레이션 동작을 개선했습니다. * Call이 1000개를 초과하는 평가 run을 예측 및 점수화용으로 로드하지 못할 수 있던 버그를 수정했습니다.

추가

* 트레이스 수집을 위한 쓰기 전 로그 지원. * 피드백 데이터 분석을 위한 피드백 통계 쿼리.

변경

* `ref.uri()`를 호출하지 않고도 `Ref.uri`를 속성(`ref.uri`)으로 읽을 수 있습니다. * 환경 변수로 디바운스된 점수화 기록의 최대 크기를 설정할 수 있습니다.

수정

* 음수 숫자 필터 값에 대한 ClickHouse 캐스팅을 수정했습니다. * 온클러스터 마이그레이션 중 발생하는 복제 데이터베이스 엔진 오류를 수정했습니다. * `DelegatingTraceServerMixin`이 일부 `ServiceInterface` 메서드를 전달하지 않는 문제를 수정했습니다. * `weave.init()` 중 W\&B API 호출 시의 재시도 동작을 수정했습니다. * `WEAVE_DISABLED`가 설정된 경우 `EvaluationLogger`가 충돌할 수 있는 버그를 수정했습니다. * `RefJSONEncoder` 엣지 케이스 및 서브클래스의 classmethod 인스턴스화 문제를 수정했습니다.

추가

* 객체 태그와 별칭을 위한 Python SDK 메서드 및 HTTP 모델. * 도구 call과 선택적 오디오, 텍스트, 음성 캡처를 포함한 OpenAI Realtime API 계측(업스트림 릴리스 노트의 TypeScript 예제 참조).

수정

* 트레이스에서 Anthropic 스트리밍 completion이 누적되는 방식을 수정했습니다. * `RemoteHTTPTraceServer`의 인증된 `PUT` 요청을 수정했습니다. * `calls_complete` 프로젝션의 비용 쿼리 처리를 수정했습니다.

추가

* 트레이스 서버가 저장된 객체의 태그와 별칭을 지원합니다. * Claude Agents 트레이싱 인테그레이션. * Realtime 세션의 타임스탬프 및 time-to-first-token 메트릭. * Monitors가 병합된 Scorer를 사용할 수 있습니다.

변경

* 교차 요청 작업 참조 캐시를 통해 OpenTelemetry 성능이 향상되었습니다.

수정

* 내부 필드 이스케이프 및 분산 ClickHouse 설정을 포함한 비용 쿼리 구성의 여러 문제를 수정했습니다. * Pydantic v2 `Run` 객체에 대한 LangChain 인테그레이션 처리를 수정했습니다. * 입력 또는 메타데이터가 누락된 경우 예측 및 Scorer resolver의 엣지 케이스를 수정했습니다. * `calls_complete` 쿼리에서 Vertex AI 텍스트 누적 및 스레드 가시성을 수정했습니다.

추가

* 저장된 점수를 재계산하기 위한 Score backfill API. * TypeScript SDK의 Gemini 요청 추적.

변경

* 더 나은 쿼리 성능을 위해 `trace_id` 또는 `project_id`별로 샤딩된 분산 calls table. * 지연 시간 감소를 위한 `calls_complete` 쿼리 계획 간소화.

수정

* Weave UI에서 Gemini media가 렌더링되지 않을 수 있는 버그를 수정했습니다. * OpenTelemetry 배치 삽입이 이제 비동기 ClickHouse 삽입을 사용합니다. * HTTP 클라이언트의 `NO_PROXY` 처리를 수정했습니다. * 일부 오류 메시지에서 entity와 team 명명 문제를 수정했습니다.

추가

* Usage API가 완료되지 않은 call의 메타데이터를 노출합니다. * 더 풍부한 MIME 감지를 위한 선택적 `python-magic` 인테그레이션. * Realtime 스레드가 사용량 요약에 참여합니다. * Weave 객체의 태그와 별칭에 대한 스키마 지원. * 평가 table을 위한 구조화된 `eval_results` 쿼리 API.

변경

* ClickHouse에 타임스탬프를 문자열로 저장하여 인덱싱을 개선했습니다. * call upsert 시 배치 파일 생성 중 중복 작업을 줄였습니다.

수정

* 제너레이터가 구성된 sampling rate를 따르지 않는 버그를 수정했습니다. * call이 종료될 때 스트림이 즉시 플러시되도록 buffering을 수정했습니다. * 정렬 쿼리 인덱스 오류 및 다이제스트 계산을 위한 결정론적 JSON 직렬화를 수정했습니다. * OpenTelemetry 표시 이름, `make_safe_name` 처리 및 Pydantic 모델에 대한 LangChain 직렬화를 수정했습니다.

추가

* OpenTelemetry 리소스 속성이 W\&B run 및 프로젝트 변수를 전달할 수 있습니다. * ORM이 `$lt` 및 `$lte` 비교를 지원합니다. * OpenTelemetry 프로젝트가 `calls_complete` table에 직접 쓸 수 있습니다. * OpenAI Realtime 트레이싱의 일반 가용성 개선.

변경

* table 스캔 및 call 통계 쿼리의 성능을 개선했습니다.

수정

* 스레드 ID로 call을 필터링할 때 필터가 잘못 최적화되는 경우를 포함하여 수정했습니다. * 멱등성 어노테이션 큐 상태 업데이트를 수정했습니다. * `weave.finish()`가 항상 보류 중인 클라이언트 데이터를 플러시하지 않는 버그를 수정했습니다. * `PaginatedIterator`, `Dataset.select` 메타데이터 보존 및 메모리가 부족할 수 있는 대형 트레이스 크기 쿼리에 대한 이터레이터 타이핑을 수정했습니다.

추가

* 집계된 사용량을 위한 Usage statistics API 및 `/trace/usage`, `/calls/usage` 엔드포인트. * 고처리량 배포를 위한 선택적 performance mode 플래그. * Anthropic structured-parse 패칭. * 저장된 뷰가 `column_order` 필드를 지원합니다.

변경

* 분산 클러스터 쿼리를 위한 `PREWHERE` 최적화를 개선했습니다.

수정

* 실패한 ClickHouse 삽입이 버퍼링된 행을 누출할 수 있는 버그를 수정했습니다. * 임포트할 때 IPython을 임포트하면 콜드 스타트가 느려질 수 있는 버그를 수정했습니다. * 동기 뮤테이션 마이그레이션, `calls_complete`의 summary 필터링 및 Google GenAI 토큰 과다 집계를 수정했습니다. * 모니터가 있는 OpenTelemetry span 및 Google Cloud Storage의 중복 업로드 처리를 수정했습니다.

수정

* 일부 인테그레이션에서 중복 HTTP 응답 캡처를 제거했습니다. * Google GenAI 트레이싱이 이제 시스템 지침을 기록합니다. * Google GenAI 트레이싱이 이제 완료 토큰과 별도로 thinking 토큰을 기록합니다.

추가

* Node SDK에서 프롬프트 작업을 위한 TypeScript 헬퍼 API. * 트레이스 서버가 적절한 경우 Base64 페이로드를 안전하게 자동 변환합니다. * 다가오는 comparison feature를 위한 Leaderboard 스키마 업데이트. * PII redaction을 미세 조정하기 위한 `redact_pii_exclude_fields` 설정. * `LLMAsAJudgeScorer`의 오디오 입력 및 인테그레이션을 위한 더 풍부한 op 메타데이터(kinds 및 colors).

수정

* 엣지 케이스에서 op 생성을 차단하는 잘못된 문자를 수정했습니다. * HTTPX 클라이언트의 HTTP 및 HTTPS proxy 처리를 수정했습니다. * 제너레이터를 래핑할 때 중첩 트레이싱을 수정했습니다.

추가

* Logfire Pydantic AI 계측의 입력 및 출력을 위한 파싱 헬퍼.

수정

* 대형 table 평가에서 정렬 순서가 비결정적으로 달라지던 문제를 수정했습니다. * 입력 및 출력 토큰이 누락되던 비용 쿼리를 수정했습니다. * 분산 복제 ClickHouse table 문제를 수정하고, Kafka 플러시 동작을 설정으로 제어하도록 변경했습니다.

추가

* `LLMStructuredCompletionModels`의 프롬프트와 템플릿 변수가 completion call 전반에서 유지됩니다.

수정

* 일부 환경에서 발생하던 ClickHouse 임포트 호환성 문제를 수정했습니다.

추가

* Completions 스트리밍 API에서 프롬프트와 템플릿 변수를 사용할 수 있습니다. * `ObjectRef.from_uri`로 Weave URI에서 객체를 재구성할 수 있습니다. * OpenAI Responses API 트레이싱이 `x-request-id` 헤더를 기록합니다. * Bedrock Agents 인테그레이션 지원. * span 메타데이터를 위한 TypeScript SDK `withAttributes` 헬퍼.

수정

* OpenAI Agents 트레이싱 프로세서의 메모리 누수를 수정했습니다. * Weave가 비활성화된 상태에서도 ref가 게시될 수 있는 버그를 수정했습니다. * HTTP 클라이언트 코드를 `requests`에서 `httpx`로 마이그레이션할 때 발생하던 이터레이터 동작 문제를 수정했습니다. 0.52.20 이전 릴리스는 [`wandb/weave`의 GitHub Releases](https://github.com/wandb/weave/releases)를 참조하세요. 해당 항목은 GitHub의 기본 compare 형식(pull request 링크 및 커밋 접두사)으로 작성되어 있습니다. 이 문서 페이지에서는 최신 버전의 변경 사항을 고객 관점에서 알기 쉽게 정리해 제공합니다.