Cursor 正式推出 Agent SDK,可用代码文件夹定义并部署智能体
Agent SDK
Cursor 正式推出 Agent SDK,支持以代码文件夹形式定义智能体,用评估测试,并部署到 Cursor 或自有基础设施。运行 npx @cursor/agent-sdk init 即可初始化,agent-sdk deploy 会构建智能体并分配 URL;提供安全审查、PR 自动修复、Linear / Jira 分诊等模板。
原文给出智能体即代码的项目结构和评估、部署命令,读者可以据此把 PR 审查、Slack 分诊等机器人跑起来。
Agent SDK 现已正式推出。你可以用它以代码文件夹的形式定义智能体,用评估对其进行测试,并部署到 Cursor 或你自己的基础设施上。
运行 npx @cursor/agent-sdk init ./my-bot,再运行 agent-sdk dev,即可在本地启动机器人,并通过 playground 进行调试。传入 --template 参数,即可基于现成模板快速上手:安全审查智能体、所有者策略审批机器人、PR 自动修复机器人,或 Linear / Jira 问题分诊机器人。
将智能体部署到任何需要的地方
当您准备好正式使用某个智能体时,只需在项目目录中运行 agent-sdk deploy,即可将其部署到 Cursor。该命令会构建智能体、为其分配 URL,并在我们的基础设施上启动它。您可以在仪表盘中管理密钥和集成,同时继续使用与本地一致的日志、评估和 playground。
智能体即代码
一个智能体就是一个项目。instructions.md 就是提示,tools/ 中的每个文件都是模型可调用的一个带类型的操作。skills/ 存放模型按需加载的流程,mcp-connections/ 用于添加来自 MCP 服务器的工具,channels/ 则定义机器人在哪里接收和回复消息。agent-sdk validate 用于检查项目,agent-sdk info 则会打印所发现的内容。
频道
智能体可由以下事件唤醒:GitHub、GitLab 和 Bitbucket 上的 PR、评论和 CI 事件;Slack 中的提及和私信;任意提供商发送的 Webhook;以及 cron 定时计划。GitHub 事件通过你的 Cursor 账户拉取,因此无需公开的 Webhook URL。Slack 开箱即用,支持完善。
每个对话都拥有独立的会话,并完整记录每条消息和每次工具调用。在 PR 或 Slack 讨论串中的后续提问会继续同一个会话。
评估
评估会向机器人发送一条固定消息,并对其行为进行断言:运行了哪些工具、传入了什么输入,以及回复的结构是否符合预期。你可以在本地或 CI 中运行 agent-sdk eval。
agent-sdk github replay <pr-url> 会将一个真实的 PR 转换为已签名的 Webhook 有效载荷并发送给机器人,这样无需等待推送,就能测试由 GitHub 驱动的机器人。添加 --dry-run --fixtures-dir fixtures/ 即可将这些有效载荷保存为评估 fixture。
开始使用
Agent SDK 现已正式发布。欢迎阅读文档,立即开始使用。
来源:Cursor:Changelog · cursor.com