Cursor 正式发布了配套的软件开发工具包（SDK）。这套工具包直接复用了 Cursor 核心产品中那套 runtime、harness 和模型体系，让开发者能基于相同的底层逻辑构建智能体应用。
现在，只需编写少量的 TypeScript 代码，就能调起那些在 Cursor 桌面端、命令行工具和网页版中实际运行的智能体。执行环境既可以是本地开发机，也可以接入 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);
}
官方团队准备了若干示例项目，存放在公开仓库中。开发者可以直接 fork 这些项目，并根据自身业务场景做二次开发。
目前，Cursor SDK 已全面开启公测（Public Beta），计费方式沿用标准的 token 消耗规则。具体细节可查阅官方公告及技术文档。
API 接口架构升级
新版 SDK 对 API 结构做了大量重构，主要变化集中在以下几个方面：
- 作用域重新定义围绕持久化智能体与单次提示运行（Run）重组 API，消息传递、状态管理、流式传输及取消操作现在都严格限定在单次运行范围内。
- 流式传输优化提供了一级支持（First-class support）的运行流式接口，涵盖 SSE 事件推送、基于 Last-Event-ID 的重连机制，和更明确的终止状态标识。
- 生命周期管理增加了对智能体生命周期的显式控制能力，包括归档、取消归档和永久删除操作。
- 结构统一标准化了 v1 版本的响应与错误数据结构，引入结构化的错误代码，统一 items 列表响应格式，并将 agent 与 run 对象解耦独立。
