Cloud Agents

Cloud Agents遵循相同的智能体基础，但并非在您的本地机器上运行，而是运行在云端隔离的 VM 中，并配有完整的开发环境。该开发环境与您笔记本电脑上的设置类似：克隆好的仓库、已安装的依赖项、机密信息、启动命令以及网络访问。

完善的开发环境能让智能体充分掌握您的代码库和组织上下文，从而测试并验证其工作结果。

为什么使用 Cloud Agents？

您可以并行运行任意数量的 agents，且无需让您的本地机器保持联网。

由于每个Cloud Agents都可以访问自己的虚拟机，因此能够构建、测试修改后的软件，并与之交互。它们还可以使用计算机控制桌面和浏览器。Cloud Agents支持 MCP 服务器，因此可以访问数据库、API 和第三方服务等外部工具和数据源。

Cloud Agents也可以在多仓库环境中运行。当任务涉及彼此独立的前端、后端、基础设施或共享库仓库时，可以使用这种环境。智能体可以检查整个工作区，协同进行更改，并在其修改的仓库中发起 PR。

如何访问

你可以在任意工作场景中启动云端代理：

1. Cursor for iOS：通过 Cursor iOS 应用 启动和管理 agents
2. Cursor Web：在任意设备上的 cursor.com/agents 启动和管理 agents
3. Cursor Desktop：在智能体输入框下方的下拉菜单中选择 Cloud
4. Slack：使用 @cursor 命令启动智能体
5. GitHub 或 Bitbucket：在 GitHub 的 PR 或 issue 中，或在 Bitbucket 的 PR 中评论 @cursor 以启动智能体
6. Linear：使用 @cursor 命令启动智能体
7. API：使用 API 启动智能体

在 Slack 中使用 Cursor

详细了解如何设置和使用 Slack 集成，包括触发 agents 和接收通知。

工作原理

代码仓库提供方连接

云端代理会从 GitHub、GitLab、Azure DevOps Services 或 Bitbucket Cloud 克隆您的仓库，并在单独的分支上工作，然后将更改推送回您的仓库，便于交接。

您需要对您的仓库以及任何依赖仓库或子模块拥有读写权限。

环境

agents的能力取决于其运行环境。一个能写代码、却不能运行测试、查询服务或访问 API 的智能体，无法完成整个工作闭环。

不给云端agents设置开发环境，就像不给工程师配电脑一样。这就是为什么环境设置是提升云端agents效能最重要的一步。它让云端agents能够像工程师一样工作：编写代码、测试并验证结果，以及上线软件。

你可以通过智能体引导的设置、已保存的快照，或 .cursor/environment.json 中的 Dockerfile 来配置环境。请参阅 云端代理设置 以快速入门。构建 会在后台准备每个环境，确保 agents 启动时仓库和依赖项已就绪。

云端代理仪表盘会显示智能体使用了哪个环境和构建，以及环境详情和版本历史。在智能体页面上，将鼠标悬停在页面顶部的代码仓库名称上，即可查看该次运行使用的环境。有关配置详情，请参阅 云端代理设置。

运行时和环境控制

Cursor 负责每个 Cloud Agent 的 VM 预配、隔离、快照、启动、产出物和容量管理。您可以添加机密信息、限制出站域名、使用 Tailscale 或类似客户端连接到私有网络，并对受支持的源代码控制路径使用私有网络连接。

有关完整的环境和网络控制项，请参阅 Cloud Agent 安全性和网络。如果您正在权衡是否自托管，请参阅 为什么大多数团队从 Cursor Cloud 开始。

模型

Cloud Agents 使用一组经过精选的模型。你可以为是否支持的模型选择上下文窗口大小。

MCP 支持

云端代理可使用为您的团队配置的 MCP (模型上下文协议) 服务器。您可以通过 cursor.com/agents 中的 MCP 下拉菜单添加和管理 MCP 服务器。

支持 HTTP 和 stdio 两种传输方式。对于需要 OAuth 的 MCP 服务器，也支持 OAuth。设置详情请参阅云端代理能力。

云端代理还内置了用于运行诊断的 Cursor Cloud MCP，其中包括会话记录、运行事件、环境详细信息和设置日志。

钩子支持

云端代理会运行代码仓库中 .cursor/hooks.json 里基于命令的钩子。在企业版方案中，它们还会运行团队钩子和由企业统一管理的钩子。

这样一来，当工作在云端运行时，格式化工具、审计脚本和策略检查也都会生效。支持的钩子包括工具和文件钩子 (preToolUse、beforeShellExecution、afterFileEdit)，以及生命周期钩子 (beforeSubmitPrompt、subagentStart / subagentStop、preCompact、afterAgentResponse / afterAgentThought 和 stop)。

钩子不会在只读环境中的早期探索轮次期间运行；它们会在智能体获得可写环境后开始运行。有些钩子仅限 IDE 使用 (Tab 钩子、workspaceOpen)。来自 ~/.cursor/hooks.json 的用户级钩子也不可用，因为云端 VM 无法访问你的本地主目录。

完整的支持矩阵和详细信息，请参阅钩子：云端代理支持。

产出物和远程桌面控制

云端代理会生成带有产出物、可直接合并的 PR，用于展示其更改。你还可以控制智能体的远程桌面，使用修改后的软件。

• 产出物：代理会生成截图、视频和日志，让你清楚看到具体变更了什么，以及智能体是如何验证其工作的。
• 远程桌面控制：接管 agents 的桌面，无需在本地检出分支，也能在完整的开发环境中亲自测试软件。想让它继续工作时，把控制权交还给智能体即可。

有关产出物、计算机操作和远程桌面控制的详细信息，请参阅 云端代理能力。

与团队共享智能体

将智能体的 URL 发送给队友后，对方就可以打开该次运行，查看对话、代码更改以及智能体生成的产出物。

智能体对其启动时所属的 Cursor 团队成员可见。Cursor 还会验证每位查看者的代码仓库访问权限：要打开队友的智能体，请先在 Integrations 中连接你自己的源代码控制账户，并确保你有权访问该智能体工作所在的代码仓库。仅有团队成员身份并不意味着拥有访问权限。

查看是只读的。若要让队友发送后续消息并继续这项工作，团队管理员可以启用 团队后续。

相关页面

• 进一步了解云端代理能力。
• 进一步了解云端代理设置。
• 进一步了解云端代理构建。
• 进一步了解云端代理安全性。
• 进一步了解OIDC 身份令牌。
• 进一步了解云端代理设置。

计费

Cloud Agents 按所选模型的 API 定价收费。您可以选择上下文窗口大小，较大的上下文窗口可能会增加 token 使用量和成本。首次使用时，系统会要求您设置支出上限。

疑难排查

命名历史

Cloud Agents 之前称为 Background Agents。