SuperAPI AI 工具集

agents-sdk

智能体与模型

查看项目

更新于 10-15 21:37

技能介绍

用途:在 Cloudflare Workers 上用 agents npm 包构建持久、有状态的 AI 智能体。需先运行 npm install agents,并在 wrangler.jsonc 中为每个 Agent 类配置 durable_objects 绑定(name 与 class_name 须与类名一致)与 migrations(new_sqlite_classes)。

主要能力:Agent 基类提供状态、调度、RPC、MCP 和邮件能力;AIChatAgent(@cloudflare/ai-chat)增加流式聊天、消息自动持久化和可恢复流;McpAgent(agents/mcp)用于构建 MCP 服务器;Code Mode 生成可执行代码而非逐个工具调用,可显著降低 token 消耗。状态通过 this.state / this.setState() 自动持久化到 SQLite 并广播给客户端;this.schedule() 支持按日期、延迟秒数或 cron 表达式调度,cancelSchedule(id) 取消;this.queue() 用于顺序处理;this.sql 模板可查询 SQL;@callable 装饰器通过 WebSocket RPC 暴露方法,支持 streaming 选项。

使用方式:自定义状态与 RPC 用 Agent;聊天用 AIChatAgent,并安装 @cloudflare/ai-chat、ai、@ai-sdk/openai,在 onChatMessage 中调用 streamText 并返回 toUIMessageStreamResponse();客户端可用 agents/react 的 useAgent 与 @cloudflare/ai-chat/react 的 useAgentChat。入口用 routeAgentRequest 路由请求。

适用场景:需要持久状态、定时任务、WebSocket RPC、MCP 编排或邮箱处理的智能体。Code Mode 适合串联多次工具调用、跨工具条件逻辑、多 MCP 服务器编排和 token 受限场景。

限制:资料未提供定价、平台配额或具体性能数据,也未给出完整部署步骤;使用前需核对 wrangler.jsonc 绑定与迁移配置。