跳至主要内容

Agent Mode

代理模式

自主AI程式設計代理(Agent),可藉助完整工具集獨立探索、規劃並執行復雜的程式碼庫變更

Agent是Cursor中預設且自主性最高的模式,旨在以最少指導完成複雜編碼任務。該模式啟用全部工具,可自主探索程式碼庫、閱讀文件、瀏覽網頁、編輯檔案以及執行終端命令,從而高效完成任務。


Agent的核心能力

自主操作
獨立探索程式碼庫,識別相關檔案並執行必要修改

完整工具許可權
使用全部可用工具進行檔案搜尋、編輯、建立及執行終端命令

上下文理解
全面構建專案結構和依賴關係的認知模型

多步驟規劃
將複雜任務拆解為可執行步驟並按順序實施

建議閱讀聊天功能概述深入瞭解Cursor的模式運作機制。


Agent的工作流程

與人類工作方式相似,Agent模式遵循系統化任務處理流程:

  1. 理解需求
    分析使用者需求及程式碼庫上下文,全面理解任務目標與要求
  2. 探索程式碼庫
    檢索程式碼庫、文件及網路資源,定位相關檔案並理解當前實現
  3. 規劃變更
    基於分析結果將任務拆解為子步驟,結合上下文制定變更計劃
  4. 執行變更
    根據規劃在程式碼庫中實施修改,可能建議新增庫、需執行的終端命令或Cursor外操作步驟
  5. 驗證結果
    透過應用變更確認修改正確性。若發現異常或語法錯誤(語言支援時),將嘗試修復
  6. 任務完成
    確認無誤後交還控制權並彙總變更內容

Agent模式在執行變更前建立檢查點(checkpoint),支援按需回滾操作。
瞭解更多檢查點機制


典型用例

為獲得最佳效果,請明確任務目標但無需指定實現方式:

"为我的React应用添加深色模式切换功能"
Agent模式將:

  1. 識別應用樣式方案
  2. 新增主題狀態管理
  3. 建立切換元件
  4. 更新相關元件樣式
  5. 按需新增狀態持久化

"优化API调用,实现缓存机制并减少冗余请求"
Agent模式將:

  1. 定位所有API呼叫點
  2. 實施合適的快取策略
  3. 新增快取失效邏輯
  4. 更新元件使用快取資料

配置選項

  • 模型預選:為Agent模式預設模型
  • 快捷鍵設定:配置Agent模式快捷鍵
  • 工具開關:啟用/禁用特定工具
  • 自動執行與錯誤修復:啟用自動執行及錯誤修復功能(詳見工具設定

啟用自動執行的Agent模式時,請務必在確認重大修改前仔細審查變更方案。