agents-sdk

Extend AIChatAgent from the agents package, configure a Durable Object binding and SQLite migration in wrangler.jsonc, and route requests with routeAgentRequest. Install agents, @cloudflare/ai-chat, ai, and @ai-sdk/react, then use useAgentChat on the client for streaming messages and tools.

Decorate agent methods with @callable() to expose them as RPC methods over WebSocket. Clients invoke them with agent.call("methodName", [args]), and streaming variants use @callable({ streaming: true }) with a StreamingResponse parameter.

Each agent class needs a Durable Object binding, a new_sqlite_classes migration entry, and the nodejs_compat compatibility flag. Never edit old migrations; add a new tag for new classes, and do not enable experimentalDecorators in tsconfig since it breaks @callable.

Think handles the streamText loop, tool execution, and persistence automatically via getModel() and getSystemPrompt() overrides, but requires the experimental compatibility flag. AIChatAgent gives full control inside onChatMessage and runs on standard flags.

This error means the class_name in your wrangler Durable Object binding does not match your exported agent class. Also verify URLs use the kebab-case class name, such as /agents/my-agent/default for a class named MyAgent.

Yes. Use this.schedule() for one-time or cron tasks, scheduleEvery() for intervals, queue() for sequential FIFO work with retries, and runWorkflow() for durable multi-step execution. runFiber() with stash checkpoints survives Durable Object eviction.