Metadata

description

Build an AI agent on Cloudflare using the Agents SDK

argument-hint

[agent-description]

allowed-tools

[Read, Glob, Grep, Bash, Write, Edit, WebFetch]

Build AI Agent on Cloudflare

Arguments

The user invoked this command with: $ARGUMENTS

Instructions

When this command is invoked:

1. Read the skill file at agents-sdk/SKILL.md for core SDK guidance, APIs, and wrangler config
2. Based on what the user wants to build, read the relevant references from agents-sdk/references/:
   • For chat/AI agents: streaming-chat.md, client-sdk.md
   • For state management: state-scheduling.md
   • For RPC methods: callable.md
   • For background work: workflows.md, durable-execution.md, queue-retries.md
   • For MCP integration: mcp.md
   • For email handling: email.md
   • For webhooks/push: webhooks-push.md
   • For approval flows: human-in-the-loop.md
   • For voice: voice.md
   • For browser tools: browse-the-web.md
   • For higher-level chat: think.md
3. Fetch the relevant pages from https://developers.cloudflare.com/agents/ for the latest API details
4. Always start with configuration.md and routing.md for project setup

Scaffold Steps

1. Create project: npx create-cloudflare@latest --template cloudflare/agents-starter
2. Configure wrangler.jsonc: DO bindings, migrations, AI binding, assets
3. Implement agent class: extend Agent or AIChatAgent depending on use case
4. Wire routing: routeAgentRequest in the default export
5. Build client: useAgent + useAgentChat React hooks
6. Deploy: npx wrangler deploy

Key Decision: Agent vs AIChatAgent vs Think

Need	Use	Package
Custom stateful logic, RPC, scheduling	Agent	agents
AI chat with streaming, tools, persistence	AIChatAgent	@cloudflare/ai-chat
AI chat with automatic tool loop, built-in workspace	Think	@cloudflare/think (experimental)

Example Usage

/build-agent a customer support chatbot with tool calling
/build-agent a real-time collaborative editor with state sync
/build-agent a background processing agent with scheduled tasks
/build-agent a voice assistant that can browse the web