AREX Feed Article
Cursor 官宣 Agent SDK 上线：提示词用 Markdown、工具用 TypeScript，内置 evals
北京时间 10 月 27 日凌晨（UTC 时间 10 月 26 日 18:58），Cursor 官方 X 账号 发布推文宣布：Agent SDK 现已推出。按推文的说法，开发者可以用代码定义 agent：提示词（prompts）写成 Markdown，工具（tools）写成 TypeScript；部署既可以放在 Cursor 的托管基础设施上，也可以在自己的环境里运行。SDK 内置 evals（评估测试），用来衡量每一次改动，让 agent 随时间变得更好。
Cursor 的 X 账号自述为 “Coding agent for building ambitious software”（构建大型软件的编码 agent）。推文附带一段视频，。《Introducing the Agent SDK》称该 SDK 为 “generally available”（正式可用）。文中关于产品能力的描述与客户案例均出自 Cursor 官方材料，开发者反应来自推文回复区。
一个 agent 就是一个小型软件项目
博客写道，一个 Agent SDK 项目里，指导 agent 的指令与它的工具代码、外部服务连接、用于测试的 evals 放在同一组文件里，“每个文件代表 agent 知道的或能做的一件事”。既然一切都是代码，改动就能走和其他软件一样的版本控制与评审流程。
把分工说得更直白：指令、工具和 evals 是可以像普通代码一样评审、测试、版本化的文件，“你写指令和工具，Cursor 运行调用它们的模型循环”。一个 agent 的行为定义在一个由 Markdown 和 TypeScript 组成的文件夹里，把确定性代码和模型判断结合在一起；架构上自带模型路由、沙箱、MCP 连接和密钥管理。
起步流程被设计成“用 agent 造 agent”：文档要求 Node 22.13 或更新版本，命令行提供 agent-sdk init、agent-sdk dev、agent-sdk login 等子命令；每页文档在 URL 后加 .md 就能变成 Markdown 喂给编码 agent，包里还附带引导开发流程的 skills（技能文件）。博客给出的最小示例是一个 TypeScript 文件：从 @cursor/agent-sdk 导入 defineAgent，声明一个名叫 Robo 的 agent，模型 id 为 composer-2.5，参数 effort 设为 high、fast 设为 true。
一条命令部署到托管环境，或打包成容器自己跑
部署给了两条路。在项目目录里执行 agent-sdk deploy，命令会构建 agent、分配一个 URL 并把它启动在 Cursor 的基础设施上；密钥和集成在 dashboard（控制面板）里管理，本地那套日志、evals 和 playground（试跑环境）继续可用。部署完成的 agent 统一在 cursor.com/dashboard/deployed-agents 页面管理。
不想把 agent 放在 Cursor 侧，也可以自己跑：每个 agent 是一个单独的 Node 进程，可以打包进容器放到自己的基础设施上。文档的选型表把 Agent SDK 和在 dashboard 里配置的 Cursor Automations 区分开：后者定义的是“一个提示词、一个模型、一个触发器”，由 Cursor 托管；Agent SDK 的对应物是一个可版本控制的 Markdown 和 TypeScript 项目，托管或自持都可以选。
evals 开箱即用，开发者追问评估怎么跑
博客称 evals 和事件回放（event replay）开箱即用，为“关键工作流按预期执行”提供保障；开发者可以在本地迭代、先跑 evals，再执行 agent-sdk deploy。
评估具体怎么跑，回复区当天就有人追问。有开发者认为“evals 随 SDK 一起发布才是重点”，并追问分数是每次改动提示词时都跑，还是只在部署时跑（）；做工具集成的 Agentik（）想知道 evals 调用的是录制好的工具调用还是真实调用，并提醒“agent 一碰到付费 API，真实评估的成本涨得非常快”。 则表示：“内置 evals 是我真正会用的部分。我现在大多数 agent 改动，就是凭感觉，然后祈祷。”
Cursor 自家的托管 agent 就跑在这套框架上
博客对 Agent SDK 的定位很明确：它是 Cursor 构建 Bugbot、Security Reviewer、Rollouts 这些自家托管 agent 时用的框架；文档补充说，同一套 harness（agent 运行框架）还支撑着 Approval Bot。
以代码评审为例，博客描述的用法是：agent 响应来自 GitHub、GitLab 或 Bitbucket 的 pull request 事件，评估改动风险，路由给合适的团队，并按政策批准符合条件的变更。博客列举的场景还包括执行合规流程、调查事故。一个更具体的例子来自 Cursor 内部团队：他们用大约一天时间搭出 kb-reviewer，现在跑在主代码库的每个 PR 上，标记与已记录经验相抵触的改动，并引用每条发现背后的笔记，推动工程师消除不一致。复杂任务可以交给拥有自己工具和会话的专门 agent，也可以拆分给并行运行的 subagent（子 agent）；接入入口包括 Slack、pull request、issue tracker 和 Cursor 本身。
客户名单里有 PGA Tour，评论区则问“这不是半年前就出了吗”
客户方面，博客称 PGA Tour 用 Agent SDK 支撑其“软件开发工厂”（software development factory），并援引 PGA America 首席工程师 Michael Gyarmathy 的话：“Agent SDK 让 PGA 得以在 Cursor 的基础设施上构建软件工厂的每一个组件。它提供了我们所需的灵活性，去构建驱动开发流程的 agent。而内置的 evals 支持让我们能快速迭代新想法，并可靠地优化现有能力。”
截至北京时间 10 月 27 日 8 时许，这条推文已有约 2,460 次点赞、约 18 万次浏览和 231 条回复。不过点赞最高的一条回复来自 ：“这不是半年前就出了吗？”还有用户称自己从 4 月就开始使用这套 SDK，对“现在才可用”的表述表示不解（）。
时间线也印证“早已有之”：博客页面标注的发布时间是 10 月 20 日，文中已宣布 SDK 正式可用；文档注明这个包此前名为 @cursor/bdk。这条推文做的，是把一个已经存在了一段时间的产品放上了官方 X 时间线。
还有一个细节没理顺：两个官方页面对这个 npm 包的名字说法不一致，博客示例从 @cursor/agent-sdk 导入，文档的安装命令却写作 npm install --global @grok/agent-sdk。想在自托管环境里跑起来的团队，装包之前得先核对一遍。