> ## 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 リリース](/ja/release-notes/sdk-releases) を参照してください。リリースパッケージとコミットごとの履歴は、[`wandb/weave` の GitHub Releases](https://github.com/wandb/weave/releases) で確認できます。

<Note>
  ここでは、ユーザーに影響する SDK およびトレースサーバーの変更をまとめています。内部向けのテスト、CI、リファクタリング作業の詳細は省略しています。マージされたすべての変更については、該当タグの GitHub リリースエントリを参照してください。
</Note>

<Update label="0.52.37" description="2026年4月17日">
  <h2 id="added">
    追加
  </h2>

  * OpenTelemetry インテグレーションが最新のセマンティック規約に準拠するようになりました。
  * コスト計算とプロバイダーインテグレーションに、キャッシュのトークン使用量が含まれるようになりました。

  <h2 id="changed">
    変更
  </h2>

  * ネストされたサブクエリを必要に応じてスキップすることで、一部の Call クエリのパフォーマンスを改善しました。
  * `ClassifierMonitor` がトップレベルの `weave` パッケージからエクスポートされるようになりました。
  * Call API で、オプションの `query` パラメーターを指定して、より柔軟にフィルタリングできるようになりました。

  <h2 id="fixed">
    修正
  </h2>

  * 一部のフィルターの組み合わせにおける評価結果 API の SQL を修正しました。
  * TypeScript SDK が `WANDB_BASE_URL` から URL スキームを削除してしまうことがあるバグを修正しました。
  * 複数のフィードバック行を持つ Call が、一覧結果に重複して表示されることがあるバグを修正しました。
  * ClickHouse をバックエンドとするクエリにおける ISO-8601 タイムスタンプの処理を修正しました。
  * 分散 ClickHouse のミューテーションで、表名に誤って `_local` サフィックスが付加される問題を修正しました。
  * OpenAI Agents SDK のフローをトレースする際にスパンが欠落する問題を修正しました。
  * レスポンスにテキスト以外のパートが含まれる場合の Google GenAI のトレースを修正しました。
  * インメモリのトレースファイルアーティファクトのパスサニタイズと、HTTP クライアントにおけるプロバイダーのホスト名の処理を修正しました。
</Update>

<Update label="0.52.36" description="2026年4月1日">
  <h2 id="added-2">
    追加
  </h2>

  * Call クエリで、人間が読める形式のユーザー名を解決できるようになりました。
  * 一部のフローで、クライアントを明示的に初期化しなくても `ref.get()` が動作するようになりました。
  * テキストベースの評価結果用の API とストレージパスを追加しました。大規模な評価セットの処理も改善されています。

  <h2 id="changed-2">
    変更
  </h2>

  * バンドルされたインテグレーションとの互換性を確保するため、LiteLLM のバージョンを固定しました。
  * Moonshot をモデルプロバイダーとして利用できるようになりました。
  * 基盤となるライトアヘッドログのインフラストラクチャーにより、トレース書き込みの耐久性が向上しました。

  <h2 id="fixed-2">
    修正
  </h2>

  * ストリーミングジェネレーターを中断した際に、`GeneratorExit` が誤って発生することがあるバグを修正しました。
  * 保存済みオブジェクトに追加のメタデータフィールドが含まれる場合のデシリアライズを修正しました。
  * Call に複数のフィードバック行がある場合のフィードバックフィルターを修正しました。
  * SQLite をバックエンドとする Call のコスト追跡と、バッチ upsert における無効な `trace_id` の処理を修正しました。
  * 一時的なエラー発生時のリトライや、マイグレーターの終了ステータスの明確化など、ClickHouse の移行の動作を改善しました。
  * 1000 件を超える Call を含む評価 run で、予測とスコアリングの読み込みに失敗することがあるバグを修正しました。
</Update>

