building-ai-agent-on-cloudflare

Your knowledge of the Agents SDK may be outdated. Prefer retrieval over pre-training for any agent-building task. Agent runs at An Agent is a stateful, persistent AI service that: Clients connect via: wss://my-agent.workers.dev/agents/MyAgent/session-id For complex queries, use the embedded SQLite database: Agents can schedule future work: For chat-focused agents, extend AIChatAgent : Features included: See references/agent-patterns.md for: See references/troubleshooting.md for common issues. - User wants to build an AI agent or chatbot - User needs stateful, real-time AI interactions - User asks about the Cloudflare Agents SDK - User wants scheduled tasks or background AI work - User needs WebSocket-based AI communication - Cloudflare account with Workers enabled - Node.js 18+ and npm/pnpm/yarn - Wrangler CLI ( npm install -g wrangler ) - Maintains state across requests and reconnections - Communicates via WebSockets or HTTP - Runs on Cloudflare's edge via Durable Objects - Can schedule tasks and call tools - Scales horizontally (each user/session gets own instance) - Automatic message history - Resumable streaming (survives disconnects) - Built-in saveMessages() for persistence - Tool calling and function execution - Multi-agent orchestration - RAG (Retrieval Augmented Generation) - Human-in-the-loop workflows - references/examples.md — Official templates and production...