Weave로 Google ADK 에이전트 트레이스하기
- Python
- TypeScript
Weave SDK는 Python용 Google ADK에 자동으로 패치되므로, 최소한의 설정만으로 ADK 에이전트의 트레이스를 캡처할 수 있습니다. 이 가이드에서는 Weave를 초기화한 다음 Google ADK로 빌드한 멀티턴 리서치 에이전트를 실행해, Weave가 Session 전반에서 모든 에이전트 호출, 모델 Call, 도구 Call을 캡처하도록 하는 방법을 설명합니다.
사전 요구 사항
WANDB_API_KEY환경 변수로 설정된 W&B 계정 및 API 키- Gemini용 Google API 키
- Python 3.10+
패키지 설치
코드에서 Weave 초기화하기
- Python
- TypeScript
코드에서 이 예시는 하나의 ADK Session에서 세 번의 턴으로 진행됩니다. 처음 두 턴에서는 Wikipedia 조회가 트리거되고, 세 번째 턴에서는 도구 Call 없이 이전 대화 컨텍스트를 바탕으로 요약을 생성합니다.
weave.init를 호출하고 W&B 팀 이름과 프로젝트 이름을 함께 지정한 다음, 평소처럼 에이전트를 구축하세요. 다음 코드는 gemini-2.5-flash와 wikipedia_search 도구를 사용하는 research_assistant 에이전트를 생성하고, Weave가 트레이스를 캡처하는 동안 하나의 ADK Session에서 세 가지 질문을 실행합니다.Agents 뷰에서 에이전트 트레이스를 확인하세요
weave.init()가 프로젝트 링크를 출력합니다. 다음 항목을 살펴보려면 Agents 뷰를 여세요.
- 대화의 턴이 포함된 세션.
chat및execute_tool하위 span이 중첩된invoke_agentspan으로 렌더링된 각 턴.- 각 단계의 전체 입력, 모델, 출력, 토큰 사용량, 도구 결과.