<Update label="0.52.35" description="2026年3月19日">
  <h2 id="added-3">
    追加
  </h2>

  * トレースの取り込みでライトアヘッドログをサポートしました。
  * フィードバックデータを分析するためのフィードバック統計クエリを追加しました。

  <h2 id="changed-3">
    変更
  </h2>

  * `ref.uri()` を呼び出さなくても、`Ref.uri` をプロパティ (`ref.uri`) として読み取れるようになりました。
  * デバウンスされたスコアリング履歴の最大サイズを環境変数で設定できるようになりました。

  <h2 id="fixed-3">
    修正
  </h2>

  * 負の数値フィルター値に対する ClickHouse のキャストを修正しました。
  * オンクラスター移行中に発生するレプリケートデータベースエンジンのエラーを修正しました。
  * `DelegatingTraceServerMixin` が一部の `ServiceInterface` メソッドを転送しない問題を修正しました。
  * `weave.init()` の実行中に W\&B API を呼び出す際のリトライを修正しました。
  * `WEAVE_DISABLED` が設定されている場合に `EvaluationLogger` がクラッシュすることがあるバグを修正しました。
  * `RefJSONEncoder` のエッジケースと、サブクラスにおけるクラスメソッドのインスタンス化を修正しました。
</Update>

<Update label="0.52.33" description="2026年3月12日">
  <h2 id="added-4">
    追加
  </h2>

  * オブジェクトのタグとエイリアス用の Python SDK メソッドと HTTP モデルを追加しました。
  * OpenAI Realtime API のインストルメンテーションを追加しました。ツール呼び出しに加え、オプションで音声、テキスト、ボイスのキャプチャにも対応しています (アップストリームのリリースノートにある TypeScript の例を参照してください) 。

  <h2 id="fixed-4">
    修正
  </h2>

  * トレースにおける Anthropic のストリーミング完了の蓄積を修正しました。
  * `RemoteHTTPTraceServer` における認証付き `PUT` リクエストを修正しました。
  * `calls_complete` プロジェクションに対するコストクエリの処理を修正しました。
</Update>

<Update label="0.52.31" description="2026年3月10日">
  <h2 id="added-5">
    追加
  </h2>

  * トレースサーバーで、保存済みオブジェクトのタグとエイリアスをサポートしました。
  * Claude Agents のトレースインテグレーションを追加しました。
  * Realtime セッションにタイムスタンプと最初のトークンまでの時間 (time-to-first-token) のメトリクスを追加しました。
  * モニターでマージされた Scorer を使用できるようになりました。

  <h2 id="changed-4">
    変更
  </h2>

  * リクエスト間で共有するオペレーション参照キャッシュを導入し、OpenTelemetry のパフォーマンスを改善しました。

  <h2 id="fixed-5">
    修正
  </h2>

  * 内部フィールドのエスケープや分散 ClickHouse 構成への対応など、コストクエリの構築に関する複数の問題を修正しました。
  * LangChain インテグレーションにおける Pydantic v2 の `Run` オブジェクトの処理を修正しました。
  * 入力またはメタデータが存在しない場合に、予測および Scorer のリゾルバーで発生するエッジケースを修正しました。
  * Vertex AI のテキスト蓄積と、`calls_complete` クエリにおけるスレッドの可視性を修正しました。
</Update>

<Update label="0.52.30" description="2026年3月10日">
  <h2 id="added-6">
    追加
  </h2>

  * 保存済みスコアを再計算するためのスコアバックフィル API を追加しました。
  * TypeScript SDK に Gemini のリクエスト追跡を追加しました。

  <h2 id="changed-5">
    変更
  </h2>

  * クエリパフォーマンス向上のため、分散 Call 表を `trace_id` または `project_id` でシャーディングするようにしました。
  * レイテンシー低減のため、`calls_complete` のクエリプランを簡素化しました。

  <h2 id="fixed-6">
    修正
  </h2>

  * Gemini のメディアが Weave UI で表示されない場合があるバグを修正しました。
  * OpenTelemetry のバッチ挿入で、ClickHouse の非同期挿入を使用するようになりました。
  * HTTP クライアントにおける `NO_PROXY` の処理を修正しました。
  * 一部のエラーメッセージで entity とチームの名称が混同されていた問題を修正しました。
