Workers 智能体
在 Cloudflare Workers 上开发有状态智能体,涵盖持久化状态、定时任务、WebSocket 实时通信和 MCP 服务端。
功能与用途
想做一个能记住上下文、断线重连还能继续、还能按点自己跑任务的智能体,自己从零搭状态同步和持久化会非常费劲。这个能力基于 Cloudflare 的 Agents SDK,把有状态 Agent 类、可被 WebSocket 调用的 RPC、定时与 cron 任务、多步可靠工作流、MCP 接入和 React 客户端 hooks 串成一套写法。前提是要有 Cloudflare 账号和 wrangler 环境,而且它特别强调动手前先取官方最新文档,别照旧记忆写。
适用场景
- 要做一个聊天机器人,用户刷新页面或断网后对话不能丢,还得接着:要做一个聊天机器人,用户刷新页面或断网后对话不能丢,还得接着上次的流继续输出
- 业务需要在智能体里挂定时任务,比如每小时轮询一次接口并在结果:业务需要在智能体里挂定时任务,比如每小时轮询一次接口并在结果异常时通知
- 公司已有 MCP 工具服务,想让 Workers 上的智能体:公司已有 MCP 工具服务,想让 Workers 上的智能体把它接进来并暴露给客户端调用
适用人群
- 用 Cloudflare Workers 做 AI 应用的全栈工程师
- 要开发实时聊天或多人协作智能体的开发者
- 需要给智能体接 MCP 服务端或客户端的后端开发
使用步骤
- 先确认项目里装了 agents 包,没有就用 npm install agents 装上,并配好 wrangler 的 durable_objects 与 migrations
- 说清楚要做的智能体形态——有状态对话、定时任务、MCP 服务端还是流式聊天
- 它会先去 Cloudflare 官方 docs 取当前文档,再按 Agent 基类、路由和状态 API 给出实现
- 拿到代码后补上客户端部分(useAgent / useAgentChat),本地跑通状态同步和 RPC 调用
- 遇到问题时报出真实报错,按官方文档核对版本与 API,不要沿用旧写法
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks. Biases towards retrieval from Cloudflare docs over pre-trained knowledge.
使用前准备
- 需要 Node.js/npm 环境、wrangler 配置与 Cloudflare 账号,并具备 TypeScript 和 React 基础
依赖与权限
- 读取用户主动提供的内容