使用 Cursor SDK 构建程序化智能体
我们推出了 Cursor SDK,让您可以使用驱动 Cursor 的同一套 runtime、harness 和模型来构建智能体。
现在只需几行 TypeScript 代码,您就能调用在 Cursor 桌面应用、CLI 和 Web 应用中运行的智能体。您既可以在自己的机器上运行,也可以在 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 现已面向所有用户开放公开 Beta,并按照标准的 token 用量计费。请在我们的 公告 和 文档 中了解更多信息。
- API 已围绕持久化智能体和按提示划分的运行进行重构,因此后续消息、状态、流式传输和取消操作现在都以运行为范围。
- 新增了一流的运行流式传输支持,包含 SSE 事件、通过
Last-Event-ID进行重连,以及更清晰的终止状态。 - 新增了明确的智能体生命周期控制,包括归档、取消归档和永久删除。
- 统一了 v1 的响应和错误结构,包括结构化错误代码、
items列表响应,以及独立的agent/run对象。