Cloudflare把智能体技能变成工作区文件:写进目录,下一轮就能用,无需构建或部署
核心概要
Cloudflare 的 Agents SDK 把 Agent Skills 从需要构建和部署的代码资产改为智能体工作区里的文件:在 /workspace/.agents/skills/ 下写入含 SKILL.md 的文件夹,智能体下一轮即可使用,且能自己写技能。技能可从工作区、R2 存储桶或代码三处加载,Think 每轮前重新列出全部来源;每个 SKILL.md 按 Agent Skills 规范校验,违规仍加载但记录警告。这是一次破坏性变更,旧的 agents/skills 直接调用、Vite 导入、SkillRegistry 与 Think 的 skillWorkspace 被移除。
深度剖析
Cloudflare 的 Agents SDK 现在把智能体技能当作智能体工作区里的普通文件,而不是需要单独构建和部署的代码资产。 此前技能走的是 agents/skills 的 Vite 导入与编译路径,需要构建步骤和部署才能生效。 发布说明给出的对照是:把含 SKILL.md 的文件夹写进 /workspace/.agents/skills/,智能体在下一轮就能使用,不需要构建步骤或部署。
技能来源不再只有一处,智能体可以从工作区、R2 存储桶或代码加载技能,并在每轮思考前重新列出全部来源。 旧路径把技能绑定在编译产物上,来源与更新方式单一。 发布说明把三个来源列为本次发布的首项内容,并说明 Think 在每一轮之前都会重新列出每个来源。
技能脚本本身也是工作区文件,由模型通过工作区的 exec 工具执行。 脚本不再需要作为独立编译单元随技能打包。 发布说明写明技能脚本是工作区文件,模型用工作区 exec 工具运行它们,并指向 Execution 一节。
技能变更时,Think 把新的技能目录作为提醒发送,而不是重建已缓存的系统提示。 此前技能变化会触发系统提示缓存的重建。 发布说明说明 Think 在对话中途技能变化时发送新目录作为提醒,并说明被覆盖的 getSystemPrompt() 现在保持在系统提示顶部、位于上下文块之上。
启示与展望
这里描述的是 Cloudflare Agents SDK 与 Think 的接口变更及其加载、校验和缓存行为,面向使用该 SDK 构建智能体的开发者;发布说明未给出性能或任务效果的测量。
发布说明说明违反规范的技能仍会加载,只记录一条警告,因此校验并不阻止不合规技能生效;此外这是一次破坏性变更,旧接口被移除,需要按说明升级版本。
