본문으로 건너뛰기

Goolge ADK 탐험 - 2. Sub Agent 만들기

리부티너

2026.01.28

Goolge ADK 탐험 - 2. Sub Agent 만들기 본문 이미지

google codelab의 ADK로 Multi Agent Sytem 만들기

를 실습해보면서, 코드로 작성하는 ADK Agentt와 Visual Builder로 각각 Sub Agent를 만들 때 어떻게 차이가 나는지 궁금해서 실험을 해보았습니다.

해당 Agent는 고객이 원하는 여행지( contry, city 등) 를 고를 수 있게 도와주고, 해당 여행지에 추천 여행 attraction을 안내하는 기능을 제공한다.

state를 저장해서 고객이 선택한 내용을 저장할 수 있다.

1. ADK를 이용해 python Agent 구성
환경을 구성하고 Agent 만든다. ( google cloud console에서 만든 Project ID 필요)

# 1. Project 구성
gcloud config set project <your-project-id>

# 2. API 사용
gcloud services enable aiplatform.googleapis.com

# 3. 가상환경
mkdir ai-agents-adk
cd ai-agents-adk

# uv venv --python 3.12
source .venv/bin/activate   # (window인 경우 source .venv/Scripts/activate)

# 4. ADK 설치
uv pip install google-adk

# 5. agent 생성
adk create personal_assistant

코드 생성

Agent를 두개 만들고,

Root Agent에 sub agent 로 두개를 연결해줌.

선택했던 응답을 저장하기 위해 도구 함수를 호출해서 State로 저장해 줍니다.
나중에 필요하면 다른 agent에서도 쓸수 있겠네요.

2. Visual Builder

프롬프트는 위의 Python으로 작성했던 Agent 내용을 그대로 적어두었습니다.


작동 내용은 그대로 작동함.


3. 두 방법 비교

1️⃣ parent_and_subagent (Code-First Approach)

파일: agent.py 단일 파일.

내용: Python 코드로 Agent 클래스를 직접 인스턴스화합니다.

특징: before_model_callback, after_model_callback 같은 파이썬 함수 형태의 훅이나, save_attractions_to_state 같은 Tool 함수가 파일 내에 직접 포함되어 있습니다.
모델 응답에 대한 temperature 세팅이나 이런 부분 등 detail한 설정을 구현하기 좋습니다.

2️⃣ parent_and_subagent2 (Configuration-First Approach)

파일: root_agent.yaml, travel_brainstomer.yaml, attractions_planner.yaml 로 분리.

내용: 선언적(Declarative)으로 에이전트의 속성(이름, 모델, 지시사항 등)을 정의합니다.

특징: sub_agents 속성에서 다른 YAML 파일을 config_path로 참조하여 계층 구조를 만듭니다(예: root_agent.yaml에서 나머지를 참조). 코드를 몰라도 내용을 이해하고 수정하기 쉽지만, 동적인 로직을 넣으려면 별도의 연결 작업이 필요합니다.

결론: 개발자가 세밀한 동작 제어와 로깅 같은 기능을 넣으려면 Python 방식(1번)이 유리하고, 단순히 프롬프트 엔지니어링과 에이전트 구조 설계에 집중하려면 YAML 방식(2번)이 더 깔끔합니다.

느낀 점

  • 동일하게 동작하는 Agent도 Visual Builder에서는 디테일한 세팅과 사용방법을 찾기가 아직은 어렵다.

  • eval 세팅하는 방법을 알아서 테스트 해보고 싶음

참고자료

google codelab의 ADK로 Multi Agent Sytem 만들기

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기