SuperAPI AI 工具集

agents-sdk

智能体与模型

查看项目

更新于 10-16 02:33

技能介绍

用途:在 Cloudflare Workers 上构建持久化、有状态的 AI 智能体,使用 agents npm 包。安装:npm install agents。需在 wrangler.jsonc 中配置 durable_objects 绑定与 migrations(new_sqlite_classes 列出所有 Agent 类)。

智能体类型:Agent(自定义状态与 RPC,无聊天)、AIChatAgent(带消息持久化的聊天,来自 @cloudflare/ai-chat)、McpAgent(构建 MCP 服务器,来自 agents/mcp)。

主要能力:this.state / this.setState() 自动持久化到 SQLite 并广播给客户端;this.schedule() 支持 Date、延迟秒数或 cron 表达式调度,cancelSchedule 取消;this.queue() 顺序处理任务;this.sql 执行 SQL 查询;@callable 装饰器通过 WebSocket RPC 暴露方法,支持 streaming 选项;Code Mode 生成可执行代码替代工具调用以减少 token。

使用方式:定义继承 Agent 的类并设置 initialState,用 routeAgentRequest 处理请求;聊天场景继承 AIChatAgent 并实现 onChatMessage,配合 streamText 与 toUIMessageStreamResponse;客户端可用 agents/react 的 useAgent 与 @cloudflare/ai-chat/react 的 useAgentChat。

适用场景:需要持久状态、定时任务、RPC、MCP 编排或邮件处理的智能体;复杂多工具链式调用或 token 受限时可用 Code Mode。

限制:需配置 Durable Objects 绑定与迁移;聊天需额外安装 @cloudflare/ai-chat、ai、@ai-sdk/openai 等依赖;具体定价、平台限制与完整 API 细节资料暂未提供。