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 目前已正式可用。