ADK·MCP 멀티 에이전트 구축법 — 구글의 영화 추천 에이전트로 본 실전 패턴

핵심 메시지

• 구글의 ADK(Agent Development Kit)와 MCP(Model Context Protocol), Gemini 3 Flash를 조합하면 단순 데모를 넘어 프로덕션급 멀티 에이전트를 구성할 수 있다.
• 루트 에이전트는 각 하위 에이전트의 description을 읽어 요청을 분배하므로, 개발자가 if-else 라우팅 로직을 직접 쓸 필요가 없다.
• MCP의 fetch 서버를 통해 에이전트가 실제 웹페이지(예: 로튼토마토)를 직접 읽어 실시간 데이터를 가져온다 — 별도 API나 하드코딩된 데이터가 없다.
• 입력·출력·도구 호출 세 지점에 안전 콜백을 걸어 프롬프트 인젝션 차단, PII 차단, 인자 검증을 계층적으로 수행한다.
• 세션 상태(session state)와 명령어 템플릿팅으로 관심목록이 대화 턴을 넘어 유지되고, 프롬프트가 사용자 맥락에 맞춰 자동으로 바뀐다.

쉽게 이해하기

영상은 "Critiques Cut"이라는 영화 도우미 에이전트를 예로 든다. 사용자가 "다크 나이트 리뷰해줘"라고 한 문장만 입력하면, 뒤에서 평론 에이전트·추천 에이전트·관심목록 관리 에이전트가 협업해 결과를 만들어 낸다. 핵심은 영화라는 소재가 아니라, 같은 패턴을 고객 지원·리서치·이커머스 같은 영역에 그대로 옮길 수 있다는 점이다.

라우팅 방식이 인상적이다. 각 하위 에이전트에는 description 필드가 있고, 사용자 메시지가 들어오면 루트 에이전트의 LLM이 그 설명들을 읽어 가장 적합한 에이전트를 고른다. 즉 의도 분류를 LLM이 description 기반으로 처리하므로, 개발자가 조건 분기 코드를 작성하지 않는다. 그래서 description을 잘 쓰는 일이 곧 설계의 핵심이 된다.

MCP는 에이전트를 외부 도구 서버에 연결하는 통로다. 영상에서는 오픈소스 fetch 서버를 붙여 "임의의 URL을 가져오는" 도구 하나를 에이전트에 부여한다. ADK의 MCP 툴셋이 서버를 자식 프로세스로 띄우고, 표준 입출력 전송을 관리하고, 노출된 도구를 발견해 에이전트에 연결하는 전체 생명주기를 한 번의 선언으로 처리한다. 덕분에 평론 에이전트가 로튼토마토 페이지를 실제로 읽어 평점을 가져온다.

관심목록은 MCP 대신 직접 만든 파이썬 함수 도구로 구현했다. ADK는 함수 시그니처와 docstring을 읽어 도구 스키마를 자동 생성한다. 여기에 Pydantic 모델로 타입 안전성을 더해, 허용된 동작(추가·삭제·조회)을 enum으로 제약하고 결과를 구조화했다. 특히 tool_context 파라미터를 선언하면 ADK가 실행 시점에 세션 맥락을 주입해, 관심목록을 세션 상태에서 읽고 다시 쓰며 턴을 넘어 보존한다.

안전성은 세 단계 콜백으로 처리한다. before_model 콜백은 LLM 호출 전에 사용자 입력을 정규식으로 검사해 "이전 지시 무시" 같은 프롬프트 인젝션을 잡아내고, 매치되면 모델을 아예 호출하지 않고 즉시 거절 응답을 돌려 토큰과 지연을 0으로 만든다. after_model 콜백은 모델 출력에서 이메일·전화번호 등 개인정보를 걸러내고, before_tool 콜백은 도구 실행 전 인자(제목 길이, 목록 상한 등)를 검증한다. 전체 프로젝트는 단 네 개의 파이썬 파일로 구성된다.

주요 인사이트

• 라우팅을 코드가 아니라 description으로 다루면, 새로운 기능을 추가할 때 분기문을 고치는 대신 설명을 다듬는 식으로 확장할 수 있다.
• 정규식 기반 입력 검사는 결정론적이고 비용이 0이라, 알려진 공격 패턴에는 LLM 판별보다 효율적이다. 새로운 공격에 대비한 LLM 분류기는 그 위에 얹는 방어 심화(defense in depth) 구조가 합리적이다.
• 에이전트 상태를 모듈 전역 변수가 아니라 ADK의 세션 상태 엔진에 저장하면, 별개의 턴이나 다른 에이전트에서도 같은 데이터를 안전하게 읽고 쓸 수 있다.
• 명령어 템플릿팅(중괄호 구문)으로 세션 상태 값을 프롬프트에 자동 주입하면, "이미 목록에 있는 영화는 추천하지 말라" 같은 맥락 인지 동작을 별도 코드 없이 구현할 수 있다.
• 루트 에이전트의 글로벌 명령은 계층 전체에 적용되어, 어느 하위 에이전트가 활성화되든 일관된 형식과 주제 이탈 방지를 보장한다.

자주 묻는 질문

관련 AI 소식