Vercel Sandbox 支持 Cursor Cloud Agents：用 Firecracker 微虚拟机为 AI 代理提供隔离执行环境

Vercel 官方博客发表文章，由 Vercel 技术团队成员 Allen Zhou 撰写，宣布 Cursor Cloud Agents 现在可以在 Vercel Sandbox 中运行，而不是使用 Cursor 托管的机器。文章指出，Cursor 管理代理的 harness 和推理循环，其 Self-Hosted Machines API 允许用户提供执行环境，代理在其中克隆仓库、编辑文件、运行命令和测试。Vercel Sandbox 为每个代理请求提供一个隔离的 Firecracker 微虚拟机作为执行环境，Vercel Functions 和 Vercel Workflow 构成持久化控制平面，负责领取排队的代理请求、 provisioning workers、监控会话和自动清理。本文基于 Vercel 官方文章，解读这一架构的设计理念、核心组件和实际价值。

背景：AI 代理的执行环境挑战

Cursor Cloud Agents 简介

Cursor 是一款基于 AI 的代码编辑器，其 Cloud Agents 功能允许 AI 代理在云端自主执行编程任务：

• 克隆代码仓库
• 编辑和修改文件
• 运行命令和测试
• 提交 Pull Request
• 自主完成多步骤编程任务

Cursor 管理代理的 harness（执行框架）和推理循环（inference loop），即决定代理如何思考、如何调用工具、如何迭代完成任务。

Self-Hosted Machines API

Cursor 推出了 Self-Hosted Machines API，允许企业用户提供自己的执行环境：

• 不再强制使用 Cursor 托管的机器
• 企业可以控制代理运行的基础设施
• 满足数据安全和合规要求
• 可以自定义执行环境的配置和工具
• 需要 Cursor Enterprise 计划

为什么需要自定义执行环境

使用 Cursor 托管机器存在一些限制：

1. 数据安全：代码和数据需要离开企业的基础设施
2. 合规要求：某些行业要求代码和数据在特定环境中处理
3. 环境定制：企业可能需要特定的工具链、依赖和配置
4. 成本控制：大规模使用时，自定义基础设施可能更经济
5. 网络访问：代理可能需要访问企业内部的服务和资源

Vercel Sandbox 架构

核心组件

Vercel Sandbox 为 Cursor Cloud Agents 提供的执行环境包含以下核心组件：

1. Firecracker 微虚拟机

每个代理请求都获得一个隔离的 Firecracker 微虚拟机：

• Firecracker：AWS 开源的轻量级虚拟机监视器，基于 KVM
• 微虚拟机：启动速度快（毫秒级），资源开销小
• 隔离性：每个代理请求一个独立的 VM，互不干扰
• 安全性：硬件级隔离，比容器隔离更强
• 一次性使用：每个代理请求使用全新的 VM，用完即销毁

2. Vercel Functions 控制平面

Vercel Functions 构成控制平面的核心：

• 请求领取：从 Cursor 的队列中领取排队的代理请求
• Worker 调度：provisioning 和管理执行 worker
• 会话管理：监控代理会话的状态和进度
• 自动清理：会话结束后自动清理资源
• 弹性伸缩：根据请求量自动伸缩 worker 数量

3. Vercel Workflow 持久化

Vercel Workflow 提供持久化的工作流编排：

• 持久化状态：工作流状态持久化存储，不怕中断
• 重试机制：worker 或会话失败时自动重试
• 长时间运行：支持长时间运行的代理任务
• 步骤编排：复杂的多步骤任务编排
• 错误处理：完善的错误处理和恢复机制

架构优势

这一架构带来以下优势：

1. 按需伸缩的 Worker 池（Scale-to-Zero）

• 不需要长期运行的虚拟机
• 没有请求时 worker 数量缩减到零
• 有请求时快速启动新的 worker
• 显著降低空闲资源成本
• 自动应对流量峰值

2. 每个请求的专用隔离沙箱

• 每个代理请求获得独立的 Firecracker VM
• 代理之间完全隔离，互不影响
• 一个代理的错误不会影响其他代理
• 安全性更高，防止代理间的攻击和干扰
• 用完即销毁，不留残留状态

3. 持久化重试

• worker 或会话失败时自动重试
• 工作流状态持久化，不怕中断
• 网络故障或基础设施问题不会导致任务丢失
• 重试时从断点继续，不需要从头开始
• 提高任务完成率和可靠性

4. 短期用户范围凭证

