· 更新日誌
使用 Cursor SDK 打造可程式化代理
我們推出 Cursor SDK,讓您能使用驅動 Cursor 的相同執行環境、harness 和模型來打造代理。
在 Cursor 桌面應用程式、CLI 和 Web 應用程式中執行的代理,現在只需幾行 TypeScript 即可存取。您可以在自己的電腦上執行,也可以在 Cursor 的雲端專用 VM 上搭配任何尖端模型執行。
若要開始使用,請執行 npm install @cursor/sdk,並使用 Cursor SDK 外掛,讓 Cursor 協助您打造。
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 用量計費。請在我們的 公告與 文件中了解更多。
- 我們已將 API 重新設計為以持久型代理和每次提示詞執行為核心,因此後續內容、狀態、串流和取消現在都以執行為範圍。
- 加入了原生的執行串流支援,採用 SSE 事件、可透過
Last-Event-ID重新連接,並提供更清楚的終止狀態。 - 加入了明確的代理生命週期控制,包括封存、取消封存和永久刪除。
- 標準化了 v1 的回應和錯誤格式,包括結構化錯誤代碼、
items清單回應,以及分開的agent/run物件。