Weave for Agents는 공개 프리뷰 상태입니다. 정식 출시 전에 특성, API 및 Agents 뷰 UI가 변경될 수 있습니다.
Weave로 Claude Agent SDK 에이전트 트레이스하기
ClaudeSDKClient를 통해 MCP 도구와 함께 Claude 에이전트를 실행하는 방법을 설명합니다. Weave가 대화, 모델 Call, 도구 Call을 전체 흐름에 걸쳐 자동으로 트레이스합니다. 완료되면 프로젝트의 Agents 뷰에서 에이전트의 쿼리, 모델 응답, 도구 호출에 대한 전체 트레이스를 확인할 수 있습니다.
- W&B 계정과 API 키를
WANDB_API_KEY 환경 변수로 설정.
- Anthropic API 키를
ANTHROPIC_API_KEY 환경 변수로 설정.
- Python 3.10+.
개발 환경에 다음 패키지를 설치하세요. weave 패키지는 트레이스를 캡처하고, claude-agent-sdk는 에이전트 런타임을 제공합니다.
pip install weave claude-agent-sdk
weave.init를 추가하고, W&B 팀 이름과 프로젝트 이름을 업데이트한 뒤, 평소처럼 에이전트를 구축하세요. weave.init는 Claude Agent SDK의 트레이스를 캡처하는 자동 패칭을 활성화합니다.
다음 코드는 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()가 프로젝트 링크를 출력합니다. 링크를 열어 에이전트의 쿼리, 모델 응답, 도구 Call이 캡처된 트레이스를 확인하세요.
Weave에서 에이전트 데이터를 확인하는 방법에 대한 자세한 내용은 에이전트 활동 보기를 참조하세요.
