agents-sdk

Extend AIChatAgent from the agents package, implement onChatMessage with streamText, and route requests with routeAgentRequest. Install agents, @cloudflare/ai-chat, ai, and @ai-sdk/react, then connect clients with the useAgentChat React hook.

Add a durable_objects binding for each agent class, a migrations entry with new_sqlite_classes, and the nodejs_compat compatibility flag. Never edit old migrations; add new tags for new classes, and regenerate types with npx wrangler types.

The @callable decorator breaks when experimentalDecorators is enabled in tsconfig. Extend the agents/tsconfig instead, and verify each agent class has its own Durable Object binding and migration entry.

Yes, the Agents SDK includes an MCP client API for connecting to remote servers and createMcpHandler for building your own MCP servers. It supports Streamable HTTP, SSE, and RPC transports, with OAuth guidance for securing servers.

Think is an experimental higher-level class that handles the streamText loop, tool execution, and persistence automatically via getModel and getSystemPrompt overrides. AIChatAgent gives full control inside onChatMessage but requires wiring the streaming loop yourself.