Cloudflare Agents

Cloudflare Agents

Last Updated: 2025-11-21

Quick Start

export default {
  async fetch(request, env, ctx) {
    const agent = {
      tools: [
        { name: 'getTodo', handler: async ({id}) => ({id, title: 'Task'}) }
      ],
      async run(input) {
        return await processWithLLM(input, this.tools);
      }
    };
    
    return Response.json(await agent.run(await request.text()));
  }
};

Core Features

• Tool Integration: Register and execute tools
• LLM Providers: OpenAI, Anthropic, Google Gemini
• MCP Protocol: Model Context Protocol support
• Cloudflare Bindings: D1, KV, R2, Durable Objects

Agent Pattern

const agent = {
  tools: [...],
  systemPrompt: 'You are a helpful assistant',
  model: 'gpt-4o',
  async run(input) {
    // Process with LLM
  }
};

Resources

Core Documentation

• references/​patterns-concepts.md (317 lines) - What is Cloudflare Agents, patterns & concepts, critical rules, known issues prevention
• references/​configuration-guide.md (152 lines) - Complete configuration deep dive
• references/​agent-api.md (115 lines) - Complete Agent Class API reference

Integration Guides

• references/​http-sse-guide.md (74 lines) - HTTP & Server-Sent Events
• references/​websockets-guide.md (110 lines) - WebSocket integration
• references/​state-management.md (388 lines) - State management, scheduled tasks, workflows
• references/​mcp-integration.md (130 lines) - Model Context Protocol integration

Advanced Features

• references/​advanced-features.md (637 lines) - Browser automation, RAG, AI model integration, calling agents, client APIs

Error Reference

• references/​error-catalog.md (10 lines) - Common errors and solutions

Templates

• templates/​basic-agent.ts - Basic agent setup
• templates/​browser-agent.ts - Browser automation
• templates/​calling-agents-worker.ts - Calling other agents
• templates/​chat-agent-streaming.ts - Streaming chat agent
• templates/​hitl-agent.ts - Human-in-the-loop
• templates/​mcp-server-basic.ts - MCP server integration
• templates/​rag-agent.ts - RAG implementation
• templates/​react-useagent-client.tsx - React client integration
• templates/​scheduled-agent.ts - Scheduled tasks
• templates/​state-sync-agent.ts - State synchronization
• templates/​websocket-agent.ts - WebSocket agent
• templates/​workflow-agent.ts - Workflows integration
• templates/​wrangler-agents-config.jsonc - Wrangler configuration

Official Docs: https://developers.cloudflare.com/cloudflare-for-platforms/cloudflare-agents/