</Update>

<Update label="0.52.29" description="2026年2月27日">
  <h2 id="added-7">
    追加
  </h2>

  * 使用状況 API で、未完了の Call のメタデータを取得できるようになりました。
  * より詳細な MIME 判定のため、オプションで `python-magic` インテグレーションを利用できるようになりました。
  * Realtime スレッドが使用状況サマリーに含まれるようになりました。
  * Weave オブジェクトのタグとエイリアスをスキーマでサポートしました。
  * 評価表向けの構造化された `eval_results` クエリ API を追加しました。

  <h2 id="changed-6">
    変更
  </h2>

  * ClickHouse でタイムスタンプを文字列として保存することで、インデックス作成を改善しました。
  * Call の upsert 時のバッチファイル作成における重複処理を削減しました。

  <h2 id="fixed-7">
    修正
  </h2>

  * ジェネレーターが設定されたサンプリング率に従わないバグを修正しました。
  * Call の終了時にストリームが即座にフラッシュされるよう、バッファリングを修正しました。
  * ソートクエリのインデックスエラーを修正し、ダイジェスト計算用の JSON シリアライズが決定論的になるよう修正しました。
  * OpenTelemetry の表示名、`make_safe_name` の処理、および Pydantic モデルに対する LangChain のシリアライズを修正しました。
</Update>

<Update label="0.52.28" description="2026年2月14日">
  <h2 id="added-8">
    追加
  </h2>

  * OpenTelemetry のリソース属性で、W\&B の run および project の変数を保持できるようになりました。
  * ORM で `$lt` および `$lte` による比較をサポートしました。
  * OpenTelemetry の project から `calls_complete` 表に直接書き込めるようになりました。
  * OpenAI Realtime トレースの一般提供に向けた改善を行いました。

  <h2 id="changed-7">
    変更
  </h2>

  * 表スキャンと Call 統計クエリのパフォーマンスを改善しました。

  <h2 id="fixed-8">
    修正
  </h2>

  * スレッド ID による Call のフィルタリングを修正しました。フィルターが最適化により誤って除外されるケースも含みます。
  * アノテーションキューの状態更新が冪等になるよう修正しました。
  * `weave.finish()` が保留中のクライアントデータを常にはフラッシュしないバグを修正しました。
  * `PaginatedIterator` のイテレーターの型付け、`Dataset.select` でのメタデータの保持、およびメモリ不足を引き起こす可能性があった大きなトレースサイズのクエリを修正しました。
</Update>

<Update label="0.52.26" description="2026年2月3日">
  <h2 id="added-9">
    追加
  </h2>

  * 使用状況の集計を取得するための使用状況統計 API と、`/trace/usage` および `/calls/usage` エンドポイントを追加しました。
  * 高スループットのデプロイメント向けに、オプションのパフォーマンスモードフラグを追加しました。
  * Anthropic の構造化パースに対するパッチを追加しました。
  * 保存済みビューで `column_order` フィールドをサポートしました。

  <h2 id="changed-8">
    変更
  </h2>

  * 分散クラスタークエリにおける `PREWHERE` の最適化を改善しました。

  <h2 id="fixed-9">
    修正
  </h2>

  * ClickHouse への挿入が失敗した際に、バッファ内の行がリークする可能性があるバグを修正しました。
  * IPython をインポート時に読み込むことでコールドスタートが遅くなる可能性があるバグを修正しました。
  * 同期ミューテーションの移行、`calls_complete` でのサマリーフィルタリング、および Google GenAI のトークンの過剰カウントを修正しました。
  * モニター使用時の OpenTelemetry スパンと、Google Cloud Storage における重複アップロードの処理を修正しました。
