자사 서버 상에서 자율형 AI 에이전트를 업무 시스템이나 ERP와 연동하려 할 때, 가장 먼저 직면하는 문제는 '모델 정확도'가 아니라 '분산 실행의 안전성'입니다. 특히 네트워크 순간 단절(network transient)이나 타임아웃 후 재시도에 의한 이중 발주/이중 재고 할당은 한 번 발생하면 현장의 신뢰를 순식간에 잃게 만듭니다.
본 기사에서는 온프레미스 Linux + PostgreSQL 구성으로 작동하는 태스크 실행 제어 플레인(ZeroOS)의 설계 지견을 바탕으로, 무거운 외부 큐를 늘리지 않으면서 업무 일관성(business consistency)을 지키는 세 가지 구현 패턴을 정리합니다.
에이전트가 호출하는 모든 외부 도구를 일률적으로 재시도 가능하다고 간주하는 것이 사고의 시작입니다. 실행 전에 모든 도구를 다음 3가지 구분으로 강제 분류하고, 데이터베이스 장부(ledger)로 관리해야 합니다.
- Read-Only (읽기 전용): 재고 조회, 거래처 검색 등. 부작용이 없으므로 안전하게 재시도가 가능합니다. -
Idempotent Write (멱등 쓰기): 외부 키를 통해 중복 제거를 수용하는 API입니다. task_id + step_seq + payload_hash로부터 결정론적인 idempotency_key를 발행하고, 전송 전에 장부에 커밋(commit)한 후 실행합니다. -
Non-Idempotent Write (비멱등 쓰기): 중복 제거 기능이 없는 레거시 ERP나 파일 연동입니다. 자동 재시도를 금지하며, 결과가 불분명할 때는 즉시 RECONCILE_REQUIRED 상태로 전환하여 대조(reconciliation) 작업 또는 담당자 확인으로 회부합니다.
실행 중인 워커가 Out-of-Memory (OOM)나 전원 차단 등으로 다운된 경우, 대기 워커에게 안전하게 처리를 인계해야 합니다. PostgreSQL의 단일 트랜잭션(single transaction)을 사용하여 상태와 리스 만료 기한, 그리고 단조 증가하는 세대 번호(fencing_token)를 관리합니다.
UPDATE workflow_steps
SET state = 'RUNNING',
worker_id = $1,
...
나중에 지연 복귀한 구(舊) 워커가 결과를 쓰려고 해도, WHERE fencing_token = $old_token 조건에 일치하지 않기 때문에 DB 측에서 확실하게 차단됩니다. 사내 스테이징 환경에서의 단일 관측 기록 결과, 워커 강제 중지부터 안전 인계까지 소요 시간은 약 6.99초(6,994 ms)였습니다 (호스트 성능 및 리스 설정에 의존하는 사내 검증 값이며, 외부 보장 값은 아닙니다).
금액 임계값(threshold)을 초과하는 발주나 마스터 데이터 업데이트는 OPA 호환 정책(OPA-compatible policy)으로 사전 평가하고, 인간의 승인이 완료될 때까지 강제 일시 정지합니다. 여기서 중요한 것은 Fail-Closed 원칙입니다. 정책 엔진이 타임아웃되거나 정의되지 않은 상태를 반환할 경우, 처리를 진행하는 것이 아니라 반드시 차단/보류해야 합니다.
또한, ERP 연결용 API 키나 비밀번호를 평문 환경 변수(environment variable)에 남겨두면 로그 유출의 온상이 됩니다. 실행자 프로세스에게 파일 디스크립터(file descriptor)로 기밀 정보를 전달하고, 열람 직후 임시 파일 실체를 삭제하는 FD-Unlink 방식을 결합함으로써, 디스크 잔류 및 의도치 않은 덤프 노출을 줄일 수 있습니다.
온프레미스 업무 AI를 PoC(Proof of Concept) 단계에 머무르지 않고 상용화시키는 열쇠는 모델 선정보다 'PostgreSQL 트랜잭션 경계에서의 멱등 제어'와 'Fail-Closed 승인 게이트'에 있습니다. ZeroOS에서는 이를 고객사 자체 환경을 위한 제어 플레인으로 표준화하여, 감사 가능한 에이전트 운영을 실현하고 있습니다.