Weave로 Google ADK 에이전트 트레이스하기
- Python
- TypeScript
Weave SDK는 Google ADK for Python을 자동 패치하므로 최소한의 설정만으로 ADK 에이전트의 트레이스를 캡처할 수 있습니다. 이 가이드에서는 Weave를 초기화한 다음, Google ADK로 구축한 멀티턴 리서치 에이전트를 실행하는 방법을 보여줍니다. 이렇게 하면 Weave가 세션 전체에서 발생하는 모든 에이전트 호출, 모델 Call, 도구 Call을 캡처합니다.
사전 요구 사항
- CoreWeave Forge 계정 및
WANDB_API_KEY환경 변수로 설정된 API 키. - Gemini용 Google API 키.
- Python 3.10 이상.
패키지 설치
개발 환경에 다음 패키지를 설치하세요. 이 패키지는 Weave SDK, Google ADK 프레임워크, 예시 도구에서 사용하는 HTTP 클라이언트를 제공합니다.코드에서 Weave 초기화하기
- Python
- TypeScript
프로젝트에 이 예시는 하나의 ADK 세션에서 세 개의 턴을 실행합니다. 처음 두 턴에서는 Wikipedia 조회가 트리거되고, 세 번째 턴에서는 도구 Call 없이 이전 대화 컨텍스트를 활용해 요약을 생성합니다.
weave.init을 추가하고 CoreWeave Forge 팀 이름과 프로젝트 이름을 지정한 다음, 평소처럼 에이전트를 구축하세요. 다음 코드는 gemini-2.5-flash와 wikipedia_search 도구를 사용하는 research_assistant 에이전트를 생성한 후, 하나의 ADK 세션에서 세 가지 질문을 실행합니다. 이 과정에서 Weave가 트레이스를 캡처합니다.Agents 뷰에서 에이전트 트레이스 확인하기
스크립트가 실행되면weave.init()이 프로젝트 링크를 출력합니다. Agents 뷰를 열어 다음을 확인하세요:
- 대화의 턴을 포함하는 세션.
- 중첩된
chat및execute_tool하위 항목이 있는invoke_agentspan으로 표시되는 각 턴. - 각 단계의 전체 입력, 모델, 출력, 토큰 사용량 및 도구 결과.