Cursor 发布 SDK，可用 TypeScript 构建智能体

我们推出 Cursor SDK，让你可以使用驱动 Cursor 的同一运行时、harness 和模型来构建 agent。

现在只需几行 TypeScript 代码，即可访问在 Cursor 桌面应用、CLI 和 Web 应用中运行的 agent。你可以在自己的机器上运行，也可以在 Cursor 云端的专用 VM 上运行，并使用任意前沿模型。

运行 `npm install @cursor/sdk` 即可开始。你也可以使用 Cursor 原生的 `/sdk` 技能来帮助你开始构建。

```jsx 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 现已在公开测试版中面向所有用户开放，并按标准的基于 token 的用量定价计费。请在我们的公告和文档中了解更多。

Cloud Agents API 更新

• 围绕持久化 agent 和按 prompt 运行的机制重构了 API，因此后续跟进、状态、流式传输和取消现在都以 run 为作用域。
• 新增了一流的 run 流式传输，支持 SSE 事件、通过 `Last-Event-ID` 重连，以及更清晰的终态。
• 新增了显式的 agent 生命周期控制，包括归档、取消归档和永久删除。
• 统一了 v1 响应和错误结构，包括结构化错误码、`items` 列表响应，以及独立的 `agent` / `run` 对象。