博客 / 产品

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

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

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