· Changelog

使用 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 对象。