Weave for Agents はパブリック プレビューです。一般提供前に、機能、API、Agents view UI は変更される可能性があります。
Claude Agent SDK エージェントを 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 はエージェントのランタイムを提供します。
pip install weave claude-agent-sdk
weave.init を追加し、W&B のチーム名とプロジェクト名を更新してから、通常どおりエージェントを構築します。weave.init は、Claude Agent SDK からトレースを取得する自動パッチ適用を有効にします。
次のコードでは、2 つの MCP 数学ツールを備えた Claude エージェントを作成し、Weave がトレースを取得しながら実行します。
import anyio
import weave
from claude_agent_sdk import (
ClaudeAgentOptions,
ClaudeSDKClient,
create_sdk_mcp_server,
tool,
)
weave.init("[YOUR-TEAM]/[YOUR-PROJECT]")
@tool("add", "Add two numbers", {"a": float, "b": float})
async def add(args: dict) -> dict:
return {"content": [{"type": "text", "text": str(args["a"] + args["b"])}]}
@tool("multiply", "Multiply two numbers", {"a": float, "b": float})
async def multiply(args: dict) -> dict:
return {"content": [{"type": "text", "text": str(args["a"] * args["b"])}]}
math_server = create_sdk_mcp_server(
name="math",
version="1.0.0",
tools=[add, multiply],
)
async def main():
options = ClaudeAgentOptions(
mcp_servers={"math": math_server},
allowed_tools=["mcp__math__add", "mcp__math__multiply"],
)
async with ClaudeSDKClient(options=options) as client:
await client.query("Using the math tools, compute (3 + 7) * 2.")
async for message in client.receive_response():
print(message)
anyio.run(main)
weave.init() が project へのリンクを出力します。リンクを開くと、エージェントのクエリ、モデルの応答、ツールの Callについて取得されたトレースを確認できます。
Weave でエージェントのデータを表示する方法について詳しくは、エージェントのアクティビティを表示を参照してください。
