AI 에이전트의 재시도 메커니즘에서 발생하는 중복 실행 문제를 Execution Guard Pattern으로 해결하는 설계

Context

AI 에이전트가 실제 부작용을 일으키는 도구를 호출할 때, 타임아웃·네트워크 단절·시스템 충돌로 인한 재시도 과정에서 응답 손실이 발생하면 동일 작업이 중복 실행된다. 이로 인해 결제 중복, 거래 중복, 이메일 중복 전송, API 변경사항 중복 적용 같은 문제가 발생한다.

Technical Solution

• 재시도 체계와 거부할 수 없는 부작용 사이의 실행 경계 설계: 결정 → 결정적 request_id → 실행 가드 → 선행 영수증 존재 여부 확인 → 존재시 이전 결과 반환, 미존재시 1회 실행 후 영수증 저장
• 결정적 요청 식별: 동일한 결제·이메일·거래·도구 호출이 재시도되어도 동일한 request_id로 매핑되도록 보장
• 내구적 영수증 저장소 구현: Postgres를 사용하여 내구적 쓰기, 트랜잭션 경계, 강력한 유일성 보장, 쿼리 가능한 감사 추적 제공
• 원자적 청구 → 실행 → 완료 경계 설정: 작업을 청구하고, 부작용을 1회 실행하고, 결과/영수증을 지속화하는 명확한 실행 경계로 동시 재시도와 경합 조건 중복 방지
• 재시도 시 선행 결과 반환: 동일한 논리적 작업이 재도입되면 재실행 대신 이전 결과를 반환하여 안전한 재진입 구현

Key Takeaway

이 패턴은 프롬프트 엔지니어링이 아닌 실행 계층의 구조적 설계로 재시도의 안전성을 보장한다. 웹훅 핸들러, 결제 흐름, 비동기 워커, 워크플로우, AI 에이전트 도구 호출 등 부작용을 일으키는 모든 분산 시스템에서 정확히 1회 실행을 명시적으로 구축해야 한다.