Cloud Agents（云端智能体）

云端智能体使用同样的智能体基础能力，但运行在云端带有完整开发环境的隔离虚拟机里，而不是你的本地机器上。开发环境与你笔记本上的设置类似：克隆的仓库、已安装的依赖、密钥、启动命令和网络访问。有效的开发环境给智能体提供对你代码库和组织的完整上下文，让它们能测试并验证自己的工作。

为什么用云端智能体

你可以并行运行任意多个智能体，它们不需要你的本地机器联网。因为拥有自己的虚拟机，云端智能体可以构建、测试并与改动后的软件交互，也可以用电脑控制桌面和浏览器；它们支持 MCP 服务器，可以访问外部工具和数据。云端智能体还能在多仓库环境里运行：任务跨越独立的前端、后端、基础设施或共享库仓库时用它，智能体可以检查整个工作区、做协调一致的改动，并在涉及的仓库里开 PR。

如何访问

任何人能从某个仓库启动云端智能体之前，Cursor 账号管理员需要为账号连接源码托管：GitHub（Cloud 和 Enterprise Server）、GitLab（Cloud 和自托管）、Bitbucket Cloud 或 Azure DevOps。你可以从任何工作的地方启动云端智能体：Cursor for iOS；Cursor Web（任何设备上的 cursor.com/agents）；Cursor Desktop（在智能体输入框下的下拉里选 Cloud）；Slack（用 @cursor 命令）；GitHub 或 Bitbucket（在 PR 或 issue 上评论 @cursor）；Linear（用 @cursor 命令）；API。Android 上用 Chrome 打开 cursor.com/agents 并点 Install App 安装 PWA。

如何工作

• 仓库提供商连接：云端智能体从 GitHub、GitLab、Azure DevOps Services 或 Bitbucket Cloud 克隆你的仓库，在单独的分支上工作，然后把改动推送到你的仓库交接。你需要对仓库和任何依赖仓库或子模块的读写权限
• 环境：智能体的能力取决于它们运行的环境。能写代码却无法运行测试、查询服务或访问 API 的智能体无法闭环完成工作。不给云端智能体设置开发环境，就像不给工程师一台电脑。环境设置是提高云端智能体有效性最重要的一步。可以用智能体引导的设置、保存的快照，或 .cursor/environment.json 里的 Dockerfile 配置环境；构建（Builds）在后台准备每个环境，让智能体一开始就有仓库和依赖
• 运行时和环境控制：Cursor 管理每个云端智能体的 VM 预配、隔离、快照、启动、产物和容量。你可以添加密钥、限制出站域名、用 Tailscale 或类似客户端连接私有网络

环境设置

云端智能体在隔离的 Ubuntu 机器上运行。配置环境，让智能体拥有开发者会用的相同仓库、工具、依赖、密钥和网络访问。有两种主要方式：

1. 智能体引导的设置（推荐）：让 Cursor 的智能体从 Cloud Agents 控制台设置自己的环境，它安装依赖、验证环境并创建第一个 Build。Cursor 能在不到 10 分钟内在云端设置好你的开发环境，从 Cloud Agents 控制台或 Cursor 桌面应用的 Agents Window 开始引导设置：连接 GitHub、GitLab、Azure DevOps 或 Bitbucket 账号并选择一个或多个仓库，提供安装依赖和运行代码所需的环境变量和密钥；智能体工作时你可以在共享终端会话里观察进度；Cursor 在验证代码并完成一次成功的 Build 后保存环境。之后的云端智能体从活动的 Build 开始，可以运行你的软件来测试改动。把配置提交到 .cursor/environment.json，让整个团队受益

2. 用 Dockerfile 手动设置（高级）：用于安装系统级依赖、使用特定编译器版本、安装调试器或切换基础操作系统镜像；不要 COPY 整个项目（Cursor 管理工作区并检出正确的提交）；直接编辑 .cursor/environment.json 配置运行时设置；对私有包注册表或构建时凭据使用构建密钥。示例 .cursor/environment.json 引用 .cursor/Dockerfile 和安装脚本：

   {
     "build": {
       "dockerfile": "Dockerfile",
       "context": ".."
     },
     "install": "pnpm install && ./custom_script.sh"
   }

两种方式都可以指定安装脚本，Cursor 在创建 Build 时运行它，使依赖在智能体启动前就绪。多仓库环境：智能体需要跨多个仓库工作时，创建环境时选择多个仓库，Cursor 把每个选中的仓库克隆到智能体机器上。环境解析顺序：Cursor 按仓库或仓库组解析环境配置，用第一个匹配：仓库里的 .cursor/environment.json；个人保存的环境；团队保存的环境。

MCP、hooks、产物与共享

• MCP：云端智能体可以使用为你团队配置的 MCP 服务器，在 cursor.com/agents 的 MCP 下拉里添加和管理；支持 HTTP 和 stdio 传输，需要 OAuth 的 MCP 服务器也支持。云端智能体还内置 Cursor Cloud MCP，用于运行诊断（转录、运行事件、环境详情和设置日志）
• Hooks：云端智能体运行仓库里 .cursor/hooks.json 的基于命令的 hooks，Enterprise 上还运行团队 hooks 和企业托管 hooks（见「Hooks」页的云端智能体支持）
• 产物和远程桌面控制：云端智能体产出可合并的 PR，并附带演示改动的产物；产物包括截图、视频和日志，让你准确看到改了什么以及智能体如何验证它的工作。你也可以控制智能体的远程桌面来使用改动后的软件：在完整开发环境里自己测试而不必在本地检出分支，之后把控制权交还给智能体继续工作
• 与团队共享：把智能体的 URL 发给队友，他们可以打开运行记录查看对话、代码改动和智能体产出的产物。智能体对启动它们所在 Cursor 团队的成员可见；Cursor 还会验证每个查看者的仓库访问权限：要打开队友的智能体，你需要在 Integrations 里连接自己的源码托管账号并确保有该仓库的访问权。查看是只读的；要让队友发送后续消息并继续工作，团队管理员可以启用团队后续消息
• 模型：云端智能体使用一组精选的模型，对支持的模型可以选择上下文窗口大小

自托管机器、网络与私有连接、API 和 Webhook 等见官方 Cloud Agent 系列页面。