Agent SDK 现已可用。你可以把智能体定义成一个代码文件夹,用 evals 测试它,再把它部署到 Cursor 或你自己的基础设施上。
运行 npx @cursor/agent-sdk init ./my-bot 初始化项目,再运行 agent-sdk dev,就能带着本地游乐场启动这个机器人。加上 --template 参数,可以从安全审查员、owners 策略审批员、PR 自动修复器,或者 Linear/Jira 问题分诊员这几种模板起步。
想部署到哪,就部署到哪
准备好正式启用智能体时,在项目目录里运行 agent-sdk deploy,就能把它部署到 Cursor。这条命令会构建智能体、给它分配一个 URL,并在我们的基础设施上启动它。
你可以在控制台里管理密钥和集成,同时继续使用本地已有的同一套日志、evals 和游乐场。
智能体即代码
一个智能体就是一个项目。instructions.md 是提示词。tools/ 里的每个文件,都是模型可以调用的一个带类型的动作。skills/ 存放模型按需加载的流程,mcp-connections/ 从 MCP 服务器引入工具,channels/ 定义机器人从哪里接收消息、又在哪里回复。
agent-sdk validate 用来检查项目,agent-sdk info 会打印出扫描到的内容。
渠道
智能体可以被这些事件唤醒:GitHub、GitLab 和 Bitbucket 上的拉取请求、评论和 CI 事件;Slack 里的提及和私信;任意服务商发来的 webhook;以及 cron 定时计划。
GitHub 事件通过你的 Cursor 账号拉取,因此不需要公开的 webhook URL。Slack 则是开箱即用、支持完善。
每个对话都保留自己的会话,以及每条消息和每次工具调用的完整记录。无论后续是在拉取请求上还是在 Slack 话题里跟进,都会接着同一个会话继续。
Evals
一条 eval 会向机器人发送固定消息,并对它的行为做断言:运行了哪些工具、输入是什么、回复长什么样。
你可以在本地或 CI 里运行 agent-sdk eval。agent-sdk github replay <pr-url> 会把一个真实的拉取请求转成带签名的 webhook 负载,发送给机器人,这样由 GitHub 驱动的机器人不必等推送就能测试。加上 --dry-run --fixtures-dir fixtures/,还能把这些负载保存成 eval 夹具。
开始使用
Agent SDK 现已正式可用。阅读文档,开始上手吧。
把智能体定义成一个代码文件夹,用 evals 测试它,再把它部署到 Cursor 或你自己的基础设施上。