软件团队使用以代码定义的智能体来处理开发生命周期中反复出现的工作。这些智能体连接到团队工作所在的各个地方,并在相关事件发生时采取行动,无论是审查拉取请求、执行合规工作流,还是调查事件。
最有用的智能体是根据特定团队的运作方式量身定制的。到目前为止,构建这样一个智能体通常意味着采用一个围绕他人工作流设计的产品,或者从零开始。
今天,我们发布 Agent SDK,这是我们用来构建自家托管智能体(如 Bugbot、Security Reviewer 和 Rollouts)的框架。Agent SDK 允许你以代码定义智能体,并像管理任何其他软件项目一样管理它们。从模板开始,或让你的编码智能体查阅我们的文档。当智能体准备就绪时,agent-sdk deploy只需一条命令即可将其部署到 Cursor 基础设施。
围绕你的工作流构建
Agent SDK 让你能够快速构建和部署按照你团队方式工作的智能体。它们响应你团队已经在处理的事件,并遵循你团队可以检查和更改的策略。
代码审查就是一个例子。每个团队对于什么需要关注以及谁应该审查都有自己的标准。借助 Agent SDK,你可以构建一个响应来自 GitHub、GitLab 或 Bitbucket 的拉取请求事件的智能体。该智能体可以评估变更的风险,将其路由到合适的团队,并批准符合你策略的变更。
举个例子,Cursor 内部的一个团队建立了一个大型且快速增长的、记录经验教训的知识库,并希望每个拉取请求都对照它进行检查。这样,即使代码库发生变化,团队过去的决策也能继续成立。借助 Agent SDK,他们在大约一天内构建了 kb-reviewer。它现在运行在他们主代码库的每个 PR 上,标记与已记录经验教训相矛盾的变更,引用每条发现背后的笔记,并鼓励工程师协调它所报告的差异。
对于更复杂的工作,智能体可以将任务交给另一个拥有自己工具和会话的专用智能体。它们还可以将一项工作分配给并行工作的子智能体。
Agent SDK 还开箱即用地支持评估和事件回放,让快速开发的同时确保关键工作流按预期执行。PGA Tour 使用 Agent SDK 驱动其软件开发工厂。评估让他们保持快速推进。
Agent SDK 使 PGA 能够在 Cursor 的基础设施上构建我们软件工厂的每一个组件。它提供了我们构建驱动开发流程的智能体所需的灵活性。而内置的评估支持让我们能够快速迭代新想法,并可靠地优化现有能力。
Michael Gyarmathy
首席工程师
,
PGA America
用代码定义一切
Agent SDK 智能体的组织方式就像一个小型软件项目。指导它的指令与工具代码、外部服务连接以及用于测试它的评估并列存放。
每个文件代表智能体知道或能做的事情。提示词用 Markdown 编写,而工具则定义为 TypeScript 函数。因为一切都是代码,变更可以像你其余软件一样经过相同的版本控制和审查流程。
在任何需要的地方部署智能体
当你准备好投入使用智能体时,可以在项目目录中运行以下命令将其部署到 Cursoragent-sdk deploy。该命令会构建智能体、为其分配一个 URL,并在我们的基础设施上启动它。你可以从仪表盘管理密钥和集成,同时继续使用本地可用的相同日志、评估和演练场。
你也可以在自己的基础设施上运行智能体。每个智能体作为单个 Node 进程运行,可以打包进容器。
开始使用
开始使用 Agent SDK 看起来和启动任何其他软件项目差不多。创建一个项目目录,然后启动本地演练场:
import{ homedir }from"node:os";
import{ join }from"node:path";
import{ defineAgent }from"@cursor/agent-sdk";
exportdefaultdefineAgent({
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 还附带了一些技能,可在开发过程中为编码智能体提供指导。你可以让智能体查阅文档,让它帮你一起构建这个机器人。
Agent SDK 现已正式可用。阅读文档并开始使用。