Aria Han

PyPI 배포 완료, MIT

agentmailkit

모델이 본문을 작성하더라도, 예약 발송 메일의 구조와 레이아웃은 매일 결정론적으로 일관되어야 합니다.

해결한 문제

클라우드 비서는 메일 예약이 가능하지만 로컬 파일에 접근하거나 개인 메일함으로 발송하지 못합니다. 로컬 에이전트는 둘 다 가능하지만 매번 출력 레이아웃이 달라져 업무적 신뢰도를 잃기 쉽습니다.

구축 내용

단일 메일을 JSON 작업 정의와 마크다운 프롬프트라는 두 개의 파일로 분리했습니다. 유형별 차이는 독립된 플러그인으로 처리하여 코드 수정 없이 데이터 추가만으로 새 다이제스트를 확장할 수 있습니다.

모델은 오직 문장 생성만 담당하고 결정론적 렌더러가 전체 레이아웃을 엄격하게 제어합니다. 동일한 작업은 매번 동일한 포맷을 생성하며 바뀌는 것은 본문 내용뿐입니다.

작업 ID와 URL 기반의 seen-ledger를 통해 프롬프트 생성 전 중복 소스를 필터링하고 실제 발송 성공 시에만 기록하여 중복 전송을 방지합니다.

검증 결과

5종의 예제 작업이 기본 탑재되어 설치 즉시 날씨, 뉴스, arXiv 피드 기반의 다이제스트를 생성합니다. 36개 단위 테스트, 오프라인 결정론적 검증 완료. 코드 레벨에서 드라이 런 및 퀵스타트 모드의 오발송을 원천 차단합니다.

학습한 점

콘텐츠와 레이아웃을 분리하는 것이 AI 출력의 일관성을 보장하는 핵심입니다. 결정론적 통제가 필수적인 기능이며, 무제한적 자율성은 오히려 오류를 유발합니다.

자체 검증된 개인 자동화 시스템을 타인이 설치하여 즉시 운용할 수 있는 독립 패키지로 고도화한 역량을 증명합니다.

기술 스택

Python · Append-only JSONL ledger · Zero required dependencies

status
배포 완료 · PyPI + GitHub
stack
Python · 필수 의존성 제로
install
pip install agentmailkit
license
MIT

관련 링크

모델은 문장만 작성하고, 나머지 시스템 제어는 엔진이 전담합니다.

연계 프로젝트