</Update>

<Update label="0.52.25" description="2026年1月20日">
  <h2 id="fixed-10">
    修正
  </h2>

  * 一部のインテグレーションにおける冗長な HTTP レスポンスのキャプチャを削除しました。
  * Google GenAI のトレースでシステム指示が記録されるようになりました。
  * Google GenAI のトレースで、思考トークンが完了トークンとは別に記録されるようになりました。
</Update>

<Update label="0.52.24" description="2026年1月15日">
  <h2 id="added-10">
    追加
  </h2>

  * Node SDK でプロンプトを扱うための TypeScript ヘルパー API を追加しました。
  * トレースサーバーが、必要に応じて Base64 ペイロードを安全に自動変換するようになりました。
  * 今後の比較機能に向けて Leaderboard のスキーマを更新しました。
  * PII のマスク処理を細かく調整するための `redact_pii_exclude_fields` 設定を追加しました。
  * `LLMAsAJudgeScorer` で音声入力をサポートし、インテグレーション向けの op メタデータ (種類と色) を拡充しました。

  <h2 id="fixed-11">
    修正
  </h2>

  * 特定のエッジケースで、無効な文字により op を作成できない問題を修正しました。
  * HTTPX クライアントにおける HTTP および HTTPS プロキシの処理を修正しました。
  * ジェネレーターをラップした際のネストされたトレースを修正しました。
</Update>

<Update label="0.52.23" description="2026年1月8日">
  <h2 id="added-11">
    Added
  </h2>

  * Logfire Pydantic AI のインストルメンテーションの入力と出力を解析するヘルパーを追加しました。

  <h2 id="fixed-12">
    Fixed
  </h2>

  * 大規模な表を使用した評価で、順序が非決定的になる問題を修正しました。
  * コストクエリで入力トークンと出力トークンが除外されていた問題を修正しました。
  * 分散レプリケーション構成の ClickHouse 表に関する問題を修正し、Kafka の flush の動作を設定で制御できるようにしました。
</Update>

<Update label="0.52.22" description="2026年1月8日">
  <h2 id="added-12">
    Added
  </h2>

  * `LLMStructuredCompletionModels` のプロンプトとテンプレート変数が、completion の Call をまたいで保持されるようになりました。

  <h2 id="fixed-13">
    Fixed
  </h2>

  * 一部の環境で発生していた ClickHouse のインポート互換性の問題を修正しました。
</Update>

<Update label="0.52.20" description="2025年11月26日">
  <h2 id="added-13">
    Added
  </h2>

  * Completions のストリーミング API で、プロンプトとテンプレート変数を指定できるようになりました。
  * `ObjectRef.from_uri` を使用して、Weave URI からオブジェクトを再構築できるようになりました。
  * OpenAI Responses API のトレースで、`x-request-id` ヘッダーを記録するようになりました。
  * Bedrock Agents のインテグレーションに対応しました。
  * スパンのメタデータを設定するための `withAttributes` ヘルパーを TypeScript SDK に追加しました。

  <h2 id="fixed-14">
    Fixed
  </h2>

  * OpenAI Agents のトレースプロセッサで発生していたメモリリークを修正しました。
  * Weave を無効にしていても ref がパブリッシュされる場合があるバグを修正しました。
  * HTTP クライアントのコードを `requests` から `httpx` に移行した際のイテレーターの動作を修正しました。
</Update>

<Tip>
  0.52.20 より前のリリースについては、[`wandb/weave` の GitHub Releases](https://github.com/wandb/weave/releases) を参照してください。これらのエントリは GitHub のデフォルトの比較形式(プルリクエストへのリンクとコミットの接頭辞)で記載されています。このドキュメントページでは、新しいバージョンの変更内容をお客様向けの表現で掲載しています。
</Tip>
