OpenTelemetry 対応で observability が格段に上がる。本番環境での API 動作追跡が現実的に。
Anthropic Python SDK v1.14.0 リリース — OpenTelemetry トレーシング対応
原題: anthropics/anthropic-sdk-python: v1.14.0
重要度の根拠: API/SDK マイナーバージョンアップで、OpenTelemetry トレーシング機能は可観測性向上だが実装必須ではなく、既存ユーザーへの破壊的影響なし。
要約
Anthropic の Python SDK が v1.14.0 にアップデートされました。主な追加機能として、OpenTelemetry トレーシング機能が実装され、API 呼び出し・ストリーミング・ツール実行時の可視化が可能になります。また Managed Agents に execution_identity が追加され、Admin API に telemetry destinations が統合されました。バグ修正では、ストリームを適切に閉じる改善、予期しないイベントタイプの通過許可、不適切な「イベント順序エラー」の削除などが行われています。ドキュメント改善も併せて実施されました。
要点
- OpenTelemetry トレーシング対応で API・ストリーム・ツール実行の可視化可能
- Managed Agents に execution_identity、Admin API に telemetry destinations 追加
- ストリーム処理バグ修正で false エラー排除、unknown イベント対応
- ドキュメント改善で managed role scope 等の説明を充実
開発者向け技術解説(API・実装詳細・破壊的変更)を見る
Python SDK v1.14.0 では OpenTelemetry トレーシング機能が client レイヤーに統合され、API コール・ストリーミング・tool_use における分散トレーシングが可能に。Managed Agents API に execution_identity フィールドが追加、Admin API に telemetry_destinations エンドポイント追加(test endpoint 含む)、spend_limit_lists に organization_type_not_supported エラーを追加。ストリーミング処理では unknown event types を message stream helpers を通して渡す仕様に変更、message_start 前のイベントで「Unexpected event order」例外を発生させないよう修正。これらの変更は後方互換性を保つ追加と修正のみ。
本文の日本語訳(全文)を見る
### 新機能
* **api:** Managed Agents agents に execution_identity を追加
* **api:** spend limit lists に organization_type_not_supported エラーを追加
* **api:** telemetry destination test エンドポイントを追加
* **api:** Admin API に telemetry destinations を追加
* **client:** API コール、ストリーミング、ツール実行に対する OpenTelemetry トレーシング機能を追加
### バグ修正
* **api:** telemetry destination test response モデルの名称変更
* **client:** collector を待たずにドロップされたストリームを閉じる処理を実装
* **streaming:** 予期しないイベントタイプを message stream helpers を通す
* **streaming:** message_start 前のイベントについて「Unexpected event order」エラーを発生させないよう修正
### 雑務
* **docs:** prefill、thinking、fallback およびモデルの説明を修正
* **docs:** managed role を割り当てるために必要なスコープに関するドキュメントを追加
* **docs:** モデル例を更新
* **internal:** contributor guides の tripwire テストルールを厳密化
### ドキュメンテーション
* **api:** カスタムツール結果をいつ送信できるかを明確化
* **api:** ユーザー spend limits では is_enabled が常に true であることを記載
出典: https://github.com/anthropics/anthropic-sdk-python/releases/tag/v1.14.0
媒体: SDK (anthropic-sdk-python)
※本記事は Anthropic / Claude 関連の公開情報を基に AI (OpenAI GPT-4o-mini) が日本語で要約・分類した二次的著作物です。著作権法第32条の引用要件に基づき出典 URL を必ず併記しています。要約は AI 生成のため誤訳・誤解釈を含む可能性があります。詳細・正確な情報は必ず出典元の原文をご確認ください。