Cursor 发布 Agent SDK，可用代码定义并一键部署智能体

软件团队用代码定义的智能体来处理开发生命周期中反复出现的工作。这些智能体会接入团队日常工作的各个平台，在相关事件发生时采取行动，无论是审查拉取请求、执行合规流程，还是排查故障。

最有用的智能体，都是按某个团队自身的运作方式来定制的。但在此之前，要构建这样一个智能体，通常要么采用围绕别人工作流设计的产品，要么从零开始。

今天我们发布 Agent SDK，它正是我们用来构建自家托管智能体（如 Bugbot、Security Reviewer 和 Rollouts）的框架。Agent SDK 让你用代码定义智能体，并像管理其他任何软件项目一样管理它们。你可以从模板起步，也可以让编码智能体直接阅读我们的文档。智能体准备好后，agent-sdk deploy 用一条命令把它部署到 Cursor 基础设施上。

围绕你的工作流来构建

Agent SDK 让你能快速构建和部署符合团队工作方式的智能体。它们响应团队已经在处理的事件，遵循团队可以检查和修改的策略。

代码审查就是一个例子。每个团队对于哪些改动需要关注、该由谁来审查，都有自己的标准。借助 Agent SDK，你可以构建一个响应 GitHub、GitLab 或 Bitbucket 拉取请求事件的智能体。这个智能体可以评估改动的风险，把它转给合适的团队，并批准符合你策略的改动。

举个例子，Cursor 内部有个团队建立了一个规模庞大、快速增长的“经验教训”知识库，希望每个拉取请求都对照它来检查。这样一来，即使代码库不断变化，团队过去的决策依然有效。借助 Agent SDK，他们大约一天就构建出了 kb-reviewer。现在它在该团队主代码库的每个 PR 上运行，标记出与已记录经验相矛盾的改动，为每条发现引用背后的笔记，并鼓励工程师去处理它报告的不一致之处。

对于更复杂的工作，智能体可以把任务交给另一个拥有自己工具和会话的专用智能体，也可以把一项工作拆分给多个并行工作的子智能体。

Agent SDK 还开箱即用地支持评估和事件回放，让你能快速开发，同时确保关键工作流按预期执行。PGA Tour 就用 Agent SDK 来驱动他们的软件开发工厂。评估让他们保持快速推进。

Agent SDK 让 PGA 能够在 Cursor 的基础设施上构建我们软件工厂的每一个组件。它提供了我们所需的灵活性，用来构建驱动开发流程的智能体。内置的评估支持让我们能快速迭代新想法，并可靠地优化现有能力。

Michael Gyarmathy

首席工程师

,

PGA America

一切皆以代码定义

Agent SDK 智能体的组织方式就像一个小型软件项目。指导它的指令，与它的工具代码、外部服务连接以及用于测试它的评估放在一起。

每个文件都代表智能体知道或能做的某件事。提示词用 Markdown 编写，工具则定义为 TypeScript 函数。因为一切都是代码，改动可以像其他软件一样走版本控制和审查流程。

把智能体部署到任何你需要的地方

准备好把智能体投入使用后，你可以在项目目录下运行 agent-sdk deploy，把它部署到 Cursor。这条命令会构建智能体、为它分配一个 URL，并在我们的基础设施上启动它。你可以在控制台管理密钥和集成，同时继续使用本地已有的日志、评估和演练场。

你也可以在自己的基础设施上运行智能体。每个智能体都以单个 Node 进程运行，可以打包进容器。

开始使用

上手 Agent SDK 和启动其他软件项目差不多。先创建一个项目目录，然后启动本地演练场：

import { homedir } from "node:os";
import { join } from "node:path";
import { defineAgent } from "@cursor/agent-sdk";

export default defineAgent({
  name: "Robo",
  model: {
    id: "composer-2.5",
    params: [
      { id: "effort", value: "high" },
      { id: "fast", value: "true" },
    ],
  },
  local: {
    cwd: join(homedir(), ".cache", "factory", "robo"),
  },
})

接下来你可以在本地反复迭代、运行评估，再用 agent-sdk deploy 部署。

Agent SDK 还自带一些技能，可以引导编码智能体走完整个开发流程。你可以让智能体去读文档，让它和你一起把这个机器人搭起来。

Agent SDK 今天已正式可用。阅读文档开始使用。