Cloud Agents遵循相同的智能體基礎，但並非在您的本地機器上運行，而是運行在雲端隔離的 VM 中，並配有完整的開發環境。該開發環境與您筆記本電腦上的設置類似：克隆好的倉庫、已安裝的依賴項、機密信息、啓動命令以及網絡訪問。
完善的開發環境能讓智能體充分掌握您的代碼庫和組織上下文，從而測試並驗證其工作結果。
爲什麼使用 雲端代理？¶
您可以並行運行任意數量的 agents，且無需讓您的本地機器保持聯網。
由於每個雲端代理都可以訪問自己的虛擬機，因此能夠構建、測試修改後的軟件，並與之交互。它們還可以使用計算機控制桌面和瀏覽器。雲端代理支持 MCP 服務器，因此可以訪問數據庫、API 和第三方服務等外部工具和數據源。
雲端代理也可以在多倉庫環境中運行。當任務涉及彼此獨立的前端、後端、基礎設施或共享庫倉庫時，可以使用這種環境。智能體可以檢查整個工作區，協同進行更改，並在其修改的倉庫中發起 PR。多倉庫環境暫不支持長時間運行。
如何訪問¶
在任何人可以從代碼倉庫啓動雲端代理之前，Cursor 賬戶管理員都需要先爲該賬戶連接源代碼控制。設置 GitHub (Cloud and Enterprise Server)、GitLab (Cloud and Self-Hosted)、Bitbucket Cloud 或 Azure DevOps。
你可以在任意工作場景中啓動雲端代理：
- Cursor for iOS：通過 Cursor iOS 應用 啓動和管理 agents
- Cursor Web：在任意設備上的 cursor.com/agents 啓動和管理 agents
- Cursor Desktop：在智能體輸入框下方的下拉菜單中選擇 Cloud
- Slack：使用 @cursor 命令啓動智能體
- GitHub 或 Bitbucket：在 GitHub 的 PR 或 issue 中，或在 Bitbucket 的 PR 中評論
@cursor以啓動智能體 - Linear：使用 @cursor 命令啓動智能體
- API：使用 API 啓動智能體
在 Android 上，請在 Chrome 中打開 cursor.com/agents
並點按 Install App，將其安裝爲漸進式 Web 應用 (PWA)。有關原生 iPhone 和 iPad 應用及更多移動端
選項，請參閱 Cursor for iOS。
在 Slack 中使用 Cursor¶
詳細瞭解如何設置和使用 Slack 集成，包括觸發 agents 和接收通知。
工作原理¶
代碼倉庫提供方連接¶
雲端代理會從 GitHub、GitLab、Azure DevOps Services 或 Bitbucket Cloud 克隆您的倉庫，並在單獨的分支上工作，然後將更改推送回您的倉庫，便於交接。
您需要對您的倉庫以及任何依賴倉庫或子模塊擁有讀寫權限。
環境¶
agents的能力取決於其運行環境。一個能寫代碼、卻不能運行測試、查詢服務或訪問 API 的智能體，無法完成整個工作閉環。
不給雲端agents設置開發環境，就像不給工程師配電腦一樣。這就是爲什麼環境設置是提升雲端agents效能最重要的一步。它讓雲端agents能夠像工程師一樣工作：編寫代碼、測試並驗證結果，以及上線軟件。
你可以通過智能體引導的設置、已保存的快照，或 .cursor/environment.json 中的 Dockerfile 來配置環境。請參閱 雲端代理設置 以快速入門。構建 會在後臺準備每個環境，確保 agents 啓動時倉庫和依賴項已就緒。
雲端代理儀表盤會顯示智能體使用了哪個環境和構建，以及環境詳情和版本歷史。在智能體頁面上，將鼠標懸停在頁面頂部的代碼倉庫名稱上，即可查看該次運行使用的環境。有關配置詳情，請參閱 雲端代理設置。
運行時和環境控制¶
Cursor 負責每個 Cloud Agent 的 VM 預配、隔離、快照、啓動、產出物和容量管理。您可以添加機密信息、限制出站域名、使用 Tailscale 或類似客戶端連接到私有網絡，並對受支持的源代碼控制路徑使用私有網絡連接。
有關完整的環境和網絡控制項，請參閱 Cloud Agent 安全性和網絡。如果您正在權衡是否自託管，請參閱 爲什麼大多數團隊從 Cursor Cloud 開始。
模型¶
Cloud Agents 使用一組經過精選的模型。你可以爲是否支持的模型選擇上下文窗口大小。
MCP 支持¶
雲端代理可使用爲您的團隊配置的 MCP (模型上下文協議) 服務器。您可以通過 cursor.com/agents 中的 MCP 下拉菜單添加和管理 MCP 服務器。
支持 HTTP 和 stdio 兩種傳輸方式。對於需要 OAuth 的 MCP 服務器，也支持 OAuth。設置詳情請參閱雲端代理能力。
雲端代理還內置了用於運行診斷的 Cursor Cloud MCP，其中包括會話記錄、運行事件、環境詳細信息和設置日誌。
鉤子支持¶
雲端代理會運行代碼倉庫中 .cursor/hooks.json 裏基於命令的鉤子。在企業版方案中，它們還會運行團隊鉤子和由企業統一管理的鉤子。
這樣一來，當工作在雲端運行時，格式化工具、審計腳本和策略檢查也都會生效。支持的鉤子包括工具和文件鉤子 (preToolUse、beforeShellExecution、afterFileEdit)，以及生命週期鉤子 (beforeSubmitPrompt、subagentStart / subagentStop、preCompact、afterAgentResponse / afterAgentThought 和 stop)。
鉤子不會在只讀環境中的早期探索輪次期間運行；它們會在智能體獲得可寫環境後開始運行。有些鉤子僅限 IDE 使用 (Tab 鉤子、workspaceOpen)。來自 ~/.cursor/hooks.json 的用戶級鉤子也不可用，因爲雲端 VM 無法訪問你的本地主目錄。
完整的支持矩陣和詳細信息，請參閱鉤子：雲端代理支持。
產出物和遠程桌面控制¶
雲端代理會生成帶有產出物、可直接合並的 PR，用於展示其更改。你還可以控制智能體的遠程桌面，使用修改後的軟件。
- 產出物：代理會生成截圖、視頻和日誌，讓你清楚看到具體變更了什麼，以及智能體是如何驗證其工作的。
- 遠程桌面控制：接管 agents 的桌面，無需在本地檢出分支，也能在完整的開發環境中親自測試軟件。想讓它繼續工作時，把控制權交還給智能體即可。
有關產出物、計算機操作和遠程桌面控制的詳細信息，請參閱 雲端代理能力。
與團隊共享智能體¶
將智能體的 URL 發送給隊友後，對方就可以打開該次運行，查看對話、代碼更改以及智能體生成的產出物。
智能體對其啓動時所屬的 Cursor 團隊成員可見。Cursor 還會驗證每位查看者的代碼倉庫訪問權限：要打開隊友的智能體，請先在 Integrations 中連接你自己的源代碼控制賬戶，並確保你有權訪問該智能體工作所在的代碼倉庫。僅有團隊成員身份並不意味着擁有訪問權限。
查看是隻讀的。若要讓隊友發送後續消息並繼續這項工作，團隊管理員可以啓用 團隊後續。
相關頁面¶
計費¶
Cloud Agents 按所選模型的 API 定價收費。您可以選擇上下文窗口大小，較大的上下文窗口可能會增加 token 使用量和成本。首次使用時，系統會要求您設置支出上限。
疑難排查¶
agents運行無法啓動¶
- 確保你已登錄，並且已連接你的 GitHub、GitLab、Azure DevOps 或 Bitbucket 賬戶。
- 檢查你是否具有所需的代碼倉庫權限。
- 你需要使用付費 Cursor 方案。
我的機密信息在雲端代理中不可用¶
- 確保你已在 cursor.com/dashboard/cloud-agents 中添加機密信息
- 機密信息的作用域限定爲工作區/團隊；請確保你使用的是正確的賬戶
- 添加新的機密信息後，嘗試重新啓動雲端代理
找不到機密信息標籤頁¶
- 如果你看不到它，請確保你具有所需的權限
快照會包含 .env.local 文件嗎？¶
快照會保存你的基礎環境配置 (已安裝的軟件包、系統依賴項等) 。
如果你在創建快照時包含了 .env.local 文件，它們也會被保存。不過，使用 Cursor 設置中的機密信息標籤頁
是管理環境變量的推薦方式。
團隊成員無法打開我的智能體¶
- 該團隊成員必須與你屬於同一個 Cursor 團隊。
- 他們需要在 Integrations 下連接自己的源代碼控制賬戶，並且有權訪問該智能體工作所在的代碼倉庫。
- 詳情請參閱 Share agents with your team。
Slack 集成無法正常工作¶
驗證你的工作區管理員已安裝 Cursor Slack 應用，並且
你擁有相應的權限。
命名歷史¶
Cloud Agents 之前稱爲 Background Agents。
