OpenAI/Anthropic の請求書の費用を使った AI エージェントはどれ？

Spaturzu は、Superchiu Ltd によって開発されたオープンソース SDK であり、AI エージェントのコスト帰属と管理に関する課題を解決します。OpenAI、Anthropic、Bedrock、Gemini、Mistral などの LLM プロバイダのクライアントをラップすることで、コードを変更することなく、各 API 呼び出しにエージェント ID を割り当て、バックグラウンドでメータリングを行います。

移行は非常に簡単です。import OpenAI from "openai" を import OpenAI from "@spaturzu/sdk/openai" に変更し、withAgent または run メソッドを使用して呼び出しをタグ付けするだけです。Python の場合は from spaturzu.openai import OpenAI とし、client.with_agent("support-triage").chat.completions.create(...) のように使用します。この1行のインポート変更は、すべてのサポート対象プロバイダ（Anthropic、Bedrock、Google Gemini、Mistral）で機能します。

コスト帰属に加えて、Spaturzu は予算管理機能を提供します。エージェントごとにハードキャップ予算を設定でき、予算が尽きると、プロバイダに到達する前に BudgetExceededError がスローされ、費用の発生を防ぎます。onBreach: "warn" を設定すると、例外をスローする代わりに警告を記録して続行することもできます。

高可用性が必要な場合、Spaturzu はクロスプロバイダフォールバックをサポートします。メインプロバイダがリトライ可能なエラー（429、5xx、接続エラー）を返した場合、SDK は自動的に次の代替プロバイダにリトライし、レスポンスをプライマリプロバイダの形状に変換するため、コードの変更は不要です。現在、20 の方向性を持つプロバイダペアをすべてサポートしていますが、v1 のフォールバックは非ストリーミングのテキストのみに対応し、ツール呼び出しや response_format はサポートしていません。

Spaturzu のもう一つの特徴は、ネストされたエージェントのサポートです。run() メソッドをネストすることで、マルチステップワークフローのコストツリーを構築できます。例えば、「研究」エージェントの中に「統合」サブエージェントを含めることができ、すべての呼び出しはパスに沿って対応するノードに帰属し、ダッシュボードでツリー構造として表示されます。さらに、タグシステムを使用すると、グローバルまたは呼び出しフレームごとにタグを設定し、チーム、顧客、環境ごとにコストを分析できます。

インストールは、Python と TypeScript/Node の両方で可能です。Python パッケージは PyPI で公開されており、Python 3.10+ をサポートします。pip install spaturzu でコアをインストールし、必要に応じて pip install "spaturzu[openai]" のように特定のプロバイダ統合を追加できます。TypeScript パッケージは npm で公開されており、ESM のみ対応です。npm install @spaturzu/sdk でインストールし、使用するプロバイダのクライアントも別途インストールします。

Spaturzu のラッピングは透過的です。ラップされたクライアントは元のクライアントと同じメソッドと戻り値の型を持ち、開発者は従来通りモデルを呼び出すことができ、Spaturzu はバックグラウンドで各呼び出しをメータリングします。短命なプロセス（CLI やサーバーレス関数など）では、終了前に flush() を呼び出してメータリングデータを送信する必要があります。

Spaturzu は MIT ライセンスで公開されており、完全なドキュメント、API リファレンス、その他の例は公式サイト spaturzu.superchiu.org で入手できます。また、実験的な OpenClaw プラグインも提供されていますが、まだプロダクション環境での使用は推奨されていません。