Cursor 发布 Agent SDK,可将智能体部署到 Cursor 或自有基础设施
Agent SDK
Cursor 发布 Agent SDK,可将智能体定义为一个代码文件夹,用 evals 测试后部署到 Cursor 或自有基础设施。智能体项目由 instructions.md 作为提示词,tools/ 存放模型可调用的类型化动作,skills/ 存放按需加载的流程,mcp-connections/ 接入 MCP 服务器工具,channels/ 定义消息收发渠道。
官方给出 Agent 以代码目录定义、评测与部署的完整链路,可据此判断现有 Agent 工作流会怎样被改写。
Agent SDK 现已可用。它允许你将一个 agent 定义为一个代码文件夹,用 evals 对其进行测试,并将其部署到 Cursor 或你自己的基础设施上。
运行 `npx @cursor/agent-sdk init ./my-bot`,然后运行 `agent-sdk dev`,即可通过 playground 在本地启动该 bot。传入 `--template` 可从安全审查器、owners 策略审批器、PR 自动修复器,或 Linear 或 Jira 分诊器开始。
将 agent 部署到你需要的任何地方
当你准备将 agent 投入使用,可以在项目目录中运行 `agent-sdk deploy` 将其部署到 Cursor。该命令会构建 agent、为其分配一个 URL,并在我们的基础设施上启动它。你可以在仪表盘中管理密钥和集成,同时继续使用本地可用的相同日志、evals 和 playground。
Agent 即代码
一个 agent 就是一个项目。`instructions.md` 是提示词。`tools/` 中的每个文件都是模型可以调用的一个类型化操作。`skills/` 存放模型按需加载的过程,`mcp-connections/` 添加来自 MCP 服务器的工具,`channels/` 定义 bot 在何处接收和回复消息。`agent-sdk validate` 检查项目,`agent-sdk info` 打印发现的内容。
通道
Agent 会在来自 GitHub、GitLab 和 Bitbucket 的 pull request、评论和 CI 事件时唤醒;在 Slack 中被提及和收到私信时唤醒;在来自任何提供方的 webhook 时唤醒;以及按 cron 计划唤醒。GitHub 事件通过你的 Cursor 账户拉取,因此不需要公开的 webhook URL。Slack 开箱即用,支持良好。
每个对话都保留自己的会话,以及每条消息和每次工具调用的完整记录。对 pull request 或 Slack 线程的后续回复会恢复同一会话。
Evals
一个 eval 会向 bot 发送一条固定消息,并对其行为进行断言:运行了哪些工具、输入是什么,以及回复的形态。可在本地或 CI 中运行 `agent-sdk eval`。
`agent-sdk github replay <pr-url>` 会将一个真实的 pull request 转换为已签名的 webhook 载荷并发送给 bot,因此无需等待推送即可测试由 GitHub 驱动的 bot。添加 `--dry-run --fixtures-dir fixtures/` 可将载荷保存为 eval fixtures。
开始使用
Agent SDK 现已正式可用。阅读文档并开始使用。
来源:Cursor Changelog · cursor.com