개요
Cloudflare Agents SDK는 에이전트의 추론 루프 자체보다, 에이전트가 오래 실행되고 상태를 보존하며 전 세계에서 확장될 수 있는 실행 환경을 제공한다. 각 Agent는 Durable Object로 주소화되고 SQLite 상태·수명주기·WebSocket·스케줄링을 갖는다. 2026년 6월 Cloudflare는 이 기반을 다른 하네스와 프레임워크도 사용할 수 있는 공용 런타임으로 확장했다.
핵심 구성
- 상태와 실행: 영속 상태, callable RPC, 수면/재기동, 예약·cron 작업, 내구적 워크플로와 human-in-the-loop 승인.
- 도구 연결: MCP 서버·클라이언트, WebMCP, 이메일, x402 결제, 브라우저 에이전트, 관측 가능성.
- 실행 승격: 가벼운 Worker 실행에서 Code Mode와
@cloudflare/shell기반 가상 파일시스템, 필요 시 2026-08-09-github-cloudflare-sandbox-sdk로 이어지는 계층. - 패키지 표면:
agents,@cloudflare/ai-chat,@cloudflare/think,@cloudflare/codemode,@cloudflare/shell,@cloudflare/voice,@cloudflare/worker-bundler,hono-agents등으로 분리된다.
위치와 경계
Agents SDK는 LangGraph 같은 오케스트레이션 프레임워크라기보다 에이전트가 실제로 살아가는 상태·컴퓨트·저장 계층이다. 따라서 2026-04-16-cloudflare-project-think의 first-party 하네스와도 연결되고, Flue 같은 외부 프레임워크가 Cloudflare 런타임을 대상으로 삼을 수도 있다. Code Mode와 샌드박스가 한 저장소 안에 공존하지만, 컨테이너가 필요한 작업은 별도 2026-08-09-github-cloudflare-sandbox-sdk로 승격하는 구조다.
README의 기능·패키지 목록은 계속 변하는 저장소 설명이며, 이 노트에서 설치·배포·실제 Durable Object 실행은 검증하지 않았다.
출처
- GitHub 저장소 — MIT 라이선스.
- Bringing more agent harnesses and frameworks to Cloudflare — 2026-06-17 공개 런타임 방향.
- moc-cloudflare-open-source · moc-ai-agents-harness