Cloudflare Agents는 2026년 기준으로 “상태를 기억하는 AI 에이전트"를 만들고 싶은 팀이 많이 검색하는 주제입니다. 이제 AI 앱은 한 번 답하고 끝나는 챗봇보다, 상태를 저장하고 도구를 호출하고 스케줄에 따라 다시 움직이는 에이전트 구조로 넘어가고 있기 때문입니다.
Cloudflare 공식 문서는 Agents를 TypeScript class 중심 모델로 설명합니다. 각 에이전트 인스턴스는 Durable Object 위에서 동작하고, 자체 상태와 SQL 저장소, WebSocket 연결, 스케줄링 기능을 함께 가집니다. 즉 Cloudflare Agents란 무엇인가, Durable Objects 기반 AI 에이전트, Cloudflare에서 상태 저장 에이전트 만들기 같은 검색어로 들어오는 독자에게 바로 맞는 주제입니다.
이런 분께 추천합니다 #
- Cloudflare Workers 위에 AI 에이전트를 올리고 싶은 개발자
- 세션 복원과 상태 저장이 필요한 AI 챗/업무 자동화를 설계하는 팀
Cloudflare Agents,Durable Objects,Workers AI관계를 한 번에 이해하고 싶은 분
Cloudflare Agents의 핵심은 무엇인가 #
핵심은 “에이전트를 상태를 가진 마이크로 서버처럼 다룬다"는 점입니다.
| 요소 | 역할 |
|---|---|
| Agent class | 에이전트 로직을 담는 서버 측 클래스 |
| Durable Object | 각 에이전트 인스턴스의 상태와 실행 컨텍스트 |
| SQL storage | 에이전트별 영속 데이터 저장 |
| WebSocket/RPC | 클라이언트와 실시간 연결 |
| Scheduling | 나중에 다시 실행되는 작업 예약 |
| Tools/MCP | 외부 도구 호출과 도구 노출 |
이 구조는 기존 서버리스 챗봇이 자주 겪던 문제를 줄입니다.
- 대화 상태를 외부 DB에 따로 재조립해야 하는 문제
- 실시간 연결과 백엔드 상태가 분리되는 문제
- 툴 호출, 승인 흐름, 예약 작업이 따로 놀던 문제
왜 지금 Cloudflare Agents가 주목받는가 #
최근 AI 에이전트 플랫폼 경쟁은 “모델 호출"보다 “상태, 도구, 장기 실행” 쪽으로 이동했습니다. Cloudflare Agents는 이 세 가지를 한 플랫폼에 묶습니다.
- 각 에이전트가 상태를 기억함
- 실시간 UI 동기화를 기본 전제로 둠
- Workers AI, OpenAI, Anthropic, Gemini 등 여러 모델을 연결 가능
- 브라우저 도구, 서버 도구, 승인 흐름, 스케줄링을 함께 설계 가능
즉 AI agent framework, stateful agent platform, Cloudflare Agents tutorial 같은 검색 의도와 잘 맞습니다.
Cloudflare Agents는 어떤 팀에 잘 맞는가 #
아래 조건에 해당하면 적합도가 높습니다.
- 이미 Cloudflare Workers를 사용 중이다
- 사용자별 세션 상태를 오래 유지해야 한다
- 채팅형 UI와 서버 측 작업 흐름을 함께 운영한다
- 에이전트가 스스로 나중에 다시 실행되어야 한다
- 멀티테넌트 구조에서 수많은 작은 상태 인스턴스를 운영해야 한다
Durable Objects와 어떤 관계인가 #
각 Agent 인스턴스는 사실상 Durable Object 하나에 매핑됩니다. 그래서 사용자 ID, 티켓 ID, 워크플로우 ID처럼 고유 식별자를 기준으로 인스턴스를 분리하는 설계가 자연스럽습니다.
이 점이 중요한 이유는 다음과 같습니다.
- 에이전트별 상태를 자연스럽게 분리할 수 있음
- 인스턴스 간 독립성이 높아짐
- 수평 확장이 쉬워짐
- 실시간 연결과 상태 저장을 한 단위로 묶을 수 있음
실무에서 어떻게 도입하면 좋은가 #
가장 현실적인 접근은 아래 순서입니다.
- 한 가지 업무 시나리오만 먼저 잡습니다.
- 에이전트 식별자 기준을 정합니다.
- 상태 모델과 이벤트 모델을 분리합니다.
- 도구 호출에 승인 여부를 넣습니다.
- 장기 실행 작업은 스케줄링으로 분리합니다.
특히 “모든 걸 한 에이전트에 몰아넣는 설계"는 피하는 편이 좋습니다.
장점과 주의점 #
장점:
- 상태 저장 구조가 기본값이라 에이전트다운 설계를 하기가 쉽습니다.
- Durable Objects, SQL, WebSocket, 스케줄링을 한 플랫폼에서 다룹니다.
- 글로벌 엣지 배포와 잘 맞습니다.
- MCP와 도구 노출 시나리오까지 이어가기 좋습니다.
주의점:
- 에이전트 식별자 설계를 대충 하면 상태 모델이 빠르게 꼬입니다.
- 긴 워크플로우를 모두 한 인스턴스에 몰아넣으면 디버깅이 어려워집니다.
- “모델 프레임워크"가 아니라 “상태 실행 플랫폼"이라는 관점으로 접근해야 합니다.
검색형 키워드 관점에서 왜 좋은 주제인가 #
이 글은 아래 검색어 흐름에 대응합니다.
Cloudflare Agents란Cloudflare Agents 사용법Cloudflare Durable Objects AI agentstateful AI agent frameworkCloudflare Agents tutorial
한 줄 결론 #
Cloudflare Agents는 2026년 기준으로 “상태를 저장하고, 도구를 호출하고, 나중에 다시 움직이는 AI 에이전트"를 만들기 위한 강한 선택지입니다. 특히 Cloudflare 생태계 안에서 실시간성, 상태성, 글로벌 배포를 함께 가져가고 싶다면 검색 가치와 실무 가치가 모두 높은 주제입니다.
참고 자료 #
- Cloudflare Agents docs: https://developers.cloudflare.com/agents/
- Getting started: https://developers.cloudflare.com/agents/getting-started/
- Quick start: https://developers.cloudflare.com/agents/getting-started/quick-start/
- Agents API overview: https://developers.cloudflare.com/agents/api-reference/agents-api/