软件团队借助以代码定义的智能体，处理贯穿整个开发生命周期的重复性工作。这些智能体接入团队日常工作的各个平台，在相关事件发生时自动采取行动，无论是审查 PR、执行合规性工作流，还是排查事件。

最实用的智能体，往往是根据特定团队的运作方式量身打造的。而在此之前，要构建这样的智能体，通常只能二选一：要么采用围绕别人的工作流设计的产品，要么从零开始。

今天，我们正式发布 Agent SDK——我们用来构建 Bugbot、安全审查智能体和 Rollouts 等自有托管智能体的框架。借助 Agent SDK，你可以用代码定义智能体，并像管理其他软件项目一样管理它们。你可以从模板起步，也可以让你的编程智能体直接参考我们的文档。智能体就绪后，只需一条 agent-sdk deploy 命令，即可将其部署到 Cursor 基础设施上。

#围绕你的工作流构建

借助 Agent SDK，你可以快速构建和部署贴合团队工作方式的智能体。它们会响应团队日常处理的事件，并遵循团队可以检查和更改的策略。

代码审查就是一个示例。每个团队对哪些内容需要关注、应由谁来审查都有各自的标准。借助 Agent SDK，你可以构建一个智能体，响应来自 GitHub、GitLab 或 Bitbucket 的 PR 事件。该智能体可以评估更改的风险，将其分派给合适的团队，并批准符合你策略的更改。

举例来说，Cursor 内部的一个团队积累了一个庞大且快速增长的经验知识库，希望每个 PR 都能对照该知识库进行检查。这样，即使代码库不断演进，团队过去做出的决策也能得到贯彻。借助 Agent SDK，他们只用了大约一天就构建出了 kb-reviewer。现在，它会在其主代码库的每个 PR 上运行，标记与已记录经验相矛盾的更改，为每个发现的问题注明所依据的笔记，并促使工程师解决它所报告的不一致之处。

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

Agent SDK 还开箱即支持评估和事件回放，让你既能快速开发，又能确保关键工作流按预期执行。PGA Tour 使用 Agent SDK 驱动其软件开发工厂，而评估让他们始终保持快速迭代。

#用代码定义一切

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

每个文件都代表智能体掌握的一项知识或具备的一项能力。提示词用 Markdown 编写，工具则定义为 TypeScript 函数。由于一切都是代码，所有更改都可以和你的其他软件一样，走同样的版本控制和审查流程。

#按需将智能体部署到任何地方

当你准备好让智能体投入使用时，只需在项目目录中运行 agent-sdk deploy，即可将其部署到 Cursor。该命令会构建智能体、为其分配 URL，并在我们的基础设施上启动它。你可以在控制台中管理密钥和集成，同时继续使用与本地环境中相同的日志、评估和 playground。

你也可以在自己的基础设施上运行智能体。每个智能体都以单个 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 SDK 现已正式发布。阅读文档，立即开始使用。