구글 ADK 병렬 에이전트(ParallelAgent) 실습: 리서치 에이전트 3개 동시 실행과 통합 리포트 만들기

핵심 메시지

• 병렬 에이전트는 하위 에이전트를 동시에 실행하는 워크플로우 에이전트로, 서로 의존하지 않는 작업이 있을 때 전체 처리 시간을 크게 줄인다.
• 한 시간짜리 리서치 에이전트가 세 개라면 순차 실행은 세 시간이 걸리지만 병렬 실행은 약 한 시간에 끝난다.
• 병렬 에이전트는 언어모델이 판단해 흐름을 정하는 것이 아니라 실행 방식과 제어 흐름이 미리 정해져 있는 구조다.
• 각 리서치 에이전트에 아웃풋 키를 지정하면 뒤에 오는 리포트 작성 에이전트가 그 키를 참조해 결과를 하나로 묶을 수 있다.
• 병렬 에이전트와 순차 에이전트를 겹쳐 쓰면 '동시에 조사한 뒤 하나로 정리하는' 복합 파이프라인이 만들어진다.

쉽게 이해하기

구글 ADK의 워크플로우 에이전트는 세 가지 유형이 있는데, 이 강의는 마지막 유형인 병렬 에이전트를 다룬다. 이름 그대로 등록된 하위 에이전트들을 동시에 실행하는 구조다. 서로 결과를 주고받을 필요가 없어 독립적으로 돌아갈 수 있는 작업이라면, 순서대로 처리할 이유가 없으니 한꺼번에 실행해 전체 시간을 줄이자는 발상이다.

효과는 단순한 산수로 설명된다. 리서치 에이전트 하나가 한 시간 걸린다고 할 때, 세 개를 순차로 돌리면 세 시간이 걸리지만 병렬로 묶으면 한 시간 정도에 끝난다. 강의는 또 한 가지를 강조하는데, 병렬 에이전트는 다른 워크플로우 에이전트와 마찬가지로 언어모델이 그때그때 판단해 흐름을 정하는 방식이 아니라는 점이다. 무엇을 어떤 방식으로 실행할지가 이미 코드로 결정돼 있다.

실습 예제는 재생 가능 에너지, 전기차 기술, 탄소 포집 방법 세 주제를 동시에 조사한 뒤 하나의 리포트로 묶는 리서치 에이전트다. 주제별 리서치 에이전트 세 개와 결과를 합치는 리포트 작성 에이전트 한 개, 총 네 개의 하위 에이전트를 만든다. 리서치 에이전트들은 모두 같은 구조라 하나를 완성한 뒤 복사해서 변수명, 이름, 설명, 지시문의 주제 부분, 아웃풋 키만 바꾸는 식으로 빠르게 만든다.

리서치 에이전트에는 두 가지 설정이 핵심이다. 하나는 ADK가 기본으로 제공하는 구글 검색 내장 도구를 툴로 등록하는 것이다. 앞선 강의에서는 반복을 끝내는 함수를 직접 파이썬으로 구현해 등록했지만, 이번에는 직접 만들지 않고 제공되는 도구를 가져다 쓴다. 다른 하나는 아웃풋 키로, 각 에이전트가 조사한 결과를 저장할 이름을 지정해 두면 뒤에서 참조할 수 있다. 반면 리포트 작성 에이전트는 이미 조사된 내용을 받아 정리해 출력하기만 하므로 도구도 아웃풋 키도 필요 없다.

루트 에이전트에서는 두 종류를 함께 쓴다. 먼저 리서치 에이전트 세 개를 병렬 에이전트의 하위 에이전트로 등록하고, 그다음 이 병렬 에이전트와 리포트 작성 에이전트를 순차 에이전트에 순서대로 등록한다. 병렬 에이전트는 어차피 동시에 실행되므로 등록 순서가 의미 없지만 순차 에이전트는 등록한 순서대로 실행되므로 순서가 중요하다. 마지막으로 이 순차 에이전트를 반드시 루트 에이전트라는 변수명에 할당해야 ADK가 시작점으로 인식한다. 실행 후 웹 UI의 트레이스를 열면 순차 파이프라인이 먼저 호출되고, 세 리서치 에이전트가 병렬로 실행된 뒤, 리포트 작성 에이전트가 마지막에 호출되는 흐름을 눈으로 확인할 수 있다.

주요 인사이트

• 에이전트 설계에서 속도를 좌우하는 것은 모델 성능만이 아니다. 작업 사이에 의존 관계가 있는지 없는지를 먼저 따져보면 구조만 바꿔도 실행 시간이 크게 줄어든다.
• 워크플로우 에이전트는 흐름을 모델의 판단에 맡기지 않고 코드로 고정한다. 순서가 명확한 작업이라면 모델에게 맡기는 것보다 예측 가능하고 디버깅도 쉽다.
• 아웃풋 키는 병렬로 흩어진 결과를 다시 모으는 접착제 역할을 한다. 결과를 만들어내는 쪽과 소비하는 쪽이 같은 이름을 공유해야 파이프라인이 이어진다.
• 병렬과 순차를 겹쳐 쓰는 것이 실전 구조에 가깝다. 조사는 동시에, 종합은 그 뒤에라는 패턴은 리서치뿐 아니라 데이터 수집, 이미지 처리 등에 그대로 적용된다.
• 웹 UI의 트레이스 화면은 의도한 순서대로 호출됐는지 확인하는 검증 수단이다. 결과만 보고 넘어가면 병렬 실행이 실제로 이뤄졌는지 알기 어렵다.

자주 묻는 질문

관련 AI 소식