分散トレーシング標準装備、ただしオプトアウト可。本番デバッグが楽になるぽ
Anthropic TypeScript SDK v0.134.0リリース、OpenTelemetry対応など追加
原題: anthropics/anthropic-sdk-typescript: sdk-v0.134.0
重要度の根拠: 既存ユーザーに直接影響しないマイナーバージョン更新。トレーシング機能はデフォルト有効だが opt-out 可能で破壊的変更なし。
要約
Anthropic が TypeScript SDK v0.134.0 をリリースしました。主な追加機能は OpenTelemetry スパン(分散トレーシング用の処理単位)をデフォルトで自動発行し、API呼び出しやストリーミング、ツール実行をトレース可能にしたこと。Managed Agents に execution_identity フィールドを追加し、テレメトリー(利用統計)送信先を Admin API で管理できるようにしました。ストリーミングイベント処理の堅牢化、トークンリクエストのリダイレクト対策、プロキシ認証の安全ヘッダ化も含まれています。
要点
- OpenTelemetry スパンがデフォルト有効、設定で無効化可能
- Managed Agents に execution_identity 追加
- テレメトリー送信先を Admin API で管理
- ストリーミング イベント処理の堅牢化
- トークン認証のセキュリティ対策強化
開発者向け技術解説(API・実装詳細・破壊的変更)を見る
SDK v0.134.0 は `@opentelemetry/api` ^1.4.1 に依存し、OpenTelemetry スパンをデフォルト有効化。設定は `openTelemetry: false` または環境変数 `ANTHROPIC_OPEN_TELEMETRY=false` で全無効、`openTelemetry: { propagation: false }` で トレースヘッダ送信のみ無効化可能。Managed Agents API に `execution_identity` フィールド追加。Admin API にテレメトリー宛先エンドポイント(test endpoint 含む)統合。MessageStream/BetaMessageStream で未知のイベント型を許容、message_start 前のイベント出力に対応。POST トークンエンドポイントでリダイレクト追従廃止(セッションハイジャック対策)。プロキシ認証ヘッダをパスワード等に準じた機密ヘッダとしてマスク。
本文の日本語訳(全文)を見る
### 新機能
* **api:** Managed Agents agents に execution_identity を追加
* **api:** spend limit lists に organization_type_not_supported エラーを追加
* **api:** テレメトリー送信先のテストエンドポイントを追加
* **api:** Admin API にテレメトリー送信先を追加
* **client:** OpenTelemetry スパンを API 呼び出し、ストリーム、ツール実行に対して発行。デフォルトで有効で SDK にセットアップは不要:アプリケーションが OpenTelemetry API に tracer provider を登録すると、スパンが出現し、登録がなければ出現しない。リクエストは `traceparent` に、登録された propagator が書く他のヘッダにトレースコンテキストを載せる。`@opentelemetry/api` (`^1.4.1`) への依存を追加。`openTelemetry: false` または `ANTHROPIC_OPEN_TELEMETRY=false` がすべてをオフにし、`openTelemetry: { propagation: false }` または `ANTHROPIC_OPEN_TELEMETRY_PROPAGATION=false` がスパンを保持しつつトレースヘッダを送らない(変数は `openTelemetry` オプションを与えられていないクライアントにのみ適用)
### バグ修正
* **api:** テレメトリー送信先のテストレスポンスモデルをリネーム
* **client:** トレーシングがオンの間にドロップされた未読ストリームをクローズ
* **client:** トークンリクエストではリダイレクトを追従しない
* **client:** プロキシ認証(proxy-authorization)を機密ヘッダとして扱う
### バグ修正(ストリーミング)
* **streaming:** MessageStream と BetaMessageStream で不明なイベント型を許容
* **streaming:** message_start の前のイベントについて "Unexpected event order" エラーをスロー廃止
* **streaming:** MessageStream と BetaMessageStream をイテレートするとき message_start の前に到達したイベントをイールド
### その他
* **docs:** prefill、thinking、fallback、モデル説明を修正
* **docs:** managed role を割り当てるのに必要なスコープをドキュメント化
* **docs:** モデル例を更新
* 発行パッケージにライセンスファイルを含める
* **internal:** 貢献者ガイドの tripwire テストルールを絞り込み
* **internal:** public 型が参照する型から `@internal` タグを削除
* **internal:** toolset モジュールからファイルレベルの `@internal` タグを削除
* **internal:** 発行型から `@internal` 宣言を除去
* **internal:** lint で構築された宣言を型チェック
### ドキュメント
* **api:** カスタムツール結果を送信可能なタイミングを明確化
* **api:** is_enabled がユーザー spend limits では常に true であることを説明
* CLAUDE.md の共有部分により多くの共有ルールを移動
* ストリーミング専用メソッドをストリームイテレートする例を表示
出典: https://github.com/anthropics/anthropic-sdk-typescript/releases/tag/sdk-v0.134.0
媒体: SDK (anthropic-sdk-typescript)
※本記事は Anthropic / Claude 関連の公開情報を基に AI (OpenAI GPT-4o-mini) が日本語で要約・分類した二次的著作物です。著作権法第32条の引用要件に基づき出典 URL を必ず併記しています。要約は AI 生成のため誤訳・誤解釈を含む可能性があります。詳細・正確な情報は必ず出典元の原文をご確認ください。