Agents SDK

Build, deploy, and maintain stateful AI agents on Cloudflare Workers and Durable Objects using the Cloudflare Agents SDK (agents package).

Your knowledge of the Agents SDK and Cloudflare runtime APIs may be outdated. Prefer retrieval over pre-training for any Agents SDK task.

When to Use

• creating stateful AI agents on Cloudflare Workers + Durable Objects
• exposing type-safe agent RPC interfaces using the @callable() decorator
• persisting agent state and conversation history in embedded SQLite (this.sql)
• orchestrating durable multi-step execution with AgentWorkflow
• running resilient background tasks via fibers (this.runFiber())
• building interactive chat agents with streaming using AIChatAgent
• scheduling recurring or delayed agent actions (schedule(), scheduleEvery())
• handling incoming agent webhooks and push notifications

Core Rules