@cursor/bdk

中文文档
0.6.0发布于 2026/11/04SEE LICENSE IN LICENSE.mdTypeScriptES Module近 30 天下载 12.7万

建立,测试,并部署代理 作为密码Cursor的代理牵引.

中文使用文档
文档目录5 节
  1. 为什么用它
  2. 何时使用 SDK 代理
  3. 开始吧
  4. 从模板开始
  5. 今后的步骤

SDK探员

SDK探员是Cursor如何建立bots和 探员 这是Bugbot背后的引擎开源版本, 安全审查,批准瓶,和推出.

一个代理SDK项目是Markdown和TypeScript的文件夹. 组合模式 ,然后提供结果 源控,Slack,发行跟踪器,和Cursor.

为什么用它

  • 鲍茨和特工都住在你的保险箱里. 评论、版本和船舶 指令,工具,还有你的代码.

  • 光标运行回路. 您的项目获得 Cursor 的模型和工具 呼叫,技能,MCP,和子剂.

  • 使用它的地方你的工作. 从源控制触发一个工程 事件, 黑线,自定义的webhooks,或调度.

  • 测试普通类型脚本 . 添加无 evals 和 单元测试 单独的配置语言.

  • 选择它运行的地方. 部署到光标管理的主机或运行 您的基础设施的过程 .

何时使用 SDK 代理

光标自动化格鲁克瓶SDK探员
用于由迅速和触发驱动的可重复的工作在 Cursor 中工作的互动代理需要自定义代码、集成、测试或部署选择的代理人
您定义仪表板上的快取、模型和触发器应用程序中的指令、技能和相关工具一个版本的 Markdown 和 TypeScript 工程
它运行的地方光标管理光标管理光标管理托管或您的基础设施
选择何时任务符合时间表或事件触发器您想要不创建软件工程的代理你要用定型的代码来决定模型判断 你的团队可以审查和测试一个项目

开始吧

SDK特工需要22.13节点或更新. 安装 @grok/agent-sdk创建一个 ,并启动开发服务器:

npm install --global @grok/agent-sdk
agent-sdk init ./my-bot
cd my-bot
agent-sdk dev

对于没有全局安装的一次性脚手架:

npx @grok/agent-sdk init ./my-bot

在 Cursor 中打开工程 。 SDK 代理用户 bot/ 为代理人保留 evals/ 项目根 :

my-bot/
├── package.json
├── bot/
│   ├── agent.ts
│   ├── instructions.md
│   ├── tools/
│   ├── skills/
│   ├── mcp-connections/
│   ├── subagents/
│   ├── channels/
│   ├── hooks/
│   └── schedules/
└── evals/

在 Cursor 中描述机器人或代理, 或者自己编辑文件 .

从模板开始

传递模板到 agent-sdk init 当一个符合你的目标时:

模板能力
security-reviewer审查可开发错误的拖取请求
thermo-quality-review审查结构代码质量
thermo-review审查错误和断开
agentic-owners应用所有者政策来拉动请求
triage-linear 或者说 triage-jira跟踪仪问题
agent-sdk init ./security-reviewer --template security-reviewer

--template triage 选择 triage-linear。 。 。 .

今后的步骤

运行 agent-sdk docs 打开全部文档。 默认, agent-sdk serve 也提供同一地点的文件 /docs。 。 。 .

文件包括:

  • 一个完整的公关审查员快速启动
  • GitHub、Slack、webhook和MCP指南
  • 木卫一和山地攀登
  • 部署和解决问题
  • 项目布局、 CLI 和 API 参考

版本与发布记录

@cursor/bdk 共发布 32 个版本,首次发布于 2026/09/23;过去 12 个月发布了 32 个版本。

版本发布日期距今
0.6.0latest2026/11/047 天前
0.5.02026/10/2913 天前
0.4.02026/10/2814 天前
0.3.02026/10/2616 天前
0.2.292026/10/2418 天前
0.2.282026/10/2220 天前

关于 @cursor/bdk 的常见问题

@cursor/bdk 是什么?

建立,测试,并部署代理 作为密码Cursor的代理牵引.

如何安装 @cursor/bdk?

在项目目录运行 npm install @cursor/bdk,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^3.25.0 || ^4.0.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 bdk、agent-sdk,可以用 npx bdk 直接运行。

@cursor/bdk 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@cursor/bdk 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@cursor/bdk 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.13。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@cursor/bdk 可以商用吗?

@cursor/bdk 使用 SEE LICENSE IN LICENSE.md 许可。许可条款写在包内的独立文件中,请阅读该文件确认可否商用。以上为概括,不构成法律意见,请以许可原文为准。

@cursor/bdk 的下载量有多少?

根据 npm 官方下载统计,@cursor/bdk 在 2026/10/11 – 2026/11/09 这 30 天内被下载 127,402 次,日均约 4,247 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cursor/bdk 还在维护吗?

最新版本 0.6.0 发布于 2026/11/04(7 天前);至今共发布 32 个版本,其中过去 12 个月发布了 32 个;首次发布于 2026/09/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。