使用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，使其更易於開發者在更多語言、工作流和部署模式中構建編程代理。