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 投入使用后，可以在项目目录中运行 agent-sdk deploy 将其部署到 Cursor。该命令会构建 agent、为其分配一个 URL，并在我们的基础设施上启动它。你可以在仪表盘中管理密钥和集成，同时继续使用本地可用的相同日志、评估和 playground。

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

开始使用

开始使用 Agent SDK 与启动任何其他软件项目非常相似。创建一个项目目录，然后启动本地 playground：

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 完成开发过程。你可以让 agent 参考文档，让它帮你一起构建这个 bot。

Agent SDK 现已正式可用。阅读文档并开始使用。