遵循以下建議，以獲得更可靠的 Cloud Agent 運行效果。
先完成環境設置¶
請使用雲端代理設置，確保 Cursor 的環境已正確配置。和人類開發者一樣，如果環境設置得當，Cursor 往往能表現得更好。
確保 Agent 能訪問所需資源¶
在運行 Cloud Agent 之前，請確認已滿足以下前提條件：
- Secrets：通過控制檯中的 Secrets 選項卡，確保 Agent 能訪問所需的機密信息 (API key、數據庫憑證等) 。對於雲端角色，優先使用 OIDC token，而非長期有效的訪問密鑰。
- 出口訪問控制 (Egress controls) ：如果你啓用了網絡訪問限制，確保本地開發所需的所有 URL 都已加入白名單。
- 本地可測試性：你的代碼倉庫應配置爲能夠在本地良好運行，且不依賴虛擬機 (VM) 無法訪問的外部服務。如果對人類開發者來說本地難以測試，對 Agent 來說也會同樣困難。
使用 skills 和 agents.md 來配置你的 agent¶
如果 cloud agent 在測試其更改時遇到困難，我們建議使用 skills 和 agents.md 來配置你的 agent。
可以把 agent 想象成一個聰明但上下文信息有限的人類開發者。要讓它正確完成任務，最好的方式是提供足夠的上下文，讓它明白該做什麼。
例如，在 Cursor，我們的 agents.md 會列出在 mono-repo 中運行和調試最常用微服務的技巧。我們還有很多關於如何測試和調試關鍵服務的 skills，併爲每個 skill 提供了何時使用的清晰說明。
這些 skills 包含深入的細節，例如如何調試某個特定微服務，或者在測試需要時如何設置第三方依賴。
使用規則落實規範¶
Cloud Agents 可以在三個層級讀取並遵循規則：
- 用戶規則：在 Cursor 設置中設置，適用於你在所有倉庫中的會話。最適合僅對你個人生效的規則。
- 團隊規則：在規則、命令、鉤子儀表盤中設置，適用於所有團隊成員在所有倉庫中的使用。最適合組織範圍內的規範。
- 倉庫規則：提交到倉庫中的
.cursor/rules/*.mdc文件，適用於使用該倉庫的所有智能體。最適合倉庫/項目特定的規範。
爲 Agent 提供所需的工具¶
我們經常發現，Agent 的能力會受限於其可用的工具。我們建議使用 MCP 並創建自定義工具，讓 Agent 能訪問與人類開發者相同的系統。
根據 agent 調整工具¶
爲 agent 創建其擅長使用的工具非常重要。我們建議先創建工具，再根據觀察 agent 實際使用情況進行迭代改進。
例如，在 Cursor，我們爲模型創建了一個自定義命令行界面（CLI）工具，用於在我們的代碼庫中運行微服務。我們發現，當運行自定義開發命令（例如來自 package.json 文件的命令）時，一些模型經常會漏掉參數，或者 agent 會被嘈雜的構建日誌分散注意力，而這些日誌是人類開發者通常會忽略的。
