cloudflare/agents

Build and deploy AI Agents on Cloudflare

What it solves

Cloudflare Agents는 에이전트형 워크로드(agentic workloads)를 위한 지속적이고 상태를 유지하는 실행 환경을 구축하고 배포하는 프레임워크를 제공합니다. 유휴 상태일 때 휴면 상태가 되고 필요할 때 깨어나는 수백만 개의 개별 에이전트(예: 사용자 또는 세션당 하나)의 생명주기, 상태 및 통신을 관리하는 문제를 해결합니다. 이를 통해 비용과 운영 오버헤드를 줄일 수 있습니다.

How it works

Cloudflare Durable Objects 상에서 구축된 각 에이전트는 자체 저장소와 생명주기를 가진 상태 유지 엔티티입니다. 이 프레임워크는 @callable() 데코레이터를 통해 타입 안전한 RPC 시스템을 제공하여, 클라이언트가 에이전트를 로컬 함수처럼 호출할 수 있게 합니다. WebSocket을 통해 상태 변경 사항을 실시간으로 클라이언트에게 동기화하며, AI 모델, MCP (Model Context Protocol), 그리고 지속적인 다단계 워크플로우를 지원합니다.

Who it’s for

AI 에이전트, 실시간 협업 애플리케이션, 또는 에지에서 지속적인 상태와 AI 통합이 필요한 상태 유지 서비스를 구축하는 개발자.

Who it’s for

AI 에이전트, 실시간 협업 애플리케이션, 또는 에지에서 지속적인 상태와 AI 통합이 需要的를 구축하는 개발자.

Highlights

  • Persistent State: 상태는 재시작 후에도 유지되며 모든 연결된 클라이언트에게 자동으로 동기화됩니다.
  • AI Capabilities: AI 채팅, 음성 파이프라인 (STT/TTS), 그리고 LLM이 실행 가능한 TypeScript 코드를 생성하는 "Code Mode"를 위한 전문화된 패키지를 포함합니다.
  • Sandboxed Execution: 가상 파일 시스템을 갖춘 격리된 Worker에서 LLM이 생성한 코드를 실행할 수 있는 기능.
  • MCP Support: 에이전트 기능을 확장하기 위해 MCP 서버 또는 클립라이언트로 동작할 수 있습니다.
  • Infrastructure Integration: 스케줄링, 이메일, 그리고 x402 pay-per-call 결제를 내장 지원합니다.
  • Frontend Integration: 전용 React hooks (useAgent, useAgentChat)를 사용하여 원활한 프론트엔드 연결을성을 제공합니다.