我們推出了 Cursor SDK，讓你可以使用驅動 Cursor 的同一套執行環境、工具鏈 和模型來打造 Agent。

現在只要幾行 TypeScript，你就能使用在 Cursor 桌面應用程式、CLI 和 Web 應用程式中運行的 Agent。你可以在自己的機器上執行，也可以在 Cursor 雲端的專用 VM 上執行，並搭配任何尖端模型。

程式設計 Agent 正從面向個人開發者的互動式工具，演變為面向組織的可程式化基礎架構。Cursor SDK 讓你不必承擔打造與維護整個 Agent 堆疊的額外負擔，也能部署 Agent。許多團隊正直接從 CI/CD 管線呼叫 Agent，為端對端工作流程建立自動化，並將 Agent 嵌入核心產品中。

Cursor SDK 現已向所有使用者提供公開測試版。只要執行 npm install @cursor/sdk 即可開始。

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);
}

#快速將代理部署到正式環境

要打造快速、可靠且功能強大的程式設計代理，並讓它們能在您的資料上安全執行，需要投入大量工程心力：安全的沙箱隔離、持久化狀態與工作階段管理、環境設定，以及上下文管理。而當新模型推出時，團隊往往還得重新調整代理迴圈，才能充分發揮其效益。

Cursor SDK 免除了這些複雜工作，讓您可以專注在打造實用的代理。

使用可直接投入正式環境的雲端基礎架構

從 SDK 啟動的雲端工作階段，會在與我們用於 雲端 Agent 相同的最佳化執行環境中運作。每個代理都會取得自己專屬的 VM，具備強大的沙箱隔離、儲存庫複本，以及完整設定好的開發環境。

即使您的筆電進入睡眠或網路中斷，Agent 仍會持續執行。您可以即時串流查看對話，稍後再重新連接。代理完成工作後，還可以開啟 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 使用我們更新版的 雲端代理 API，讓雲端代理執行可顯示在 Cursor 的 Agent 視窗和 Web 應用程式中。你可以透過程式啟動任務，然後切換到 Cursor 檢查進度或接手工作。

當你需要不同的執行環境時，同一套 SDK 也能在自行託管的 workers 上執行代理，讓程式碼與工具執行維持在你的網路內，或直接在本機執行，以便快速迭代。

使用完整的 Cursor 工具鏈

透過 SDK 啟動的 Agent，可受益於支援 Cursor 桌面應用程式、CLI 與 Web 應用程式的同一套工具鏈：

• 智慧上下文管理： 程式碼庫索引處理、語意搜尋與即時 grep 可協助代理更快、更有效率地找到正確結果。
• MCP 伺服器： Agent 可透過 stdio 或 HTTP 連接外部工具與資料來源，可使用 .cursor/mcp.json 設定檔，或在呼叫時直接內嵌傳入。
• 技能： Agent 會自動從你儲存庫的 .cursor/skills/ 目錄載入技能。
• Hooks： 透過 .cursor/hooks.json 檔案，在雲端、自行託管與本機環境中觀察、控制並擴充代理迴圈。
• 子代理： 將子任務委派給具名子代理，讓它們使用各自的提示與模型，而主代理會透過 Agent 工具啟動這些子代理。

以任意模型建構

Cursor SDK 讓你可以使用 Cursor 支援的所有模型。只需變更單一欄位，就能依目前任務的需求，將代理導向最適合的模型，在成本與能力之間取得你想要的平衡。

而有了 Composer 2 這款專為程式設計打造的模型，你便能以遠低於通用模型的成本，獲得尖端等級的效能，為大多數程式設計代理任務帶來最佳的智慧與效率組合。

#開發者正在打造的內容

許多團隊正透過 Cursor SDK，更快推出自訂代理。例如，直接由 CI/CD 觸發的可程式化代理，可用來摘要變更、找出 CI 失敗的根本原因，並將修正更新到 PR（拉取請求）中。也有團隊正在打造自訂代理平台，例如讓 GTM 團隊無需撰寫程式碼即可查詢產品資料的內部應用程式。

有些客戶甚至將 Cursor 直接嵌入面向客戶的產品中，讓終端使用者無需離開宿主應用程式，就能獲得代理體驗。

以下是一些基於 Cursor SDK 進行開發的客戶現身分享：

#從範例專案開始

我們已在一個公開 GitHub 儲存庫中提供幾個入門專案，你可以 fork 後再延伸成符合自己使用情境的版本：

• 快速開始： 一個精簡的 Node.js 範例，會建立本機代理、送出一則提示詞，並以串流方式傳回回應。
• 原型製作工具： 一個 Web 應用程式，可用來快速啟動代理，在沙箱隔離的雲端環境中為新專案建立骨架，並反覆驗證想法。
• 看板： 一個由代理驅動的看板工具，工程師可以拖曳卡片，讓代理以程式化方式接手工作、開啟 PR (拉取請求) ，並將結果以附件形式回傳。
• 程式設計代理 CLI： 一個輕量的命令列介面，讓你可以從終端機啟動 Cursor 代理。

#接下來

所有使用者均可使用 Cursor SDK，並依標準的 token 用量定價計費。

我們持續投入 Cursor SDK，重點是讓團隊能更輕鬆地在更多語言、工作流程和部署模式中打造可程式化代理。

如欲進一步了解，請參閱我們的文件。你也可以搭配我們的 Cursor SDK 外掛 使用 Cursor，開始打造。