• 每个沙箱内使用短期的、用户范围的凭证
• 凭证有效期短，降低泄露风险
• 凭证范围限定到特定用户，最小权限原则
• 会话结束后凭证自动失效
• 更好的安全性和审计能力

部署和使用

参考实现

Vercel 提供了参考实现，可以部署到自己的 Vercel 账户：

• 按照分步指南部署
• 配置 Cursor Self-Hosted Machines API
• 连接 Vercel Sandbox 作为执行环境
• 自定义沙箱配置和工具
• 监控和调试代理执行

配置选项

部署时可以配置以下选项：

• 沙箱规格：CPU、内存、磁盘大小
• 超时设置：代理会话的最大运行时间
• 工具预装：沙箱中预装的工具和依赖
• 网络策略：沙箱的网络访问控制
• 凭证管理：如何管理和注入凭证
• 日志和监控：代理执行的日志收集和监控

与 Cursor 的集成

集成流程：

1. 在 Cursor Enterprise 计划中启用 Self-Hosted Machines
2. 配置 Vercel Sandbox 作为执行环境端点
3. Cursor Cloud Agents 发起请求时，调用 Vercel 的端点
4. Vercel Functions 领取请求，provisioning Firecracker VM
5. 代理在 VM 中执行任务（克隆仓库、编辑文件、运行命令）
6. Vercel Workflow 监控会话进度，处理失败和重试
7. 任务完成后，自动清理 VM 和资源

实际应用场景

场景 1：企业代码自动化

企业使用 Cursor Cloud Agents 自动化代码任务：

• 自动修复代码审查中的问题
• 自动更新依赖和安全补丁
• 自动重构代码
• 自动生成测试
• 所有操作在企业控制的 Vercel Sandbox 中执行，代码不离开企业基础设施

场景 2：合规敏感行业

金融、医疗等合规敏感行业：

• 代码和数据必须在特定环境中处理
• 需要完整的审计日志
• 需要严格的访问控制
• Vercel Sandbox 提供隔离的执行环境和短期凭证
• 满足合规要求的同时享受 AI 代理的效率提升

场景 3：大规模 CI/CD 集成

将 AI 代理集成到 CI/CD 流程中：

• PR 自动审查和修复
• 自动测试生成和执行
• 自动文档更新
• 按需伸缩的 worker 池应对 CI/CD 峰值
• 每个任务独立沙箱，互不干扰

场景 4：多租户 SaaS 平台

SaaS 平台为多个客户提供 AI 代理服务：

• 每个客户的代理在独立的沙箱中执行
• 客户间完全隔离
• 短期用户范围凭证确保安全
• 按需伸缩降低成本
• 统一的控制平面简化管理

与其他方案的对比

vs Cursor 托管机器

vs 自托管虚拟机

vs 容器方案

总结

Vercel Sandbox 支持 Cursor Cloud Agents 是 AI 代理执行环境的重要创新。Cursor 管理代理的 harness 和推理循环，通过 Self-Hosted Machines API 允许用户提供执行环境，而 Vercel Sandbox 为每个代理请求提供隔离的 Firecracker 微虚拟机，Vercel Functions 和 Vercel Workflow 构成持久化控制平面，负责请求领取、worker 调度、会话监控和自动清理。这一架构带来四大优势：按需伸缩到零的 worker 池（不需要长期运行的虚拟机，显著降低成本）、每个请求的专用隔离沙箱（Firecracker 微 VM 提供硬件级隔离，代理间互不干扰）、持久化重试（worker 或会话失败时自动重试，工作流状态持久化不怕中断）、短期用户范围凭证（降低泄露风险，最小权限原则）。部署方式简单，Vercel 提供参考实现和分步指南，可以配置沙箱规格、超时设置、工具预装、网络策略等选项。实际应用场景包括企业代码自动化、合规敏感行业、大规模 CI/CD 集成、多租户 SaaS 平台等。与 Cursor 托管机器相比，Vercel Sandbox 提供更强的基础设施控制和数据安全；与自托管 VM 相比，管理开销更低、弹性伸缩更好；与容器方案相比，隔离级别更高、安全性更强。随着 AI 代理在软件开发中的应用越来越广泛，安全、隔离、弹性的执行环境将成为关键基础设施，Vercel Sandbox 与 Cursor Cloud Agents 的集成为这一需求提供了优雅的解决方案。

来源：https://vercel.com/changelog/run-cursor-cloud-agents-vercel-sandbox