使用Cursor SDK構建程式設計代理

Cursor 釋出了 Cursor SDK，這是一個新的工具集，允許開發者以程式設計方式構建和使用與 Cursor 桌面應用、CLI 和 Web 應用相同的代理執行時。透過這個 SDK，開發者可以用幾行 TypeScript 程式碼建立代理，並在本地機器、Cursor 的雲基礎設施或自託管的 worker 上執行。

SDK 的核心是 Agent 類，開發者可以建立一個 Agent 例項，指定 API 金鑰、模型和執行環境（本地或雲）。然後透過 send 方法傳送提示，並流式接收響應。例如，一個簡單的程式碼示例如下：

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");

for await (const event of run.stream()) {
  console.log(event);
}

對於生產環境，SDK 提供了雲會話功能。每個雲代理在專用的虛擬機器上執行，具有強沙箱隔離、倉庫克隆和完整的開發環境配置。代理可以在筆記型電腦休眠或網路斷開時繼續執行，任務完成後可以自動建立 PR、推送分支或附加演示和截圖。以下是一個雲代理的示例：

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "gpt-5.5" },
  cloud: {
    repos: [{ url: "https://github.com/cursor/cookbook", startingRef: "main" }],
    autoCreatePR: true,
  },
});

const run = await agent.send("Fix the auth token expiry bug");
console.log(`Started ${run.id}`);

// 稍後從任何地方檢查結果
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

SDK 基於更新的 Cloud Agents API，雲代理執行會顯示在 Cursor 的代理視窗和 Web 應用中，開發者可以啟動任務後在 Cursor 中檢查進度或接管工作。

Cursor SDK 提供了與 Cursor 全平臺相同的完整代理工具鏈：

• 智慧上下文管理：包括程式碼庫索引、語義搜尋和即時 grep，幫助代理更快、更高效地達到預期結果。
• MCP 伺服器：允許代理透過 stdio 或 HTTP 連線外部工具和資料來源，配置方式可以是 .cursor/mcp.json 檔案或內聯傳遞。
• 技能（Skills）：代理自動從倉庫的 .cursor/skills/ 目錄中獲取技能。
• 鉤子（Hooks）：透過 .cursor/hooks.json 檔案在雲、自託管和本地環境中觀察、控制和擴充套件代理迴圈。
• 子代理（Subagents）：將子任務委託給具有獨立提示和模型的命名子代理，由主代理透過 Agent 工具生成。

SDK 支援所有 Cursor 中可用的模型，包括專用的編碼模型 Composer 2，該模型以較低的成本實現了前沿效能。開發者可以透過更改一個欄位來為任務選擇最佳的模型，平衡成本和能力。

目前，團隊已經在使用 Cursor SDK 構建各種自定義代理。例如，從 CI/CD 管道中直接啟動程式設計代理，總結變更、識別 CI 失敗的根因並更新 PR 修復。其他團隊正在構建內部應用程式，讓非技術團隊無需編寫程式碼即可查詢產品資料。一些客戶甚至將 Cursor 直接嵌入面向終端使用者的產品中。

Cursor 提供了幾個示例專案，包括快速入門、原型工具、看板應用和 CLI 工具，開發者可以在公共 GitHub 倉庫中找到這些專案並擴充套件使用。

Cursor SDK 目前處於公開測試階段，所有使用者均可使用。計費基於標準的令牌消耗定價。安裝方法：執行 npm install @cursor/sdk，然後使用 Cursor 的原生 /sdk 技能獲取構建指導。Cursor 計劃繼續投資於 SDK，使其更易於開發者在更多語言、工作流和部署模式中構建程式設計代理。