核心要点速览
- Cursor Agent SDK 的核心思路是「智能体即代码」：每个智能体的提示词存为 Markdown 文件，工具用 TypeScript 编写，便于版本管理和团队协作。
- 运行方式有两种：部署到 Cursor 的托管基础设施，或在自己的服务器上自部署，后者更适合对数据流向有严格要求的企业。
- 内置 evals 评测功能可以针对每次提示词或工具改动跑分，让「这次改动到底有没有变好」有据可查。
- 官方页面在 cursor.com，需要下载 Cursor Desktop 或 CLI 并登录账号；具体价格与免费额度请在官网 Pricing 页面确认。
项目速览
| 类型/定位 | 智能体开发套件，面向开发者 |
|---|---|
| 适用设备 | 以 macOS 桌面端与命令行工具为主 |
| 费用说明 | 官网 Pricing 页面查看，含免费额度说明 |
| 语言支持 | 界面可切换语言，官方文档以英文为主 |
| 核心亮点 | Markdown 提示词、TypeScript 工具、内置评测 |
| 使用门槛 | 需会 TypeScript，并具备命令行基础 |
| 分类 | 开发与工具 |
| 作者 / 发布方 | Cursor |
| 官方网站 | cursor.com ↗ |
| 热度 | 🔥 热度 27万 |
| 最后更新 |
Cursor Agent SDK 想解决什么问题：把智能体从提示词实验变成可维护的工程
过去一年里，很多人做 AI 智能体的方式是打开一个对话框，反复粘贴和修改提示词，效果好不好全靠主观感受。一旦提示词变长、工具变多，改动就会互相干扰，谁也不敢确定新版本是不是真的比旧版本强。Cursor 在 2026 年 10 月推出 Agent SDK，正是针对这个痛点：它把智能体拆成两个可版本化的部分，提示词写成 Markdown 文件，工具写成 TypeScript 代码，让智能体像普通软件项目一样被管理。
所谓「智能体即代码」，意思是智能体的行为定义不再散落在聊天记录里，而是落在仓库中。Markdown 负责描述任务目标、约束和输出格式，人类读起来清晰；TypeScript 负责定义智能体能调用的外部能力，比如读取数据、调用接口、执行计算，类型系统能在编译阶段拦下不少低级错误。两者结合，团队可以用代码评审的方式讨论智能体改动，而不是靠口头描述。
另一个关键设计是运行位置可选。你可以把智能体部署到 Cursor 的托管基础设施上，省去运维；也可以在自己的服务器上自部署，把数据流向控制在自己手里。对于处理敏感代码或内部数据的团队，自部署往往是能否落地的分水岭。官方页面在 cursor.com，具体能力边界建议以官网文档为准。
- 提示词与工具分离
Markdown 管意图，TypeScript 管能力，改动范围清晰，出问题更容易定位是提示词还是工具的问题。
- 托管与自部署双轨
托管模式上手快，自部署模式适合对数据合规有要求的团队，可按项目分别选择。
- 内置评测闭环
每次改动都能跑评测对比分数，避免「感觉变好了」式的无效迭代。
核心机制拆解：Markdown 提示词、TypeScript 工具与内置评测如何配合
一个智能体在 Agent SDK 里通常由若干文件组成。提示词文件用 Markdown 编写，可以写清角色设定、任务步骤、边界条件和输出格式，也方便非工程角色参与修改。工具文件用 TypeScript 编写，每个工具本质上是一个带类型签名的函数，声明它接受什么参数、返回什么结果，智能体在推理过程中按需调用。
内置评测是这套工具链里最值得关注的部分。你可以为智能体准备一组评测用例，在修改提示词或工具前后分别运行，比较通过率和输出质量的变化。这样一来，迭代就有了基线：只有评测分数提升的改动才保留，回退也有依据。对于多人协作的项目，评测结果还能作为代码评审的客观参考。
围绕核心能力，Cursor 还提供了 Cloud、Automations、Marketplace、Review 等配套功能，分别对应云端运行、定时或触发式自动化、能力扩展与团队评审。它们的具体开放程度和计费方式可能随版本变化，建议在官网的文档与更新日志中确认当前状态，不要仅凭第三方介绍做技术选型。
- 评测用例要贴近真实任务
用例如果太简单，分数会虚高；建议从实际业务里抽取有代表性的输入，并保留一批不常改动的固定用例。
- 工具粒度宁小勿大
一个工具只做一件事，参数和返回值都写明确类型，智能体调用时更不容易出错，调试也更直观。
- 改动一次只做一处
同时改提示词和工具会让评测结果无法归因，分步修改才能知道究竟是哪一处带来了提升。
从零上手流程：安装、定义第一个智能体到跑通评测
上手路径比较直接：先在官网 cursor.com 下载 Cursor Desktop 或命令行工具，安装后登录账号。桌面端适合交互式地观察智能体运行状态，命令行工具适合接入脚本和持续集成流程。企业用户如果关心采购和权限问题，官网也提供了联系销售和预约演示的入口。
第一个智能体建议从你已经在用的提示词改起，而不是凭空设计一个复杂系统。把现有提示词整理成 Markdown 文件，明确任务目标和输出格式；再挑一到两个必要的外部能力写成 TypeScript 工具。此时先不要追求功能齐全，跑通一次完整调用比堆功能更重要。
跑通之后立刻建立评测基线：准备一组小规模用例，记录当前分数，然后开始迭代。每次只改一处，改完重跑评测，分数上升就保留，下降就回退。等流程稳定，再考虑用自动化功能把重复任务交给智能体定时执行，或把成熟的能力沉淀到团队共享的组件里。
- 先跑通再优化
第一个智能体只要能完成一个简单任务即可，过早引入复杂工具链会掩盖真正的问题。
- 评测基线越早建越好
没有基线，后续所有改动都无法判断好坏，等于又回到了凭感觉调提示词的状态。
适用场景、同类方案对比与当前限制
Agent SDK 最适合的场景，是团队已经有明确的智能体需求，并且希望把它纳入正常的软件工程流程：代码评审、版本管理、自动化测试、持续集成。它也适合需要自部署的团队，比如代码或数据不能离开自有环境的情况。相反，如果只是想临时体验一下 AI 写代码，直接用编辑器里的对话功能可能更省事。
与直接用通用大模型接口自己搭一套智能体框架相比，Agent SDK 的优势在于把提示词组织、工具定义和评测这三件事做成了约定俗成的结构，减少了重复造轮子。代价是你要接受它的组织方式，并投入时间学习 TypeScript 侧的写法。与只提供对话式智能体的产品相比，它更偏向工程化和可运维，而不是开箱即用的聊天体验。
需要留意的是，这类工具迭代很快，功能范围、计费方式和可用区域都可能调整。本文提到的能力基于发布时的公开信息，具体支持哪些语言、哪些平台、免费额度如何计算，请以官网 cursor.com 的文档和定价页面为准。另外，自部署虽然能控制数据，但也意味着运维、升级和安全加固要自己承担。
- 适合纳入工程流程的团队
有代码评审习惯、愿意为评测用例投入时间的团队，收益最明显。
- 自部署换取数据可控
对合规敏感的行业可以优先评估自部署方案，但要同步评估运维成本。
- 细节以官网为准
平台支持、计费与功能开放范围变化较快，选型前请核对官方文档与更新日志。
分步上手指南
第一步：获取并安装工具
前往官网 cursor.com，在下载入口获取 Cursor Desktop 或命令行工具，按提示完成安装。安装后登录账号，确认能正常打开智能体相关界面。企业用户可同时查看定价与联系销售的入口，提前了解授权方式。
第二步：把现有提示词改写成 Markdown 智能体文件
挑一个你已经在用的提示词，整理成 Markdown 文件，写清任务目标、执行步骤、约束条件和输出格式。建议保持结构清晰、段落简短，方便后续逐条修改和对比。这一步不需要写任何代码，先把意图表达准确。
第三步：用 TypeScript 定义所需工具
列出智能体完成任务必须调用的外部能力，比如读取文件、查询数据或调用接口，每个能力写成一个 TypeScript 函数，并标注参数与返回类型。工具数量先控制在两三个以内，确保每个都能单独测试通过，再接入智能体。
第四步：选择运行方式并跑通第一次调用
根据数据合规要求，决定把智能体部署到 Cursor 的托管基础设施，还是运行在自己的服务器上。配置完成后发起一次真实调用，观察执行过程是否符合预期。如果失败，优先检查工具参数和提示词中的约束是否冲突。
第五步：建立评测基线并持续迭代
准备一组有代表性的评测用例，记录当前得分作为基线。之后每次只修改一处提示词或工具，改完重跑评测，分数提升才保留。稳定运行后，可再用自动化与云端功能把重复任务交给智能体定期执行。
常见问题
Cursor Agent SDK 是什么？和直接在编辑器里让 AI 写代码有什么区别？
它是一个开发套件，让你把智能体的提示词写成 Markdown、工具写成 TypeScript，从而像管理代码一样管理智能体。与直接在编辑器里对话不同，它强调可版本化、可评测、可部署，适合需要长期维护和团队协作的场景。如果你只是偶尔让 AI 帮忙改几行代码，用编辑器内置的对话功能可能更快。
在哪里可以获取？需要付费吗？
官方页面在 cursor.com，可从官网下载 Cursor Desktop 或命令行工具并登录使用。费用相关信息在官网的定价页面查看，是否包含免费额度、额度如何计算，请以官网当前说明为准。企业采购通常还有联系销售和预约演示的渠道。
必须会 TypeScript 才能用吗？
提示词部分只需要写 Markdown，门槛不高；但定义工具需要 TypeScript，因此具备一定编程基础会更顺畅。如果你的智能体不需要调用外部能力，理论上可以先只用提示词跑起来。实际使用中，工具往往是发挥智能体价值的关键部分，建议至少掌握基础的 TypeScript 写法。
托管和自部署应该怎么选？
托管方式由 Cursor 提供运行环境，上手快、运维负担小，适合快速验证和中小团队。自部署把运行环境放在自己的服务器上，数据流向更可控，适合对合规和保密有要求的组织，但升级、监控和安全加固需要自己负责。可以先用托管验证效果，再根据合规要求迁移到自部署。
内置评测具体能帮上什么忙？
它让你在修改提示词或工具前后运行同一组用例，用分数变化判断改动是否真的有效。这样迭代就有基线，回退也有依据，避免陷入「感觉变好了」的循环。建议用例贴近真实任务，并保留一批长期不动的固定用例作为参照。
