이메일을 코드로 변환하는 EPB: AI 기반의 이메일에서 생성된 Pull Request 시스템

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

DevOps

대상자

• 개발자 및 DevOps 엔지니어에게 유용
• 중간 수준의 이해가 필요 (Postmark, GitHub, AI 모델 연동 기술)

핵심 요약

• EPB는 이메일을 통해 Mistral AI의 codestral 모델을 사용해 GitHub Pull Request를 자동 생성하는 시스템
• Postmark의 Inbound Webhook을 통해 이메일을 수신하고, Vercel 서버리스 함수에서 처리
• GitHub API를 사용해 코드 생성, 브랜치 생성, PR 생성 등 DevOps 흐름 자동화
• 코드 품질 향상을 위한 컨텍스트 분석 및 에러 피드백 기능 구현

섹션별 세부 요약

1. 시스템 아키텍처

• Postmark Inbound Webhook 설정: 이메일 수신 및 JSON 파싱을 통해 요청 내용 추출
• Vercel 서버리스 함수에서 처리 로직 실행: 이메일 본문 분석 및 AI 모델 호출
• Mistral AI의 codestral-latest 모델을 사용해 컨텍스트 기반 코드 생성
• GitHub API 연동: 생성된 코드를 브랜치에 커밋하고 PR 생성

2. 주요 기능 구현

• 이메일 파싱: 정규식과 fallback 메커니즘으로 이메일 제목/본문에서 요구사항 추출
• 리포지토리 분석: 기존 코드 패턴과 파일 구조 분석을 통해 AI 모델에 컨텍스트 제공
• 코드 생성: AI 모델에 리포지토리 정보를 포함한 커스텀 프롬프트 제공
• PR 생성: GitHub에서 브랜치 생성, 커밋, PR 오픈 자동화

3. 에러 처리 및 피드백

• 에러 로그 수집: GitHub 접근 시 오류 발생 시 Postmark를 통해 이메일로 상세 피드백 전달
• HTML 이메일 템플릿: 성공/실패 시 사용자 친화적인 이메일 형식 제공
• 트러블슈팅 가이드: 에러 메시지에 구체적인 해결 방안 포함

결론

• Postmark의 Inbound Webhook과 GitHub API 연동을 통해 이메일 기반 DevOps 자동화 가능
• 테스트용 리포지토리 bO-05/mailforge-test-target 사용 시 인증 없이 즉시 테스트 가능
• AI 모델의 컨텍스트 이해력을 높이기 위해 리포지토리 스캔 기능 필수 구현
• 에러 피드백 시스템을 통해 개발자 생산성 향상에 기여