本文目录

Cursor 已将 Agent SDK 标为一般可用。核心是把 agent 写成可版本管理的代码项目：本地跑 eval，再部署到 Cursor 或自有基础设施。

发布了什么

changelog 写明 Agent SDK「is available today」／「generally available today」。一个 agent 就是一个项目：instructions.md 是提示词；tools/ 里每个文件是模型可调用的一个类型化动作；skills/ 是按需加载的流程；mcp-connections/ 接入 MCP 工具；channels/ 定义收发消息的渠道。agent-sdk validate 检查项目，agent-sdk info 打印发现结果。

在项目目录执行 agent-sdk deploy：Cursor 称会构建 agent、分配 URL，并在其基础设施上启动；也可部署到自有基础设施。密钥与集成可在控制台管理，本地同样可用日志、eval 与 playground。

安装，以及包名不一致

文档与 npm 的安装方式是全局安装 @grok/agent-sdk，再初始化并本地启动：

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

截至北京时间 2026 年 10 月 27 日，npm 上 @grok/agent-sdk 最新为 0.3.0，曾用名 @cursor/bdk 同为 0.3.0。changelog 起手写的是 npx @cursor/agent-sdk init ./my-bot——该包名在 npm 上 404。命令示例以文档／npm 的 @grok/agent-sdk 为准。

init 可加 --template，从 security reviewer、owners-policy approver、PR autofixer，或 Linear／Jira triager 起步。

频道、Eval 与 Replay

Agent 可在 GitHub／GitLab／Bitbucket 的 PR、评论与 CI 事件，Slack 提及与私信，任意来源的 webhook，以及 cron 定时任务上唤醒。Cursor 称 GitHub 事件可经 Cursor 账号拉取，该路径无需公开 webhook URL。每段对话保留独立会话；PR 或 Slack 线程上的跟进会回到同一会话。

agent-sdk eval 发送固定消息，并断言调用了哪些工具、输入是什么、回复形态如何——可在本地或 CI 跑。agent-sdk github replay 把真实 PR 转成签名 webhook 载荷，便于在不等待 push 的情况下测 GitHub 驱动的 bot；可加 --dry-run --fixtures-dir 把载荷存成 eval 夹具。

本站尚未端到端实测 deploy／eval／replay，仅供参考。Cursor 文档里另有一张产品对照表，把 Agent SDK 与 Cursor Automations、Grok Bot 并排（版本化 Markdown／TypeScript 项目 vs 控制台提示词／触发器 vs 应用内配置）——那是 Cursor 自己的分档，不是本站排名。

相关文章见 Cursor 各档用量上限怎么算：The X Subscription 与旧计划（2026年10月）、Claude Code 和 Cursor 在价格和用量上到底差在哪（2026 年 10 月）、目前最强的编程智能体有哪些？Artificial Analysis 榜单排名（2026 年 10 月）。