Email Drafter — Google ADK 및 Cloud Run을 활용한 다중 에이전트 이메일 작성

Source: Dev.to

What I Built

저는 Email Drafter라는 작은 웹 앱을 만들었습니다. 이 앱은 구조화된 사용자 입력을 다중 에이전트 워크플로우를 통해 다듬어진 이메일 초안으로 변환합니다.
앱이 수집하는 항목은 다음과 같습니다:

• 수신자 유형
• 목적
• 어조
• 언어
• 핵심 포인트

단일 거대한 프롬프트 대신, 워크플로우는 여러 전문 역할로 나뉩니다:

1. 한 에이전트가 이메일을 계획합니다.
2. 한 에이전트가 계획을 검토합니다.
3. 한 에이전트가 최종 초안을 작성합니다.
4. 오케스트레이터가 워크플로우를 조정합니다.

각 서비스는 Google Cloud Run에 별도로 배포되어, 로컬 프로토타입이 아닌 보다 현실적인 분산 AI 아키텍처를 제공합니다. 이메일 초안 작성을 선택한 이유는 계획, 검토, 작성이 자연스럽게 구분되는 작업으로, 다중 에이전트 오케스트레이션을 테스트하기에 이상적인 사례이기 때문입니다.

Agents

Researcher Agent

사용자 입력으로부터 구조화된 이메일 계획을 생성합니다.

Judge Agent

계획을 검토하고, 다음 단계로 진행하기에 충분히 완전한지 확인합니다.

Content Builder Agent

승인된 계획을 바탕으로 최종 이메일 초안을 작성합니다.

Orchestrator Agent

다른 에이전트들 간의 워크플로우를 조정하고, 최종 결과를 프런트엔드에 반환합니다.

Overall Flow

Frontend → Orchestrator → Researcher → Judge → Content Builder → Final Email Draft

Lessons Learned

• 모듈식 디버깅: 워크플로우를 분리함으로써 문제가 계획, 검토, 혹은 작성 중 어느 단계에서 발생했는지 쉽게 파악할 수 있었습니다.
• 배포 복잡성: 여러 서비스를 로컬에서 실행하고 서로 연결한 뒤 Cloud Run에 배포하는 과정은 핵심 프롬프트 로직보다 더 많은 노력이 필요했습니다.
• 프롬프트 표현의 중요성: 지시문의 작은 변화가 출력 품질에 큰 영향을 미쳐, 일반적인 계획에서 실제 이메일 초안으로 응답이 크게 달라졌습니다.
• 프로덕션 준비 설계: 간단한 도구라도 책임을 분리하면 보다 모듈화되고 유지보수가 쉬우며 확장 가능한 시스템을 만들 수 있습니다.

Demo & Resources

• Video Demo – (link to video)
• Live App – (link to deployed app)
• GitHub Repo – (link to source code)