Cursor 正式发布 Agent SDK,这是其内部用于构建 Bugbot、Security Reviewer 和 Rollouts 等托管代理的同一套框架。该 SDK 的核心思路是让代理像普通软件项目一样被定义、管理和部署,而不是要求团队采用围绕他人工作流设计的产品,或从零开始搭建。
Agent SDK 面向的是贯穿开发周期的重复性工作。这些代理会连接到团队日常使用的系统,并在相关事件发生时采取行动,例如审查拉取请求、执行合规流程或调查线上事故。Cursor 强调,最有用的代理应当贴合特定团队的运作方式,因此 SDK 允许团队根据自身流程定义代理行为,并让代理遵循可检查、可修改的策略。
代码审查是一个典型场景。每个团队对于哪些变更需要关注、由谁审查都有自己的标准。借助 Agent SDK,团队可以构建响应 GitHub、GitLab 或 Bitbucket 拉取请求事件的代理。代理能够评估变更风险、将其路由给合适的团队,并批准符合策略的变更。Cursor 内部一个团队曾积累了大量快速增长的经验教训知识库,希望每个拉取请求都对照该知识库检查。他们用 Agent SDK 在大约一天内构建了 kb-reviewer,如今它运行在主代码库的每个 PR 上,标记与已记录经验相矛盾的变更,引用每条发现背后的笔记,并鼓励工程师协调所报告的差异。
对于更复杂的任务,代理可以将工作交给另一个拥有独立工具和会话的专用代理,也可以将任务拆分给并行工作的子代理。Agent SDK 还开箱即用地支持评估和事件回放,使团队能够快速开发,同时确保关键工作流按预期执行。PGA Tour 使用 Agent SDK 驱动其软件开发工厂,并通过评估保持快速迭代。PGA America 首席工程师 Michael Gyarmathy 表示,Agent SDK 让 PGA 能够在 Cursor 基础设施上构建软件工厂的每个组件,提供了构建驱动开发流程的代理所需的灵活性,内置的评估支持则帮助团队快速迭代新想法并可靠地优化现有能力。
在组织方式上,一个 Agent SDK 代理就像一个小型软件项目。指导代理的指令文件与工具代码、外部服务连接以及用于测试的评估文件放在一起。每个文件代表代理知道或能够执行的某件事:提示词以 Markdown 编写,工具则定义为 TypeScript 函数。由于一切都是代码,变更可以经过与其余软件相同的版本控制和审查流程。
部署时,团队只需在项目目录中运行 agent-sdk deploy。该命令会构建代理、为其分配 URL,并在 Cursor 基础设施上启动。团队可以从仪表板管理密钥和集成,同时继续使用本地可用的相同日志、评估和游乐场。代理也可以运行在自有基础设施上,每个代理作为单个 Node 进程运行,并可打包进容器。
上手 Agent SDK 与启动任何其他软件项目类似:创建项目目录,然后启动本地游乐场。示例代码展示了如何使用 @cursor/agent-sdk 中的 defineAgent 定义名为 Robo 的代理,指定模型、参数和本地工作目录。之后,开发者可以在本地迭代、运行评估,再通过 agent-sdk deploy 部署。SDK 还附带技能,引导编码代理完成开发过程;开发者可以将代理指向文档,让代理协助一起构建机器人。Agent SDK 目前已正式可用。