云端 Agent
云端 Agent相关的 Cursor 官方教程中文版。
📖 本篇术语速查表
| 英文 / 缩写 | 中文 | 一句话解释 |
|---|---|---|
| 云端 Agent | cloud 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 总览
把任务交给云端 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 才适合进入团队日常。
官方来源
什么任务值得上云端
不是所有任务都该放云端。值得上云的通常是:跑得久、不需要你盯着、能并行、或不想占本地资源的任务(如大范围扫描、批量审查、定时自动化)。
反过来,需要频繁交互、依赖本地环境、或一次性的小改动,留在本地 Agent 更快更省。先按这条判断,再去看云端各能力怎么配。