9.0
重磅
AI SCORE
工具产品2026-04-29 08:00
Cursor SDK 发布,开发者可自构建 AI Agent
Cursor Changelog#Cursor#Agent#SDK
Editor brief · 编辑速览
Cursor 开放 SDK,让开发者使用相同的运行时和模型库自助构建 Agent,大幅降低门槛。
文章思维导图
Knowledge map
Full translation
完整中文译文
Cursor SDK 简介
我们推出了 Cursor SDK,让你可以用支撑 Cursor 的同一套运行时、框架和模型来构建 agent。
运行在 Cursor 桌面应用、CLI 和网页应用中的 agent 现在可以通过几行 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.5" },
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 现已对所有用户开放公测,按照标准的基于令牌消费的定价方式计费。了解更多信息请查看我们的公告和文档。
Cloud Agents API 更新
围绕持久 agent 和按-prompt 运行重新设计了 API,因此后续操作、状态、流式处理和取消现在都是 run 作用域的。
添加了一级 run 流式处理(带 SSE 事件)、通过 Last-Event-ID 的重新连接支持,以及更清晰的终端状态。
添加了显式的 agent 生命周期控制,包括存档、解除存档和永久删除。
标准化了 v1 响应和错误形状,包括结构化错误代码、项目列表响应以及独立的 agent / run 对象。