軟體團隊會使用以程式碼定義的代理，處理整個開發生命週期中反覆出現的工作。這些代理會連接到團隊日常工作的各個平台，並在相關事件發生時採取行動，無論是審查 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 代理的架構就像一個小型軟體專案：引導它的指示，會與其工具的程式碼、外部服務的連接設定，以及用來測試它的評估放在一起。

每個檔案都代表代理知道的某件事或能做的某件事。提示以 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 即日起正式全面推出。歡迎閱讀文件，立即開始使用。