本文目錄
Cursor 已將 Agent SDK 標為一般可用。重點是把 agent 寫成可版本控管的程式專案:本地跑 eval,再部署到 Cursor 或自有基礎設施。
發布了什麼
changelog 寫明 Agent SDK「is available today」/「generally available today」。一個 agent 就是一個專案:instructions.md 是提示詞;tools/ 裡每個檔案是模型可呼叫的一個類型化動作;skills/ 是按需載入的流程;mcp-connections/ 接入 MCP 工具;channels/ 定義收發訊息的管道。agent-sdk validate 檢查專案,agent-sdk info 印出發現結果。
在專案目錄執行 agent-sdk deploy:Cursor 稱會建置 agent、分配 URL,並在其基礎設施上啟動;也可部署到自有基礎設施。密鑰與整合可在控制台管理,本地同樣可用日誌、eval 與 playground。
安裝,以及套件名不一致
文件與 npm 的安裝方式是全域安裝 @grok/agent-sdk,再初始化並本地啟動:
npm install --global @grok/agent-sdk
agent-sdk init ./my-bot
cd my-bot
agent-sdk dev截至北京時間 2026 年 10 月 27 日,npm 上 @grok/agent-sdk 最新為 0.3.0,曾用名 @cursor/bdk 同為 0.3.0。changelog 起手寫的是 npx @cursor/agent-sdk init ./my-bot——該套件名在 npm 上 404。命令範例以文件/npm 的 @grok/agent-sdk 為準。
init 可加 --template,從 security reviewer、owners-policy approver、PR autofixer,或 Linear/Jira triager 起步。
頻道、Eval 與 Replay
Agent 可在 GitHub/GitLab/Bitbucket 的 PR、評論與 CI 事件,Slack 提及與私訊,任意來源的 webhook,以及 cron 排程上喚醒。Cursor 稱 GitHub 事件可經 Cursor 帳號拉取,該路徑無需公開 webhook URL。每段對話保留獨立工作階段;PR 或 Slack 執行緒上的後續會回到同一工作階段。
agent-sdk eval 傳送固定訊息,並斷言呼叫了哪些工具、輸入是什麼、回覆形態如何——可在本地或 CI 跑。agent-sdk github replay 把真實 PR 轉成簽章 webhook 負載,方便在不等待 push 的情況下測 GitHub 驅動的 bot;可加 --dry-run --fixtures-dir 把負載存成 eval 夾具。
本站尚未端對端實測 deploy/eval/replay,僅供參考。Cursor 文件另有一張產品對照表,把 Agent SDK 與 Cursor Automations、Grok Bot 並列(版本化 Markdown/TypeScript 專案 vs 控制台提示詞/觸發器 vs 應用內設定)——那是 Cursor 自己的分檔,不是本站排名。
相關文章見 Cursor 各檔用量上限怎麼算:The X Subscription 與舊計劃(2026年10月)、Claude Code 和 Cursor 在價格和用量上到底差在哪(2026 年 10 月)、目前最強的程式設計代理有哪些?Artificial Analysis 榜單排名(2026 年 10 月)。
