AI 에이전트 개발의 핵심은 이제 단순한 “챗봇 만들기”를 넘어섰습니다. 중요한 것은 모델을 한 번 호출하는 방식이 아니라, 도구 사용, 상태 관리, 여러 에이전트의 협업을 어떻게 설계하느냐입니다.
Google의 ADK 샘플 저장소는 이 설계 방식을 빠르게 살펴볼 수 있는 출발점입니다. 저장소에는 Google ADK를 사용하는 30개의 오픈소스 엔드투엔드 에이전트 예제가 포함되어 있으며, 문서와 소스 코드, 원클릭 배포 기능을 제공한다고 소개되어 있습니다.1 고객지원, 여행 컨시어지, 블로그 작성, 데이터 사이언스, 문서 분석, 금융 상담처럼 다양한 시나리오를 통해 에이전트형 애플리케이션의 구조를 확인할 수 있습니다.1
ADK는 에이전트 앱을 위한 프레임워크다
ADK는 Agent Development Kit의 약자입니다. 문서에서는 에이전트형 애플리케이션을 만들기 위한 오픈소스 Python 프레임워크이자, AI 에이전트의 구축, 평가, 배포를 지원하는 도구로 설명합니다.2
여기서 중요한 점은 ADK가 단순한 프롬프트 모음이 아니라는 것입니다. ADK는 여러 전문 에이전트를 계층 구조로 조합해 모듈형 멀티 에이전트 시스템을 만들 수 있게 합니다.3 예를 들어 검색 담당, 코드 실행 담당, 평가 담당 에이전트를 분리하고, 상위 에이전트가 작업을 배분하는 식의 구조를 설계할 수 있습니다.
이 관점에서 샘플 저장소의 가치는 “어떤 앱을 만들었는가”보다 “에이전트를 어떻게 나누고 연결했는가”에 있습니다.
샘플에서 봐야 할 것은 앱이 아니라 패턴이다
ADK 샘플을 볼 때는 먼저 업무 시나리오보다 구조를 살펴보는 것이 좋습니다. 에이전트가 어떤 역할로 나뉘는지, 어떤 도구를 호출하는지, 작업 흐름이 순차인지 병렬인지, 또는 LLM이 다음 담당 에이전트를 선택하는지 확인해야 합니다.
ADK는 Search, Code Execution 같은 사전 구축 도구를 제공하며, 사용자 정의 함수와 LangChain·CrewAI 같은 외부 에이전트 프레임워크 도구도 통합할 수 있습니다.3 또한 다른 에이전트를 도구처럼 사용할 수 있어, 기능을 작은 단위로 나누고 재사용하는 구조를 만들 수 있습니다.3
오케스트레이션 방식도 핵심입니다. ADK는 SequentialAgent, ParallelAgent, LoopAgent 같은 워크플로 에이전트를 제공하고, LlmAgent transfer를 통해 LLM 기반 동적 라우팅을 지원합니다.3 즉 작업을 정해진 순서로 처리할지, 병렬로 나눌지, 상황에 따라 LLM이 다음 담당자를 고르게 할지 선택할 수 있습니다.
이런 패턴을 예제에서 확인하면, ADK 샘플은 단순 데모가 아니라 실제 에이전트 시스템을 설계할 때 참고할 수 있는 구조적 사례가 됩니다.
개발과 디버깅 경험도 함께 봐야 한다
에이전트 시스템은 실패 원인을 파악하기 어려운 경우가 많습니다. 모델 응답, 도구 호출, 상태 변화, 에이전트 간 전달이 얽히기 때문입니다. 그래서 샘플을 평가할 때는 실행 결과뿐 아니라 개발과 디버깅 흐름도 함께 봐야 합니다.
ADK는 로컬 개발, 테스트, 디버깅을 위한 CLI와 대화형 개발 UI를 제공합니다.3 이 개발 UI에서는 이벤트, 상태, 에이전트 실행 단계를 단계별로 검사할 수 있습니다.3 어떤 에이전트가 어떤 입력을 받았고, 어떤 도구를 호출했으며, 다음 단계로 무엇을 넘겼는지 추적할 수 있다는 뜻입니다.
이 관찰 가능성은 에이전트 개발에서 실험 속도를 크게 좌우합니다. 특히 멀티 에이전트 구조에서는 “왜 원하는 결과가 나오지 않았는가”를 빠르게 확인할 수 있어야 프롬프트, 도구, 라우팅, 상태 설계를 개선할 수 있습니다.
실무에서는 이렇게 활용할 수 있다
처음부터 모든 예제를 훑기보다, 자신의 업무와 가장 가까운 샘플 하나를 고르는 편이 좋습니다. 고객지원, 리서치, 문서 분석, 데이터 사이언스처럼 비슷한 문제를 다루는 예제를 실행한 뒤, 다음 순서로 살펴보면 실용적입니다.
에이전트가 어떤 역할로 분리되어 있는지 확인한다.
각 에이전트가 어떤 도구를 호출하는지 본다.
작업 흐름이 순차, 병렬, 반복, 동적 라우팅 중 어떤 방식인지 파악한다.
개발 UI에서 이벤트, 상태, 실행 단계를 추적한다.
모델보다 먼저 도구와 데이터 연결부를 자신의 환경에 맞게 바꾼다.
특히 마지막 단계가 중요합니다. 샘플을 업무용 프로토타입으로 바꾸려면 모델 교체보다 실제 데이터 API, 내부 검색, 업무 규칙 함수 같은 도구 연결을 먼저 검토하는 편이 효과적입니다. 에이전트의 실용성은 결국 모델이 무엇을 알고 있는가보다, 어떤 도구와 데이터에 안전하게 접근할 수 있는가에 크게 좌우됩니다.
다만 저장소는 데모 목적이며, 프로덕션 사용을 전제로 한 공식 지원 제품은 아니라고 명시되어 있습니다.1 따라서 샘플을 완성품으로 받아들이기보다는, 설계 패턴과 구현 흐름을 배우는 참고서로 보는 것이 안전합니다.
결론적으로 Google ADK 샘플의 의미는 “30개 예제”라는 숫자에만 있지 않습니다. 더 중요한 가치는 에이전트를 어떻게 나누고, 연결하고, 관찰하고, 배포 가능한 구조로 키울 수 있는지 보여준다는 점입니다. ADK를 처음 살펴본다면 샘플 하나를 실행하는 것에서 시작해, 그 안의 역할 분리와 도구 호출, 라우팅 패턴을 읽어보는 것이 가장 현실적인 접근입니다.
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.