跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

更新日志

Cloudflare 的最新更新与改进。

返回所有文章

Agents SDK:Agent Skills 现为 Agent Workspace 中的文件

Cloudflare Agents SDK 中的 Agent Skills 现在以文件形式存在。将包含 SKILL.md 的文件夹写入 Agent 的 Computer ↗ Workspace 中的 /workspace/.agents/skills/ 下,Agent 即可在下一轮使用它。您无需构建步骤或部署,Agent 也可以编写自己的 Skills。

src/server.jsjs
import { Think, skills } from "@cloudflare/think";

export class MyAgent extends Think {
	getSkills() {
		return [
			skills.workspace(this.workspace), // /workspace/.agents/skills
			skills.r2(this.env.SKILLS_BUCKET, { prefix: "skills/" }),
		];
	}
}
src/server.tsts
import { Think, skills } from "@cloudflare/think";

export class MyAgent extends Think<Env> {
	getSkills() {
		return [
			skills.workspace(this.workspace), // /workspace/.agents/skills
			skills.r2(this.env.SKILLS_BUCKET, { prefix: "skills/" }),
		];
	}
}

此版本包括:

  • 三种来源。 从 Computer Workspace、R2 存储桶或代码加载 Skills。Think 会在每一轮之前重新列出所有来源。
  • 开放格式。 每个 SKILL.md 都会根据 Agent Skills 规范 ↗进行检查。按照该规范面向 Agent 的指南建议,违反规则的 Skill 仍会加载,但会记录一条警告。在写入 Skill 之前,请使用 parseSkill() 对其进行检查。
  • Workspace 中的脚本。 Skill 脚本是 Workspace 文件,模型使用 Workspace 的 exec 工具运行它们。请参阅执行。
  • 适用于任意 harness 的 Skill 工具。 在 Think、Pi Durable 或 AI SDK 中使用相同的 activate_skill 和 read_skill_resource 工具。请参阅 Skills 工具。
  • 保持提示缓存有效。 当 Skill 在对话过程中发生变化时,Think 会将新的目录作为提醒发送,而不是重建已缓存的系统提示。被覆盖的 getSystemPrompt() 现在会保留在系统提示的顶部,位于上下文块之上。

对于直接使用 agents/skills 的代码,这是一项破坏性变更。agents:skills Vite 导入、agents/skills/compile、SkillRegistry 以及 Think 的 skillWorkspace 均已移除,runner() 已移至 agents/skills/runner。请安装 Agents SDK v0.32.0 ↗ 和 Think v0.23.0 ↗ 或更高版本。请参阅 computer-skills ↗ 和 r2-skills ↗ 示例。