我們推出 Cursor SDK，讓您能使用驅動 Cursor 的相同執行環境、harness 和模型來打造代理。

在 Cursor 桌面應用程式、CLI 和 Web 應用程式中執行的代理，現在只需幾行 TypeScript 即可存取。您可以在自己的電腦上執行，也可以在 Cursor 的雲端專用 VM 上搭配任何尖端模型執行。

若要開始使用，請執行 npm install @cursor/sdk。您也可以使用 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);
}

我們建立了幾個範例專案，你可以從公開的 儲存庫 取得。請 fork 並延伸它們，以符合你自己的使用情境。

Cursor SDK 現已以公開測試版形式提供給所有使用者，並依標準的 token 用量計費。請在我們的 公告與 文件中了解更多。

此版本推出全新的多工處理方式，包含非同步子代理、改進後的工作樹體驗，以及用於跨儲存庫變更的多根工作區。

#在 Agent 視窗中多工處理

使用 /multitask 時，Cursor 會執行非同步子代理來平行處理您的請求，而不是將它們加入佇列。它也會將較大的任務拆解成較小的部分，交由一批非同步子代理同時著手處理。

如果佇列中已有訊息，您可以請 Cursor 為您對這些訊息進行多工處理，而不必等到目前這次執行完成。

#Agent 視窗中的工作樹

我們已在 Agent 視窗 中加入全新且經過改進的 工作樹。

你可以在不同分支間，於背景執行隔離的任務。準備好測試變更時，只要按一下，就能將任何分支切換到本機前景。

#Agent 視窗中的多根工作區

單一代理工作階段現在可將目標設為由多個資料夾組成、可重複使用的工作區。

這讓 Cursor 能夠跨前端、後端與共用函式庫進行跨儲存庫變更，而不必在代理於不同儲存庫間切換時，每次都重新設定目標。

Cursor 現在可以透過建立互動畫布來回應。

這些視覺化內容可包含儀表板與自訂介面，使用表格、方塊、圖解和圖表等第一方元件建構，也可納入像是差異檢視和待辦清單等現有的 Cursor 元件。

在 Agent 視窗 中，畫布是可持久存在的產物，位於側邊面板，與終端機、瀏覽器和版本控制並列。

立即在 Cursor 3.1 的 Agent 視窗或編輯器中試用。請在我們的 公告 中閱讀更多內容。

我們為 Cursor CLI 帶來了多項體驗提升，讓你在終端機中使用代理時更順手、更愉快。

#CLI 的偵錯模式

使用 /debug 找出根本原因，並修正那些難以重現或理解的棘手錯誤。在 偵錯模式 中，Cursor 會提出假設、加入日誌記錄，並利用執行階段資訊，在進行針對性的修正前精準定位問題。

#CLI 中的 /btw 支援

在不干擾代理主要任務的情況下，快速順帶問個問題。/btw 可讓你在不中止目前執行的情況下，釐清 Cursor 正在進行的變更內容。

#CLI 中的組態選單

/config 會在 CLI 內開啟互動式設定面板，您可在此檢視及調整各項行為設定，例如模型選擇、預設值、執行階段偏好等。

您也可以使用 /update-cli-config 技能，請 Cursor 為您套用組態變更。

#CLI 中的自訂狀態列

使用 /statusline 自訂狀態列，以呈現你關心的工作階段與執行階段訊號，包括目前模式、分支、環境、使用中的任務提示，或其他工作階段中繼資料。