Skip to main content
Google의 Agent Development Kit(ADK)는 에이전트를 구축하고 오케스트레이션하기 위한 유연한 프레임워크로, 특정 모델에 종속되지 않습니다. ADK는 Gemini에 최적화되어 있지만 모든 모델을 지원하며, 단순한 작업부터 복잡한 멀티 에이전트 워크플로까지 폭넓게 지원합니다. Weave는 ADK로 구축한 에이전트를 자동으로 트레이스하며, 각 에이전트 호출, 하위 에이전트 핸드오프, 모델 Call, 도구 Call을 모두 기록합니다. 캡처된 데이터는 프로젝트의 Agents 뷰에서 확인할 수 있습니다.

Weave로 Google ADK 에이전트 트레이스하기

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 초기화하기

프로젝트에 weave.init을 추가하고 CoreWeave Forge 팀 이름과 프로젝트 이름을 지정한 다음, 평소처럼 에이전트를 구축하세요. 다음 코드는 gemini-2.5-flash와 wikipedia_search 도구를 사용하는 research_assistant 에이전트를 생성한 후, 하나의 ADK 세션에서 세 가지 질문을 실행합니다. 이 과정에서 Weave가 트레이스를 캡처합니다.
이 예시는 하나의 ADK 세션에서 세 개의 턴을 실행합니다. 처음 두 턴에서는 Wikipedia 조회가 트리거되고, 세 번째 턴에서는 도구 Call 없이 이전 대화 컨텍스트를 활용해 요약을 생성합니다.

Agents 뷰에서 에이전트 트레이스 확인하기

스크립트가 실행되면 weave.init()이 프로젝트 링크를 출력합니다. Agents 뷰를 열어 다음을 확인하세요:
  • 대화의 턴을 포함하는 세션.
  • 중첩된 chat 및 execute_tool 하위 항목이 있는 invoke_agent span으로 표시되는 각 턴.
  • 각 단계의 전체 입력, 모델, 출력, 토큰 사용량 및 도구 결과.
Weave에서 Agents 데이터를 확인하는 방법에 대한 자세한 내용은 에이전트 활동 확인하기를 참조하세요.
마지막 수정일 2026년 9월 30일