Cloudflare Agents SDK · 连接状态、RPC与可恢复任务

@public/agents-sdk

查看空间 →

使用Cloudflare的agents包构建或审查有状态Agent应用,组织持久状态、客户端同步、可调用方法、调度、队列和工作流。按任务检索聊天、流恢复、MCP及其他集成参考,结合实际版本验证连接与执行生命周期。采用 Apache-2.0 许可证。

能力与使用条件

适用场景

  • 实现带持久状态和客户端连接的Agent
  • 审查RPC、调度与重试行为
  • 为应用接入MCP或流式聊天能力

输入要求

  • agents与相关聊天、模型SDK版本
  • 实例路由、状态结构及身份权限规则
  • 客户端协议、后台任务和外部工具契约

输出结果

  • 实例、状态及调用边界设计建议
  • 版本匹配的SDK与集成实现路径
  • 断线、恢复、重试及权限验证清单

前置条件

  • 具备兼容的Workers与Durable Objects项目环境
  • 明确外部模型、工具和客户端权限,执行验证遵循项目容器及授权约定

不适用场景与限制

  • Cloudflare Agents SDK与其他厂商同名SDK不同,具体聊天包、迁移与实验性能力需按实际版本核对
  • setState同步的数据可能到达连接客户端,输入校验不代替身份授权;秘密不应因方便而放入广播状态
  • 持久恢复和重试不自动保证外部工具副作用恰好一次;队列、工作流与普通后台Promise的保障不同
  • 上游示例的路由异步返回、钩子名称和类型需实际验证,不能照抄;MCP处理器可用不等于已完成OAuth和资源权限校验
  • 下载链接为固定提交的完整仓库快照,使用其中 skills/agents-sdk 目录。配图是说明性示例。

说明性示例

  • 审查这个Cloudflare agents应用的实例路由、状态同步和可调用方法,指出权限和敏感状态边界;为断线恢复、任务重试和外部工具副作用给出幂等及验证方案。

资料依据

  • https://github.com/cloudflare/skills/blob/cbf893b954222276bf1af57e5f23379231e0efb9/skills/agents-sdk/SKILL.md
  • https://github.com/cloudflare/skills/blob/cbf893b954222276bf1af57e5f23379231e0efb9/LICENSE

外部资源

内容由外部网站提供,平台不保证第三方文件的完整性、可用性或安全性。

外部文件的访问权限由第三方管理,本站无法限制其地址的访问。