雲端 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 更快更省。先按這條判斷,再去看雲端各能力怎麼配。