介紹 Debug Mode:具備執行期日誌的 Agent
程式開發 Agent 在很多事情上都很擅長,但有些錯誤卻總是難倒它們。這就是我們推出 Debug Mode(偵錯模式)的原因:一個全新的 Agent 迴圈,圍繞執行期資訊與人工驗證而設計。
為了打造這個功能,我們研究了團隊中最擅長偵錯的工程師的實務做法,並將他們的工作流程融入一種 Agent 模式,為其配備工具,在程式碼中加入執行期日誌、利用提示產生多個「到底哪裡出問題了」的假設,並具備回呼你來重現問題並驗證修復結果的能力。
最終,我們得到的是一個互動式流程,可以可靠地修復先前即使是最聰明的模型單獨運作也無法處理,或需要開發者花費大量時間才能解決的錯誤。
描述這個錯誤
首先,從下拉選單中選擇 Debug Mode,然後盡可能詳細地描述這個錯誤。
代理不會立刻嘗試產生修正方案,而是先閱讀你的程式碼基底,並針對可能出錯的地方產生多個假設。其中有些會是你自己也會想到的點子,但也有許多是你原本不一定會考慮到的做法。
接著,代理會在你的程式碼中加入用來測試這些假設的日誌(logging)語句。這讓代理能在錯誤實際發生時,接收並分析實際情況的具體資料。
重現錯誤
接下來,回到你的應用程式,在代理收集執行時期日誌的同時重現該錯誤。
當錯誤發生時,代理可以精準掌握你的程式碼中發生了什麼:變數狀態、執行路徑、時間資訊。有了這些資料,它可以鎖定問題根源並產生對應的修正方案。通常只需要精準修改兩三行程式碼,而不是你在一般與代理互動時可能會收到的上百行試探性程式碼。
驗證修復結果
此時,Debug Mode 會要求你在已套用建議修復的情況下,再重現一次這個錯誤。若錯誤已經消失,你就可以標記為已修復,接著 Agent 會移除所有插樁程式碼,只留下乾淨、最小化且可直接發布的變更。
這種「人類在環中」的驗證步驟非常關鍵。有時錯誤很明顯,但有時會落在灰色地帶——修復在技術上看似可行,卻不一定「感覺」正確。Agent 無法自己做出這種判斷。若你認為錯誤尚未修復,Agent 會加入更多記錄,你再重現一次,然後它會持續調整作法,直到問題真正被解決。
我們認為,這種緊密的來回合作,是 AI(人工智慧)輔助寫程式最佳的運作方式之一。Agent 負責繁瑣的工作,而你只需快速做出需要人類判斷的決策。藉由 Debug Mode,以前那些棘手、難以處理的錯誤,現在都能被穩定地修好。
閱讀 Debug Mode 文件。進一步了解 Cursor 2.2 中所有全新功能。