Agent SDK:Cursor 推出的代码定义智能体框架
软件团队利用代码定义的 Agent 来处理开发全生命周期中的重复性工作。这些 Agent 连接至团队的工作环境,并在相关事件发生时自动响应,无论是审查 Pull Request、执行合规流程,还是调查事故。
真正实用的 Agent 往往需要针对特定团队的工作方式进行定制。在此之前,构建这类 Agent 通常意味着要么采用围绕他人工作流设计的现成产品,要么从零开始开发。
今天,我们正式发布 Agent SDK——这是 Cursor 内部用于构建 Bugbot、Security Reviewer 和 Rollouts 等托管 Agent 的框架。Agent SDK 允许你在代码中定义 Agent,并像管理其他软件项目一样管理它们。你可以从模板起步,或者让编程 Agent 参考我们的文档进行开发。当 Agent 准备好后,只需运行 agent-sdk deploy,即可一键将其部署到 Cursor 基础设施。
#围绕你的工作流构建
Agent SDK 让你能够快速构建并部署符合团队习惯的 Agent。它们响应团队已经在处理的事件,并遵循团队可检查和修改的政策。
代码审查是一个典型案例。每个团队对于什么需要关注、由谁审查都有各自的标准。借助 Agent SDK,你可以构建响应 GitHub、GitLab 或 Bitbucket 中 Pull Request 事件的 Agent。该 Agent 可以评估变更风险,将其路由到正确的团队,并对符合政策的变更予以批准。
举例来说,Cursor 内部有一个团队建立了一个庞大且快速增长的经验教训知识库,并希望针对每一个 Pull Request 进行检查,以确保即使在代码库变化时,团队过去的决策依然有效。使用 Agent SDK,他们在大约一天内构建了 kb-reviewer。现在,它在主代码库的每个 PR 上运行,标记与已记录教训相矛盾的变化,引用每条发现背后的笔记,并鼓励工程师解决报告中提到的差异。
对于更复杂的工作,Agent 可以将任务移交给拥有独立工具和会话的其他专用 Agent。它们还可以将工作分配给并行工作的子 Agent。
Agent SDK 原生支持 evals(评估)和事件回放,让开发者在确保关键工作流按预期执行的同时快速迭代开发。PGA 巡回赛(PGA Tour)基于 Agent SDK 构建其软件开发工厂,凭借 evals 机制保持高效交付节奏。
Agent SDK 让我们能够将软件工厂的每个组件构建在 Cursor 的基础设施之上。它提供了构建驱动开发流程智能体所需的灵活性。内置的 evals 支持则让我们能够可靠地快速验证新想法并优化现有能力。
Michael Gyarmathy,PGA America 首席工程师
#用代码定义一切
Agent SDK 的智能体结构类似一个小型软件项目。引导智能体行为的指令与其工具代码、外部服务连接配置以及用于测试的 evals 文件并列存放。
每个文件代表智能体的一项知识或一项能力。提示词使用 Markdown 编写,工具则以 TypeScript 函数定义。由于一切皆为代码,任何变更都可以像其他软件模块一样纳入版本控制和代码审查流程。
#随时随地部署智能体
准备上线时,在项目中执行 agent-sdk deploy 即可将智能体部署到 Cursor。该命令会自动构建智能体、生成访问 URL 并在我们的基础设施上启动服务。你可以通过仪表盘管理密钥和集成配置,同时沿用本地可用的日志、evals 和 playground 功能。
也可以将智能体部署在自己的基础设施上。每个智能体运行在单个 Node 进程中,可轻松打包为容器。
#开始使用
使用 Agent SDK 的起步流程与其他软件项目类似:创建项目目录后,启动本地 playground:
import { homedir } from "node:os";
import { join } from "node:path";
import { defineAgent } from "@cursor/agent-sdk";
export default defineAgent({
name: "Robo",
model: {
id: "composer-2.5",
params: [
{ id: "effort", value: "high" },
{ id: "fast", value: "true" },
],
},
local: {
cwd: join(homedir(), ".cache", "factory", "robo"),
},
})
之后你就可以在本地迭代、跑评估,最后用 agent-sdk deploy 部署。
Agent SDK 还内置了 skills(技能),可以引导编码代理完成整个开发流程。你只需让代理阅读文档,它就能协助你一起构建 bot。
Agent SDK 现已正式发布。欢迎阅读文档,开始上手。