Cursor SDK放出来了

综合交流大区
1

Cursor SDK开了：@cursor/sdk。用typescript写的。

最简单的demo差不多长这样：

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/cookbook仓库，里面有几个用法的例子：

  • sdk/quickstart：最基础的Node.js示例。
  • sdk/app-builder：用agent生成和迭代React应用的原型工具，本地跑的。
  • sdk/agent-kanban：管理Cursor Cloud Agents的看板。
  • sdk/coding-agent-cli：从终端启动coding agent的CLI例子。

能用来干啥也比较明显：

  • 在CI流程里自动分析为啥失败，甚至试着修一下。
  • 在自己公司内部的研发平台里发起代码任务。
  • 给工单、PR或者仓库巡检接一个能写代码的agent。
  • 批量跑那些重复、但又需要理解代码上下文的工程活儿。

有个挺明显的问题，目前还不能用自己的API KEY。SDK demo里传的是CURSOR_API_KEY，这个key是从Cursor Dashboard来的。

参考链接：

2

这东西就那样，用过就知道局限了。

3

小白问一下，这个Agent.create()的返回值run，除了.stream()还有其他方法可以拿到最终结果吗？我不太确定是不是必须用for await来遍历事件。

4

又来了，每次出个新东西就吹得天花乱坠，实际用起来一堆坑，等小白鼠先上吧。

5

根据帖子里的demo，第一步先导入Agent，然后需要环境变量里配好CURSOR_API_KEY。创建agent实例的时候可以指定模型和本地工作目录。调用.send方法传入指令，返回的run对象可以异步迭代流事件。具体业务逻辑就看你想让agent干啥了，比如帖子说的分析CI失败原因。

6

等一下，帖子里说“目前还不能用自己的API KEY”，这是什么意思？是指现在只能用Cursor Dashboard生成的key，不能接入OpenAI或者 Anthropic 的key吗？那成本怎么算？

7

我们团队上周内部试了一下，流程确实通了。但有个坑，agent对复杂代码库的上下文理解还是不够，经常跑偏。后来我们把它用在了一个比较窄的场景，就是自动检查新提交的PR里有没有漏掉更新某个配置文件，这个它干得还行，省了点人工。但别指望太智能。

8

这东西感觉潜力在集成，单独用可能差点意思。我们内部平台正好在重构，我在想要不要把这块能力接进去，用户可以在界面上描述个需求，直接拉起个agent去代码库里找相关模块或者生成个初步的修改草案，后面人工再核一下。不过权限和操作范围得卡死，不然乱改就出大事了。

9

终于出SDK了，agent接入可玩性高了不少

10

我昨天烤的曲奇饼有点糊了，是不是烤箱温度太高？跟这个SDK有关系吗？

11

可以await整个run拿result，不一定非得for await

12

教程好详细 蹲个完整demo仓库链接

13

现阶段只支持Cursor自家key，估计是商业策略

14

你这步骤说得清楚 但env那个变量名要看版本

15

终于开了，TS版本对前端友好不少

16

Cursor SDK出来了 期待第三方做workflow