질문: durable 에이전트란? 볼트에 이 용어만 다루는 페이지가 없어, 흩어진 노트를 모아 정리한 답이다.
개요
Durable 에이전트는 프로세스가 죽거나 서버가 재시작되거나 사람 승인을 기다리느라 며칠 멈춰도, 하던 일을 그 지점에서 이어서 하는 에이전트다. 평범한 에이전트는 세션이 끝나면 기억이 사라진다. Anthropic은 이를 “인수인계 없이 출근한 교대 근무 엔지니어”에 비유한다. Durable 에이전트는 상태를 실행 환경 밖에 영속적으로 저장하고, 필요할 때 거기서 상태를 다시 만든다.
핵심 원칙: 세션(상태)은 오래 살고, 실행 환경(샌드박스)은 쓰고 버린다. 그래서 컨테이너가 죽어도 세션은 죽지 않는다.
구현 패턴
- 이벤트 로그 기반 세션: Anthropic Managed Agents는 생각·도구 호출·관찰을 append-only 로그에 기록하고,
wake(sessionId)로 로그에서 상태를 재구성한다. 이 로그가 없으면 컨테이너 장애가 곧 세션 장애다. → 2026-04-09-claude-managed-agents - Checkpoint-and-resume: 일정 작업 단위마다 체크포인트를 남긴다. LangGraph의 durable checkpointer는 서버 재시작 뒤에도 워크플로 메모리와 진행 상태를 복구한다. → 2026-07-27-x-beamnxw-graph-engineering-langgraph
- 액터 모델: Cloudflare Agents SDK·Project Think는 에이전트마다 Durable Object를 하나씩 준다. 고유 ID와 SQLite 상태를 갖고, 메시지가 오면 깨어나며, 휴면 중 컴퓨팅 비용은 0이다. → 2026-04-16-cloudflare-project-think, 2026-08-09-github-cloudflare-agents
- 사람 승인 대기(HITL): 추론 체인과 작업 메모리를 유지한 채 멈췄다가, 사람이 검토하면 곧바로 재개한다.
사례
| 사례 | 특징 |
|---|---|
| OpenAI Agents API | Session = 여러 턴에 걸쳐 일하는 durable 에이전트 인스턴스, 나중에 재개·조정 가능 → openai-agents-api |
| Shopify River | Slack 상주 코딩 에이전트. 세션은 영속, 샌드박스는 일회용인 “공개형 durable agent” → shopify-river |
| Cloudflare Agents SDK | Durable Objects 위에서 상태·스케줄링·WebSocket 제공 → 2026-08-09-github-cloudflare-agents |
왜 중요한가
장기 실행 에이전트의 생산성은 단일 세션 능력보다 복구 가능성, 상태 지속성, 자기 검증에서 결정된다. Google·Anthropic·Cursor 모두 “모델 루프 / 실행 샌드박스 / 세션 로그” 분리 구조로 수렴하고 있다.
관련 페이지
- 2026-05-05-long-running-agents — 장기 실행 에이전트의 세 가지 벽과 다섯 가지 프로덕션 패턴
- harness — 하네스 설계 아키텍처 패턴
- moc-ai-agents-harness — 하네스 MOC