AI 도입·운영
멈춘 AI 작업은 다시 잇고, 업데이트는 되돌리기 전에 살펴야 합니다
발행일:
Cloudflare Agents SDK가 Pi 1.4의 작업 복구를 지원합니다. 베타 기능의 적용 범위와, 저장소 변환 뒤 이전 버전으로 돌아갈 수 없는 제약을 함께 짚습니다.
밤새 맡긴 AI 작업이 중간에 멈추면, 다시 시작해도 되는지부터 고민하게 됩니다. Cloudflare의 이번 업데이트는 이런 작업을 이어가는 방식을 개선합니다. 다만 실행 데이터가 새 형식으로 바뀌면 이전 버전으로 돌아갈 수 없으므로, 복구 기능과 업데이트 계획을 함께 봐야 합니다.
Cloudflare가 2026년 10월 22일 Agents SDK v0.30.0의 Pi 1.4 지원을 알렸습니다. 모델 호출을 다시 시도하기까지 기다리는 동안에는 작업을 실행하는 Durable Object가 메모리에 계속 머물지 않고 잠들 수 있고, 반복 충돌이나 저장 오류에서 작업을 복구하는 방식이 개선됐습니다. Cloudflare 발표
PiHarness는 Cloudflare의 실행 환경과 Pi의 작업 순서를 연결하는 구성요소입니다. 저장된 작업 상태를 바탕으로 재시작을 돕기 때문에, 개발자는 어디까지 처리했는지와 무엇을 다시 실행할지 함께 설계해야 합니다. 현재 문서상 PiHarness는 베타이고 Pi Durable은 실험적 패키지입니다. 모든 Cloudflare 애플리케이션에 자동 적용되는 변경은 아닙니다. 지원 범위
계속 충돌하는 작업은 보류합니다
새 버전은 멈춘 모델 스트림을 일시적 오류로 처리해 다시 시도하고, 저장 오류 뒤에는 Pi를 다시 열어 복구를 시도합니다. 계속 충돌하는 작업은 무한 재시작 대신 parked 상태로 보류합니다. 운영자가 원인을 처리한 뒤 재시도할 수 있습니다. 변경 사항
여기서 보류는 완료가 아닙니다. 현재 문서에 따르면 해당 작업을 기다리는 wait()도 계속 대기할 수 있습니다. 실패를 알아채고 담당자가 처리하는 경로까지 준비해야 합니다. 복구 문서
업데이트 전에는 저장소 호환성을 확인하세요
Upstream Pi Durable 1.4.0의 변경 기록은 10월 21일자입니다. SQLite 저장소를 열면 스키마 버전 2로 자동 변환하며, 변환된 데이터는 1.3.0 이하에서 열 수 없습니다. 문제가 생겼을 때 코드만 이전 버전으로 되돌리는 방법을 복구 계획으로 삼으면 안 됩니다. Upstream 변경 기록

Cloudflare 문서, 2026년 10월 23일 실제 캡처. 경고 문단만 잘랐으며 문구는 변경하지 않았습니다. 원문 · 문서 라이선스 CC BY 4.0 · 이용조건. 해당 캡처에 대한 라이선스이며 썸네일은 별도 AI 제작 개념 이미지입니다.
저는 이번 업데이트에서 재시도 기능보다 먼저, 기존 데이터로 복구 절차를 검증하는 일이 중요하다고 봅니다. 시험 환경에서 버전 조합과 저장소 복원 절차를 확인하고, 보류된 작업을 찾아 원인 수정 후 재시도하는 과정까지 점검하는 편이 좋겠습니다.
예를 들어 작은 쇼핑몰이 밤새 고객 문의를 요약하는 작업을 운영한다고 가정해 보겠습니다. 작업이 멈춘 뒤 다시 이어지는 것은 도움이 될 수 있지만, 그 결과를 고객에게 보내는 단계까지 두 번 실행해도 안전하다는 뜻은 아닙니다. 이 사례는 실제 도입 경험이 아닌 가정입니다.
공식 문서는 재실행해도 안전하다고 표시한 도구를 다시 실행할 수 있다고 설명하며, 도구 호출의 승인·권한 단계는 아직 제공하지 않는다고 명시합니다. 따라서 외부 발송이나 결제 같은 동작의 중복 방지와 승인 절차는 별도로 설계해야 합니다. 복구·제약 사항
위 점검 순서는 편집 제안입니다. 복구 성공률, 처리 시간, 비용 절감 효과를 직접 측정한 결과는 아닙니다.
장시간 작업에서 실행 환경이 왜 중요한지는 AgentCore Runtime을 다룬 이전 글에서도 설명했습니다. 이번 변경은 그 일반적인 문제 가운데, 특정 패키지의 재시작과 저장소 호환성에 해당합니다.
저는 이번 업데이트를 재시도 기능만의 문제가 아니라 운영 절차의 변화로 봅니다. 다시 실행해도 되는 작업과 사람이 판단해야 하는 작업을 나누고, 저장소 복구까지 시험하는 편이 좋겠습니다.
- #Cloudflare
- #Pi 1.4
- #Agents SDK
- #AI 자동화
CONTINUE READING
이 기록에서 이어서 보기
VECTORLOG LETTER
다음 기록도 받아보고 싶다면 구독을 연결해 주세요.