博客 / 产品

软件团队使用以代码定义的代理来处理开发生命周期中反复出现的工作。这些代理会连接到团队工作所在的位置，并在相关事件发生时采取行动，无论是审查拉取请求、执行合规工作流，还是调查事故。

最有用的代理是根据特定团队的运作方式量身定制的。到目前为止，构建这样一个代理通常意味着采用围绕他人工作流设计的产品，或者从零开始。

今天，我们发布 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 现已正式可用。阅读文档并开始使用。