智能體是 Cursor 的助手，可自主完成複雜的編程任務、運行終端命令並編輯代碼。通過 Cmd+I 可在側邊欄中打開。
詳細瞭解智能體的工作方式，助您更高效地構建。
智能體的工作原理¶
智能體由三個組成部分構成：
- 說明：引導智能體行爲的系統提示詞和規則
- 工具：文件編輯、代碼庫搜索、終端執行等
- 模型：你爲任務選擇的智能體模型
Cursor 的智能體會協調我們支持的每個模型中的這些組成部分，並針對每個前沿模型專門優化說明和工具。隨着新模型不斷髮布，你可以專注於構建軟件，由 Cursor 負責模型專屬優化。
工具¶
工具是智能體的基本組成部分。它們可用於搜索您的代碼庫和網頁以查找相關信息、編輯文件、運行終端命令等。
要了解工具調用的底層原理，請參閱我們的工具調用基礎。
智能體在執行任務期間可進行的工具調用次數不受限制。
搜索文件和文件夾¶
按名稱搜索文件、讀取目錄結構，以及在文件中查找精確的關鍵字或模式。
網頁端¶
生成搜索查詢並執行網頁搜索。
獲取規則¶
根據類型和描述檢索特定規則。
讀取文件¶
智能讀取文件內容。還支持圖像文件 (.png、.jpg、.gif、.webp、.svg) ，並將其納入對話上下文，供具備視覺能力的模型分析。
編輯文件¶
建議修改文件並自動應用。
運行 Shell 命令¶
執行終端命令並監控輸出。默認情況下，Cursor 使用第一個可用的終端配置文件。
要設置首選終端配置文件：
- 打開命令面板 (
Cmd/Ctrl+Shift+P) - 搜索“Terminal: Select Default Profile”
- 選擇所需的配置文件
瀏覽器¶
控制瀏覽器以獲取屏幕截圖、測試應用並驗證視覺更改。智能體可以打開頁面、與元素交互，並捕獲當前狀態供分析。有關詳細信息，請參閱瀏覽器文檔。
圖像生成¶
根據文本描述或參考圖像生成圖像。適用於創建 UI 模型、產品資源及架構圖可視化內容。默認情況下，圖像會保存到您項目的 assets/ 文件夾，並內嵌顯示在對話中。
提問¶
在執行任務期間提出澄清性問題。等待您回覆時，智能體會繼續讀取文件、進行編輯或運行命令。收到回答後會立即將其納入處理。
檢查點¶
檢查點會在智能體會話期間保存代碼庫的快照。智能體會在進行重大更改前自動創建檢查點，記錄所有已修改文件的狀態。
如果智能體走偏了，請點擊聊天時間線中的任意檢查點，預覽當時的文件，然後還原，將所有文件恢復到該狀態。您也可以通過先前請求中的 Restore Checkpoint 按鈕，或懸停在消息上時出現的 + 按鈕進行還原。還原檢查點只會還原文件；不會從對話中刪除消息。
檢查點適用於探索性工作、複雜重構，以及需要安全回滾點的迭代開發。
檢查點存儲在本地，與 Git 相互獨立。僅使用它們撤銷智能體所做的更改；永久版本控制請使用 Git。
排隊消息¶
智能體工作時，你可以通過兩種方式與它溝通。將消息加入隊列後，它會等待當前任務完成。立即發送後續消息會在智能體下一次工具調用時引導當前輪次。
使用隊列¶
- 智能體工作時，輸入下一條指令
- 按 Enter 將其加入隊列
- 消息會按順序顯示在當前任務下方
- 根據需要拖動以調整隊列中消息的順序
- 智能體完成當前任務後，會依次處理這些消息
鍵盤快捷鍵¶
智能體工作時：
- 按 Enter 將消息加入隊列 (智能體完成當前任務後發送)
- 按 Cmd+Enter 可立即發送，跳過隊列
即時發送消息¶
使用 Cmd+Enter 立即發送時，你的消息會追加到聊天中最新的一條用戶消息，並立即處理，無需排隊等待。
- 你的消息會附加到工具結果並立即發送
- 讓緊急追問得到更及時的響應
- 需要中斷或調整智能體當前的工作方向時，請使用此功能
引導正在運行的智能體¶
你可以在智能體工作時發送後續消息來引導它，無需中斷其工作。輸入後續消息並點擊 立即發送，或連按兩次 Enter。消息會在智能體下一次工具調用時送達，而不會在執行操作時中斷工作，從而保留進行中的工作並讓智能體專注於任務。
此功能現已在 cursor.com/agents 上可用，並將逐步推廣至代理窗口。如需在當前輪次結束後再處理消息，請按 Tab 將其排隊。
在 命令行界面 中，智能體工作時按 Enter 會在安全邊界引導當前運行；再按一次 Enter 會中斷當前輪次。
使用 /goal 設置目標¶
智能體會將每條消息視爲一項新任務。使用 /goal 爲智能體設定一個長期目標，智能體會持續推進，直至目標完全完成：
/goal fix all flaky tests and make CI green
在命令行界面中，Ctrl+C 可暫停目標。當你希望智能體在推進目標時遵循既定流程，可將目標與自定義模式搭配使用，或與內置的/loop技能搭配使用，以便在推進目標期間進行定期檢查。
/goal 正在逐步推出。如果你沒有看到它，請在新對話中嘗試。
