我们推出了 Cursor SDK，让您能够使用驱动 Cursor 的同一套运行时、运行框架和模型来构建智能体。

现在，只需几行 TypeScript，您就能调用在 Cursor 桌面应用、CLI 和 Web 应用中运行的智能体。您既可以在本地机器上运行，也可以在 Cursor 云端的专用 VM 上运行，并搭配任意前沿模型。

编程智能体正从面向个人开发者的交互式工具，演进为面向组织的程序化基础设施。借助 Cursor SDK，您无需承担构建和维护整套智能体技术栈的成本，就能部署智能体。许多团队正在从 CI/CD 流水线中直接调用智能体，为端到端工作流构建自动化，并将智能体嵌入其核心产品中。

Cursor SDK 现已面向所有用户开放公开 Beta。只需运行 npm install @cursor/sdk 即可开始使用。

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);
}

#快速将智能体部署到生产环境

要构建快速、可靠且能力强大的编程智能体，并让它们能够安全地访问您的数据，往往需要投入大量工程工作：安全沙箱、持久化状态和会话管理、环境设置以及上下文管理。新模型发布后，团队通常还得重做智能体循环，才能充分利用新能力。

Cursor SDK 消除了这些复杂性，让您可以专注于构建实用的智能体。

使用生产就绪的云基础设施

通过 SDK 发起的云端会话，运行在与 云端智能体 相同的优化运行时之上。每个智能体都会获得自己的专用 VM，具备强隔离的沙箱环境、仓库克隆副本，以及配置完整的开发环境。

即使您的笔记本电脑进入睡眠状态或网络中断，智能体也会继续运行。您可以流式查看对话，并在稍后重新连接。智能体完成后，可以创建 PR、推送分支，或附加演示和截图。

// 启动云端智能体以执行任务...:
const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "gpt-5.5" },
  cloud: {
    repos: [{ url: "https://github.com/cursor/cookbook", startingRef: "main" }],
    autoCreatePR: true,
  },
});

const run = await agent.send("Fix the auth token expiry bug");
console.log(`Started ${run.id}`);

// ...稍后随时查看进度：
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

该 SDK 使用我们更新后的 Cloud Agents API，可让云端智能体运行显示在 Cursor 的 Agents Window 和 Web 应用中。您可以通过编程方式启动任务，然后进入 Cursor 查看进度或接手后续工作。

当您需要不同的运行时环境时，同一个 SDK 也可以在 self-hosted workers 上运行智能体，将代码和工具执行保留在您的网络内部；也可以直接在本机运行，以便快速迭代。

使用完整的 Cursor 运行框架

通过 SDK 启动的智能体可受益于支撑 Cursor 桌面应用、CLI 和 Web 应用 的同一套运行框架：

• 智能上下文管理： 代码库索引、语义搜索和即时 grep 可帮助智能体更快、更高效地找到正确结果。
• MCP servers： 智能体可以通过 stdio 或 HTTP 连接外部工具和数据源，既可以通过 .cursor/mcp.json 配置文件，也可以在调用时以内联方式传入。
• Skills： 智能体会自动从您仓库的 .cursor/skills/ 目录中加载技能。
• Hooks： 通过 .cursor/hooks.json 文件，在云端、自托管和本地环境中观察、控制并扩展智能体循环。
• Subagents： 将子任务委派给具名子智能体，它们拥有各自的提示词和模型，并由主智能体通过 Agent 工具启动。

基于任意模型构建

Cursor SDK 让您能够访问 Cursor 支持的所有模型。只需修改一个字段，您就可以根据当前任务将智能体路由到最佳模型，在成本与能力之间取得理想平衡。

借助 Composer 2——一款专为编程打造、以通用模型一小部分成本实现前沿级性能的模型——您可以在大多数编程智能体任务中获得智能与效率的最佳组合。

#开发者在构建什么

各团队都在使用 Cursor SDK，更快地推出自定义智能体。例如，直接由 CI/CD 触发的程序化智能体，可以总结变更、定位 CI 失败的根因，并在 PR 中更新修复内容。还有一些团队正在构建自定义智能体平台，例如内部应用，让 GTM 团队无需编写代码即可查询产品数据。

还有一些客户甚至将 Cursor 直接嵌入面向客户的产品中，让最终用户无需离开宿主应用，就能获得智能体体验。

来听听几位基于 Cursor SDK 构建产品的客户怎么说：

#从示例项目开始

我们在一个公开的 GitHub 仓库中添加了几个入门项目，您可以 fork 并扩展它们，以适配自己的使用场景：

• 快速开始： 一个极简的 Node.js 示例，用于创建本地智能体、发送一条提示，并以流式方式返回响应。
• 原型设计工具： 一个 Web 应用，用于在沙箱隔离的云环境中启动智能体，快速搭建新项目并迭代创意。
• 看板： 一个由智能体驱动的看板工具，工程师可以拖动卡片，让智能体通过编程方式接手任务、发起 PR，并将结果作为附件回传。
• 编码智能体 CLI： 一个轻量级命令行界面，让您可以从终端启动 Cursor 智能体。

#接下来

所有用户均可使用 Cursor SDK，费用按标准的基于 token 的用量定价计算。

我们将继续投入 Cursor SDK，重点是让团队能够更轻松地在更多语言、工作流和部署模式中构建程序化智能体。

如需了解更多，请阅读我们的文档。您也可以将 Cursor 与我们的 Cursor SDK 插件 搭配使用，帮助您开始构建。