Repolode
提交项目
cloudflare

cloudflare/agents

基于 Cloudflare Durable Objects 构建持久化、有状态 AI Agent 的 TypeScript SDK。

在 GitHub 查看官网
Star
5,854
Fork
787
未关闭 Issue
171
最近提交
10小时前

这是什么？

Cloudflare Agents 是一个用于在 Cloudflare Durable Objects 上运行持久化、有状态 AI Agent 的 SDK。每个 Agent 拥有独立的状态和存储，空闲时自动休眠、按需唤醒，因此可以为每个用户、会话或游戏房间各创建一个 Agent。

核心包 `agents` 提供基础 Agent 类，状态会实时同步到已连接的客户端，并可通过 `@callable()` 装饰器暴露方法供前端直接调用。它还内置定时任务、WebSocket、SQL 查询和 AI 模型调用等能力。前端可使用 `useAgent`、`useAgentChat` 等 React Hook，也支持不依赖框架的原生 JS 客户端。

仓库采用 pnpm monorepo 结构，另包含 AI 对话、让 LLM 生成可执行 TypeScript 的 Code Mode、运行时 Workers 打包工具和 Hono 中间件等子包，并附有 30 多个示例应用。

核心功能

  • 01持久化的 Agent 状态，实时同步到所有已连接客户端
  • 02通过 @callable() 装饰器提供类型安全的方法调用
  • 03支持一次性、周期性和 cron 定时任务
  • 04支持作为 MCP 服务端或客户端
  • 05支持带人工审批的持久化多步骤工作流
  • 06提供 React Hook 和原生 JS 客户端用于前端集成

适用场景

  • 构建带持久记忆和对话历史的单用户 AI 助手
  • 为每个房间创建一个 Agent，实现实时多人游戏
  • 通过部署在 Cloudflare Workers 上的 MCP 服务向 LLM 提供工具
  • 运行调用 AI 模型的定时后台任务

快速上手

  1. 1

    从入门模板创建新项目

    npm create cloudflare@latest -- --template cloudflare/agents-starter
  2. 2

    或将 SDK 添加到现有项目

    npm install agents
  3. 3

    在本地运行示例（以仓库中的 playground 为例）

    cd examples/playground npm start

使用前须知

  • 基于 Cloudflare Durable Objects 构建，设计上运行于 Cloudflare 平台。
  • 目前不接受外部拉取请求。

标签

#ai-agents#cloudflare-workers#durable-objects#typescript#mcp#llm#websockets#serverless#agents#ai

常见问题

agents 是什么？
基于 Cloudflare Durable Objects 构建持久化、有状态 AI Agent 的 TypeScript SDK。 Cloudflare Agents 是一个用于在 Cloudflare Durable Objects 上运行持久化、有状态 AI Agent 的 SDK。每个 Agent 拥有独立的状态和存储，空闲时自动休眠、按需唤醒，因此可以为每个用户、会话或游戏房间各创建一个 Agent。
agents 可以免费使用吗？用的什么许可证？
agents 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。
agents 还在维护吗？
活跃维护中。agents 最近一次提交是在 2026年10月20日。
agents 适合用来做什么？
构建带持久记忆和对话历史的单用户 AI 助手 为每个房间创建一个 Agent，实现实时多人游戏 通过部署在 Cloudflare Workers 上的 MCP 服务向 LLM 提供工具 运行调用 AI 模型的定时后台任务
agents 怎么安装和运行？
从入门模板创建新项目: npm create cloudflare@latest -- --template cloudflare/agents-starter 或将 SDK 添加到现有项目: npm install agents 在本地运行示例（以仓库中的 playground 为例）: cd examples/playground npm start
在哪里获取 agents？
源代码和安装说明在 GitHub 上：https://github.com/cloudflare/agents

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目