用途：在 Cloudflare Workers 上构建 AI 智能体，适用于有状态智能体、持久工作流、实时 WebSocket 应用与定时任务等场景。官方提醒相关知识可能过时，实现前应从 https://github.com/cloudflare/agents/tree/main/docs 获取最新文档，优先检索而非依赖预训练知识。
主要能力：SQLite 持久状态并自动同步到客户端；通过 @callable() 方法经 WebSocket 调用 RPC；支持一次性、周期性（scheduleEvery）和 cron 调度；通过 AgentWorkflow 执行持久多步后台处理；可作为 MCP 客户端连接 MCP 服务器，或用 McpAgent 自建 MCP 服务器；收发邮件与安全回复路由；AIChatAgent 提供可恢复的流式聊天；提供 useAgent、useAgentChat 等 React hooks。
使用方式：确认安装可运行 npm ls agents，未安装则 npm install agents。Wrangler 需配置 durable_objects 绑定与 migrations（new_sqlite_classes）。智能体继承 Agent 类，可设置 initialState，并用 validateStateChange 在持久化前校验、onStateUpdate 在持久化后通知。路由形如 /agents/{agent-name}/{instance-name}，例如 /agents/counter/user-123。常用 API 包括 this.state、this.setState、this.sql、this.schedule、this.scheduleEvery、@callable()、@callable({ streaming: true })、this.runWorkflow。客户端可用 useAgent({ agent, name }) 订阅状态更新。文档分主题提供：getting-started、state、routing、callable-methods、scheduling、workflows、http-websockets、email、mcp-client、mcp-servers、client-sdk、human-in-the-loop、resumable-streaming，另有 references 覆盖 workflows、callable、state-scheduling、streaming-chat、mcp、email 及实验性 Code Mode。
适用场景：需要持久状态、实时通信、定时任务、人机协作审批、断线恢复流式输出或 MCP 集成的 Workers 应用。
限制：Code Mode 标记为实验性；资料未提供具体收费、价格与性能数据。