メインコンテンツへスキップ
Claude Agent SDK は、Claude を使ったエージェントアプリケーションを構築するための Anthropic 製 Python SDK です。weave.init() を呼び出すと、W&B Weave は Claude Agent SDK の呼び出しを自動的にトレースし、クエリ、ツールの使用状況、複数ターンの会話を記録します。

前提条件

コード例を実行する前に、以下を確認してください。
  • コード109行目で weave.init() を呼び出せるよう、your-team-name を適切な値に更新します。
  • 環境変数に WANDB_API_KEYANTHROPIC_API_KEY を設定します。
    • W&B APIキーの詳細は、API keys を参照してください。

インストール

pip を使用して、必要な依存関係をインストールします。

はじめに

Claude Agent SDK を使用する前に weave.init() を呼び出すと、Weave は SDK に自動的にパッチを適用し、すべてのクエリをトレースします。 次の例では、3 つの機能を紹介します。
  • query() 関数を使用したシンプルな単発クエリ。モデルのレスポンスとコストも含まれます。
  • ClaudeSDKClient を使用したMCP ツールの利用。Claude Agent SDK は、インプロセス MCP サーバーを通じてカスタムツールをサポートします。
    • Weave は、ツール定義、ツール呼び出し、実行結果を、エージェントのクエリとあわせてトレースします。
    • MCP デモでは、2 つの MCP ツールを定義し、それらを使用するクエリを実行します。
  • weave.thread() を使用して 1 つのトレースにまとめた複数ターンの会話。これにより、Weave UI で会話全体の流れを確認できます。
    • Weave は各ターンをスレッドの子として記録するため、Weave UI で会話全体の流れを確認できます。

トレースを表示

この例を実行すると、Weave ダッシュボードへのリンクが表示されます。リンクを開くと、クエリの入力、モデルの応答、ツール呼び出し、会話スレッドなどを含むトレースを確認できます。