云端 Agent
云端 Agent相关的 Cursor 官方教程中文版。
本地窗口不能一直开、任务需要跑更久、团队希望在 PR 和 issue 中触发 AI 工作时，用云端 Agent 承接。这一组是 Cursor 的异步执行层——Cloud Agents（原 Background Agents）、Bugbot、Security Review 和远端入口适合把长任务从本机切到云端继续跑。
阅读方式：先看判断和路径，再进入具体章节。Cursor 的资料变化很快，模型、价格、用量和企业策略以官方页面为准。
Cloud Agent 总览
把任务交给云端 Cursor Agent。
Cloud Agent Setup
配置 Cloud Agent 环境。
Cloud Agent Capabilities
理解云端 Agent 能做什么。
My Machines
管理 Cloud Agent 可用机器。
Self-hosted Pool
自托管 Cloud Agent 机器池。
Bugbot
Cursor Bugbot 的用途和边界。
Security Review
Cursor Security Review 功能参考。
Automations
自动化触发 Cloud Agent 任务。
Cloud Agent Best Practices
Cursor 官方 Cloud Agent 使用建议。
Cloud Agent 网络安全
Cloud Agent 网络与安全设置。
Cloud Agent Settings
Cloud Agent 设置项参考。
Cloud Agent API
Cloud Agent API endpoints 参考。
什么时候切到云端
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 才适合进入团队日常。