AI 编程教程中文版
官方教程中文版Cloud Agent 与后台任务

云端 Agent

云端 Agent相关的 Cursor 官方教程中文版。

📖 本篇术语速查表
英文 / 缩写中文一句话解释
云端 Agentcloud agent在云端跑的 Cursor Agent 体系。
按需选用pick按需求选云端的哪部分。
安全优先security-first云端尤其要守网络和权限。

不想读完?把下面这段提示词丢给 AI 帮你跑完——帮你按需求在 Cloud Agent 的各能力里定位该用什么。

你是 Cursor Cloud Agent 导航顾问,帮我按需求在云端 Agent 各能力(运行 / Bugbot / 安全审查 / 自动化 / API)里定位该用什么。

【角色】
你掌握 Cloud Agent 体系各部分的定位,能按需求指路,强调云端的安全边界。

【输入】
- 我的需求(异步跑 / 查 bug / 安全审查 / 自动化 / 集成):___
- 涉及的仓库和数据敏感度:___
- 个人还是团队:___
- 安全要求:___

【工作流程】
1. 把需求归类
2. 指出该用云端的哪部分
3. 提示网络和权限安全
4. 给落地下一步

【通用底线】
- 给的每条结论都要落到具体可照做的步骤或示例,不停留在「建议」「考虑一下」这类空泛表述
- 不确定的能力或配置一律以官方文档为准,标注适用版本,避免照搬过时写法
- 不要替我臆测情况或编造不存在的能力,信息不全先问清,不确定的明确标注需查官方文档,禁止照搬过时写法

本地窗口不能一直开、任务需要跑更久、团队希望在 PR 和 issue 中触发 AI 工作时,用云端 Agent 承接。这一组是 Cursor 的异步执行层——Cloud Agents(原 Background Agents)、Bugbot、Security Review 和远端入口适合把长任务从本机切到云端继续跑。

阅读方式:先看判断和路径,再进入具体章节。Cursor 的资料变化很快,模型、价格、用量和企业策略以官方页面为准。

什么时候切到云端

Cloud Agent 不是本地 Agent 的替代品,而是异步执行层。适合切到云端的任务通常有这些特征:

  • 需要长时间运行。
  • 需要和 PR、issue 或团队 review 流程绑定。
  • 本机不适合一直保持打开。
  • 需要在远端机器池里复现环境。
  • 需要让 Bugbot 或 Security Review 参与合并前检查。

如果任务只是当前文件的小改动,留在编辑器里更直接。如果任务需要自动化触发、团队可见、后台运行或 PR 反馈,再考虑云端。

云端任务 brief

派发云端任务时,至少写清:

  • repo 和 branch。
  • 目标问题。
  • 允许改动范围。
  • 不允许触碰的目录或行为。
  • 需要跑的测试。
  • 完成后如何回到 PR 或 issue。

云端 Agent 跑得更久,也更容易扩大范围。brief 越清楚,结果越可 review。

验收标准

云端任务完成后不要只看 summary。至少检查 diff、logs、测试结果、网络或权限失败、剩余风险。如果接入 self-hosted pool,还要确认机器环境、缓存、secret、网络出口和 repo checkout 行为符合团队要求。

这类检查通过后,云端 Agent 才适合进入团队日常。

官方来源

什么任务值得上云端

不是所有任务都该放云端。值得上云的通常是:跑得久、不需要你盯着、能并行、或不想占本地资源的任务(如大范围扫描、批量审查、定时自动化)。

反过来,需要频繁交互、依赖本地环境、或一次性的小改动,留在本地 Agent 更快更省。先按这条判断,再去看云端各能力怎么配。

本页目录