---
title: "云端 Agent"
description: "云端 Agent相关的 Cursor 官方教程中文版。"
verifiedAt: "2026-05-09"
---

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

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

<Cards>
  <Card title="Cloud Agent 总览" description="把任务交给云端 Cursor Agent。" href="/docs/cursor/official/04-cloud-agents/50-cloud-agent" />
  <Card title="Cloud Agent Setup" description="配置 Cloud Agent 环境。" href="/docs/cursor/official/04-cloud-agents/51-setup" />
  <Card title="Cloud Agent Capabilities" description="理解云端 Agent 能做什么。" href="/docs/cursor/official/04-cloud-agents/52-capabilities" />
  <Card title="My Machines" description="管理 Cloud Agent 可用机器。" href="/docs/cursor/official/04-cloud-agents/53-my-machines" />
  <Card title="Self-hosted Pool" description="自托管 Cloud Agent 机器池。" href="/docs/cursor/official/04-cloud-agents/54-self-hosted-pool" />
  <Card title="Bugbot" description="Cursor Bugbot 的用途和边界。" href="/docs/cursor/official/04-cloud-agents/55-bugbot" />
  <Card title="Security Review" description="Cursor Security Review 功能参考。" href="/docs/cursor/official/04-cloud-agents/56-security-review" />
  <Card title="Automations" description="自动化触发 Cloud Agent 任务。" href="/docs/cursor/official/04-cloud-agents/57-automations" />
  <Card title="Cloud Agent Best Practices" description="Cursor 官方 Cloud Agent 使用建议。" href="/docs/cursor/official/04-cloud-agents/58-best-practices" />
  <Card title="Cloud Agent 网络安全" description="Cloud Agent 网络与安全设置。" href="/docs/cursor/official/04-cloud-agents/59-security-network" />
  <Card title="Cloud Agent Settings" description="Cloud Agent 设置项参考。" href="/docs/cursor/official/04-cloud-agents/60-settings" />
  <Card title="Cloud Agent API" description="Cloud Agent API endpoints 参考。" href="/docs/cursor/official/04-cloud-agents/61-api-endpoints" />
</Cards>

## 什么时候切到云端

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 才适合进入团队日常。

## 官方来源

- [Cursor Docs](https://cursor.com/docs)
- [Cursor llms.txt](https://cursor.com/llms.txt)
- [Cursor Help Center](https://cursor.com/help)
