共用方式為


使用 Copilot 代理程式模式

在 Visual Studio 中使用 GitHub Copilot 的代理程式模式,您可以使用自然語言來指定高階工作。 AI 會建立計劃、進行程式碼編輯、執行終端機命令、叫用工具,以及跨程式代碼基底套用變更。 它會監視結果,例如建置結果、單元測試失敗或工具輸出,並視需要反覆執行。

不同於 詢問模式代理程式模式 不會在單一回應之後停止。 它會繼續執行和精簡步驟,直到達到提示中的目標或需要額外的輸入為止。

先決條件

Visual Studio 2022 17.14 版 或更新版本。

使用代理程式模式

在代理程式模式中,Copilot 會自主運作,並判斷提示的相關內容。

請遵循下列步驟來開始使用:

  1. 開啟 [Copilot Chat] 視窗,選取 [ 詢問 ] 以展開模式下拉式清單,然後選取 [ 代理程式]。

    顯示 Copilot 代理程式模式選取器的螢幕快照。

  2. 輸入您的提示,然後選取 [ 傳送 ] 或按 Enter 來提交。 您可以指定高階需求,而且不需要指定要處理哪些檔案。

  3. 代理程式模式可能會叫用多個工具來完成不同的工作。 您可以選擇性地選取 [工具] 圖示,以設定哪些其他工具可用來回應您的要求。

    顯示代理程式模式所使用其他工具的螢幕快照。

  4. 在執行終端機命令或使用非內建工具之前,Copilot 會要求確認。

    顯示代理程式命令核准的螢幕快照。

  5. Copilot 會自動偵測程式代碼編輯或終端機命令中的問題,然後採取其他動作來解決它們。 此程式會重複執行,直到問題解決為止。

  6. 當 Copilot 處理您的要求時,它會直接在編輯器中串流建議的程式碼編輯。 檢閱建議的編輯,並在聊天視窗中的Total Changes欄位中保留或捨棄所有建議變更,或檢閱個別檔案差異,然後選擇性地加以套用。

    顯示建議編輯清單的螢幕快照。

  7. 如果您想要檢閱代理程式所做的個別程式代碼變更,您可以檢閱每個步驟所做的特定變更,或檢閱上次保留或復原變更的累積變更。

    顯示使用 Copilot 代理程式存取個別編輯差異的螢幕快照。

    顯示使用 Copilot 代理程式存取累計編輯差異的螢幕快照。

  8. 繼續逐一查看程式代碼變更,以精簡編輯或實作其他功能。

代理模式工具

代理程式模式可以使用下列工具:

您可以檢視及管理可用於回應要求的工具。 選取聊天視窗中的 [工具 ] 圖示,以檢視和管理代理程式模式中可用的工具。

顯示 Copilot 代理程式工具選取器的螢幕快照。

根據工具的結果,Copilot 可能會叫用其他工具來完成整體要求。 例如,如果程式代碼編輯導致檔案中的語法錯誤,Copilot 可能會探索另一種方法,並建議不同的程式碼變更。

執行 MCP 伺服器新增的其他工具不會自動啟用,預設會取消核取它們,而且必須檢查才能啟用。

管理工具核准流程

叫用工具時,Copilot 會要求確認以執行此工具。 這是因為工具可能會在本機計算機上執行,並執行修改檔案或數據的動作。

顯示工具確認要求的螢幕快照。

在聊天視窗中,在工具調用之後,使用 [允許 ] 下拉式清單選項,自動確認目前會話、解決方案或所有未來調用的特定工具。

您可以在 工具>選項>GitHub>Copilot>工具 中重設工具確認選擇。

顯示工具確認選項的螢幕快照。

接受或拒絕編輯

Copilot 會列出在 [聊天] 視窗中的 [總計變更 ] 列表中編輯的檔案。

顯示 [變更總數] 列表的螢幕快照。

點擊每個檔案來個別檢視變更,您可以在其中 保留復原 對每個程式碼片段所做的編輯。

或者,在 [變更總計] 清單中,選擇 [保留] 或 [復原] 以處理自上次點擊 [保留] 或 [復原] 以來所做的所有編輯。

還原編輯

當您要求程式代碼編輯時,您可能會想要復原一些變更。 若要還原,請在包含您不想要變更的提示之前,選取檢查點旁的 [還原 ]。

顯示還原編輯的螢幕快照。

目前,Visual Studio Copilot Agent 不支援步驟式復原/取消復原。

中斷代理模式要求

若要中斷進行中的要求,您可以取消它。 這會停止所有執行中的工具和終端機命令。

若要停止建置,請選取頂端工具列中的 [ 置],然後選取 [ 取消 ] 或使用 Ctrl + Break 鍵盤快捷方式。

常見問題

我在 GitHub Copilot 聊天視窗中看不到 [詢問] 和 [代理程式] 模式。

依照指定的順序執行下列疑難解答步驟:

  • 請確定您使用 Visual Studio 17.14 或更新版本:在說明>關於 Visual Studio中檢查版本。 如果您未使用 17.14 版或更新版本,請啟動 Visual Studio 安裝程式並更新組建。
  • 請確定您已在 工具>>> 中的 聊天窗格中選擇啟用代理人模式
  • 請嘗試重新啟動 Visual Studio。

何時應該使用 Ask 模式與代理程式模式?

  • 當您想要 100% 信賴度時,除非明確選取 [ 套用 ] 或 [複製],然後自行貼上程式代碼,否則詢問模式非常出色。
  • 代理程式模式可以處理相同的概念問題、產生程式代碼範例而不套用它們,以及其編輯程式代碼的代理程式功能。
  • 如果您想要使用 MCP 功能,則必須選取代理程式模式。

Visual Studio 中的 Copilot Edits 發生了什麼事?

  • 我們認為代理模式是編輯功能的演進,具备更高的能力來反覆處理錯誤、使用工具,以及自動套用程式碼變更。
  • 針對 Visual Studio 2022 17.14 版的初始版本,如果您在 [工具>>> Chat 的 [>] 窗格中取消核取 [啟用代理程式模式] 設定,仍然可以使用 [編輯] 模式。

身為系統管理員,如何控制Visual Studio使用者的代理程式模式使用方式?

Visual Studio 中的代理程式模式是由系統管理員 GitHub Copilot 儀錶板中的 編輯器預覽功能 旗標所控管。 如果系統管理員關閉此設定,該訂用帳戶底下的使用者將無法在 Visual Studio 中使用代理程式模式。

如需詳細資訊,請參閱 管理企業中 Copilot 的原則和功能