Agent SDK正式發布

軟體團隊藉助以程式碼定義的智慧體，處理貫穿整個開發生命週期的重複性工作。這些智慧體接入團隊日常工作的各個平臺，在相關事件發生時自動採取行動，無論是審查 PR、執行合規性工作流，還是排查事件。

最實用的智慧體，往往是根據特定團隊的運作方式量身打造的。而在此之前，要構建這樣的智慧體，通常只能二選一：要麼採用圍繞別人的工作流設計的產品，要麼從零開始。

今天，我們正式釋出 Agent SDK——我們用來構建 Bugbot、安全審查智慧體和 Rollouts 等自有託管智慧體的框架。藉助 Agent SDK，你可以用程式碼定義智慧體，並像管理其他軟體專案一樣管理它們。你可以從模板起步，也可以讓你的程式設計智慧體直接參考我們的文件。智慧體就緒後，只需一條 agent-sdk deploy 命令，即可將其部署到 Cursor 基礎設施上。

圍繞你的工作流構建

藉助 Agent SDK，你可以快速構建和部署貼合團隊工作方式的智慧體。它們會響應團隊日常處理的事件，並遵循團隊可以檢查和更改的策略。

程式碼審查就是一個示例。每個團隊對哪些內容需要關注、應由誰來審查都有各自的標準。藉助 Agent SDK，你可以構建一個智慧體，響應來自 GitHub、GitLab 或 Bitbucket 的 PR 事件。該智慧體可以評估更改的風險，將其分派給合適的團隊，並批准符合你策略的更改。

舉例來說，Cursor 內部的一個團隊積累了一個龐大且快速增長的經驗知識庫，希望每個 PR 都能對照該知識庫進行檢查。這樣，即使程式碼庫不斷演進，團隊過去做出的決策也能得到貫徹。藉助 Agent SDK，他們只用了大約一天就構建出了 kb-reviewer。現在，它會在其主程式碼庫的每個 PR 上執行，標記與已記錄經驗相矛盾的更改，為每個發現的問題註明所依據的筆記，並促使工程師解決它所報告的不一致之處。

對於更復雜的工作，智慧體可以將任務移交給另一個擁有自己工具和會話的專用智慧體，也可以將一項工作拆分給多個並行執行的子智慧體。

Agent SDK 還開箱即支援評估和事件回放，讓你既能快速開發，又能確保關鍵工作流按預期執行。PGA Tour 使用 Agent SDK 驅動其軟體開發工廠，而評估讓他們始終保持快速迭代。

Agent SDK 讓 PGA 能夠在 Cursor 的基礎設施上構建我們軟體工廠的每一個元件。它為我們構建驅動開發流程的智慧體提供了所需的靈活性。內建的評估支援則讓我們能夠快速迭代新想法，並可靠地最佳化現有功能。

Michael Gyarmathy

首席工程師

,

PGA America

用程式碼定義一切

Agent SDK 智慧體的組織方式就像一個小型軟體專案：用於引導它的指令，與其工具程式碼、外部服務連線以及用於測試它的評估放在一起。

每個檔案都代表智慧體掌握的一項知識或具備的一項能力。提示詞用 Markdown 編寫，工具則定義為 TypeScript 函式。由於一切都是程式碼，所有更改都可以和你的其他軟體一樣，走同樣的版本控制和審查流程。

按需將智慧體部署到任何地方

當你準備好讓智慧體投入使用時，只需在專案目錄中執行 agent-sdk deploy，即可將其部署到 Cursor。該命令會構建智慧體、為其分配 URL，並在我們的基礎設施上啟動它。你可以在控制台中管理金鑰和整合，同時繼續使用與本地環境中相同的日誌、評估和 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 還內建了一系列技能，可引導程式設計智慧體完成整個開發流程。你可以讓智慧體參考文件，協助你一起構建機器人。

Agent SDK 現已正式釋出。閱讀文件，立即開始使用。