Weave로 Claude Agent SDK 에이전트 트레이싱하기
- Python
- TypeScript
Weave SDK는 Python용 Claude Agent SDK를 자동 패치하여 최소한의 설정으로 Claude 에이전트의 트레이스를 캡처할 수 있게 합니다.이 가이드에서는 Weave를 초기화하고
ClaudeSDKClient를 통해 MCP 도구를 사용하는 Claude 에이전트를 실행하는 방법을 설명합니다. Weave는 대화, 모델 Call, 도구 Call을 처음부터 끝까지 자동으로 트레이싱합니다.사전 요구 사항
- CoreWeave Forge 계정과
WANDB_API_KEY환경 변수로 설정한 API 키. ANTHROPIC_API_KEY환경 변수로 설정한 Anthropic API 키.- Python 3.10 이상.
패키지 설치
개발 환경에 다음 패키지를 설치하세요.weave 패키지는 트레이스를 캡처하며, claude-agent-sdk는 에이전트 런타임을 제공합니다.
코드에서 Weave 초기화
- Python
- TypeScript
프로젝트에 스크립트가 실행되면
weave.init을 추가하고, CoreWeave Forge 팀 및 프로젝트 이름을 업데이트한 다음, 평소처럼 에이전트를 구축하세요. weave.init은 Claude Agent SDK의 트레이스를 자동으로 수집하고 기록하는 자동 패치 기능을 활성화합니다.다음 코드는 두 개의 MCP 수학 도구를 사용하는 Claude 에이전트를 생성하고 실행하며, Weave는 실행 중 트레이스를 수집하고 기록합니다.weave.init()이 프로젝트 링크를 출력합니다. 링크를 열어 에이전트의 쿼리, 모델 응답 및 도구 Call에 대해 캡처된 트레이스를 확인하세요.Agents 뷰에서 에이전트 트레이스 확인하기
스크립트가 실행되면weave.init()이 프로젝트 링크를 출력합니다. Agents 뷰를 열어 다음을 확인하세요:
- 대화의 턴을 포함하는 세션.
- 중첩된
chat및execute_tool하위 항목이 있는invoke_agentspan으로 표시되는 각 턴. - 각 단계의 전체 입력, 모델, 출력, 토큰 사용량 및 도구 결과.