メインコンテンツへスキップ
Weave for Agents はパブリック プレビューです。一般提供前に、機能、API、Agents view UI は変更される可能性があります。
Claude Agent SDK は、Claude を使用してエージェント アプリケーションを構築するための Python SDK です。 Weave は、エージェントのクエリ、モデルの応答、ツールの使用、複数ターンの会話を含む Claude Agent SDK の Call を自動的にトレースします。Weave は、取得したデータを project の Agents ビューに表示します。

Claude Agent SDK エージェントを Weave でトレースする

Weave SDK では Claude Agent SDK に自動でパッチが適用されるため、最小限のセットアップで Claude エージェントのトレースを取得できます。 このドキュメントでは、Weave を初期化し、ClaudeSDKClient を介して MCP ツールを使う Claude エージェントを実行する方法を説明します。Weave は会話、モデルの Call、ツールの Call をエンドツーエンドで自動的にトレースします。完了したら、project の Agents ビューで、エージェントのクエリ、モデルの応答、ツールの呼び出しの完全なトレースを表示できます。

前提条件

  • W&B アカウントと、WANDB_API_KEY 環境変数として設定された APIキー
  • ANTHROPIC_API_KEY 環境変数として設定された Anthropic APIキー。
  • Python 3.10+。

パッケージをインストールする

開発環境に以下のパッケージをインストールします。weave パッケージはトレースを取得し、claude-agent-sdk はエージェントのランタイムを提供します。

コードで Weave を初期化する

project に weave.init を追加し、W&B のチーム名とプロジェクト名を更新してから、通常どおりエージェントを構築します。weave.init は、Claude Agent SDK からトレースを取得する自動パッチ適用を有効にします。 次のコードでは、2 つの MCP 数学ツールを備えた Claude エージェントを作成し、Weave がトレースを取得しながら実行します。
スクリプトを実行すると、weave.init() が project へのリンクを出力します。リンクを開くと、エージェントのクエリ、モデルの応答、ツールの Callについて取得されたトレースを確認できます。 Weave でエージェントのデータを表示する方法について詳しくは、エージェントのアクティビティを表示を参照してください。