agents-sdk 用于在 Cloudflare Workers 上构建有状态 Agent、实时 WebSocket 应用、Durable Workflows、MCP server、聊天和浏览器自动化。SDK 变化较快，开始前应优先查 Cloudflare Agents 文档，而不是凭旧记忆写 API。
基础 Agent 继承 `Agent<Env, State>`，用 `initialState`、`setState` 和 `validateStateChange` 管理状态，通过 `@callable()` 暴露 RPC；路由使用 `routeAgentRequest`。需要定时任务看 schedule，需要耐久多步执行看 Workflows，需要可恢复后台处理看 `runFiber`/`stash`，需要聊天则看 `AIChatAgent` 和 resumable streaming。
配置时补齐 Durable Object binding、SQLite migration 和必要的 compatibility flags；不要修改旧 migration。开发前确认 `npm ls agents`，并按任务读取 state、routing、callable、workflow 或 MCP references。实验性 voice、think 和 browser 能力要明确标注其状态。