使用 Agents 視窗 (預覽版)

Agents 視窗是 VS Code 中一個專用的視窗，旨在實現以 Agent 為優先的工作流程。它是 VS Code 編輯器視窗的自然互補：編輯器視窗針對單一工作區中以程式碼為中心的工作進行了最佳化，而 Agents 視窗則針對跨專案的高階任務進行了最佳化，並以對話與工作階段列表作為主要介面。

Agents 視窗讓您能從單一位置存取所有工作區，並可跨專案同時執行與追蹤多個工作階段，而無需在不同視窗中分別開啟各個工作區。它與主要的 VS Code 視窗共用相同的 Agent 工作階段、設定與快速鍵，因此您可以隨時在「編輯器優先」與「Agent 優先」的工作流程之間自由切換，而不會遺失內容脈絡。

在本文中，您將了解 Agents 視窗，以及如何跨專案啟動與管理 Agent 工作階段。

先決條件

• 已安裝 Visual Studio Code。下載 VS Code。
• 存取 GitHub Copilot。請按照在 VS Code 中設定 GitHub Copilot 中的步驟登入並啟用您的訂閱。

開啟 Agents 視窗

Agents 視窗會以專用 VS Code 視窗的形式與您的主編輯器視窗並排開啟。若要開啟 Agents 視窗，請使用下列任一方法

• 在 VS Code 中，選擇標題列中的 **Open in Agents** 按鈕，或是從命令選擇區 (Command Palette) 執行 **Chat: Open Agents Window** (⇧⌘P (Windows, Linux Ctrl+Shift+P))。

  您也可以直接從 VS Code 歡迎頁面開啟 Agents 視窗。

  

• 從命令列執行 code --agents。

• 在瀏覽器中開啟 https://insiders.vscode.dev/agents 以從任何裝置使用 Agents 視窗。請參閱 在瀏覽器中使用 Agents 視窗 以取得設定說明。

Agents 視窗需要 GitHub 驗證才能存取您的 Copilot 訂閱與工作階段。如果您已在 VS Code 中登入 GitHub，則開啟 Agents 視窗時也會同步登入。

如果您偏好全程使用編輯器視窗，可以透過在標題列按右鍵並選擇 **Hide 'Open in Agents'** 來隱藏 **Open in Agents** 按鈕。您仍然可以隨時透過命令選擇區或命令列開啟 Agents 視窗。

介面概覽

Agents 視窗會擷取您在各個工作區中現有的 Copilot CLI、Cloud 與 Claude Agent 工作階段。您無需將每個工作區分別開啟於不同視窗，即可在各工作區的 Agent 工作階段之間進行切換。

Agents 視窗包含下列主要區域

1. **工作階段列表 (Sessions list)**：位於側邊欄，您可以在此檢視與管理跨工作區的所有工作階段。預設情況下，工作階段會按工作區分組。在工作階段上按右鍵可查看更多指令，例如重新命名、標記為完成、釘選等。

2. **自訂面板 (Customizations panel)**：位於工作階段列表下方，您可以在此存取 Agent 自訂項目，以根據您的工作流程與偏好調整 Agent 行為。

3. **對話區域 (Chat area)**：位於中心，您可以在此查看對話記錄並透過提示詞與 Agent 互動。

4. **變更面板 (Changes panel)**：位於右側，您可以在此檢視 Agent 在工作階段期間產生的檔案變更與其他產出物，並查看工作區的檔案總管。

啟動 Agent 工作階段

Agents 視窗與主 VS Code 視窗共用相同的底層 Agent 工作階段 (Copilot CLI、Copilot cloud 與 Claude agent)。這意味著您在 Agents 視窗中啟動的任何工作階段，都能立即在主 VS Code 視窗中使用。

若要在 Agents 視窗中啟動新的 Agent 工作階段

1. 選擇側邊欄頂部的 **New**，或按 ⌘N (Windows, Linux Ctrl+N)。

   

2. 使用工作區下拉式選單為您的對話工作階段選擇本機資料夾或 GitHub 儲存庫。

   您可以將滑鼠游標懸停在工作階段列表中的工作區上，並選擇 **+** (New Session)，直接啟動鎖定於特定工作區的工作階段。

   如果您選擇的資料夾或儲存庫尚未被信任，在啟動工作階段前，系統會提示您進行信任。

   提示

   您可以追蹤並建立透過 SSH 或開發通道 (dev tunnel) 在遠端機器上執行的工作階段。詳細資訊請參閱 在遠端機器上開啟工作階段。

3. 選擇工作區後，從下拉式選單選擇該工作階段使用的 Agent。

   

   可用的 Agent 類型取決於您選擇的工作區類型

   • **資料夾**：可在 Copilot CLI 或 Claude agent 之間選擇以啟動新工作階段。您可以隨時在工作階段期間選擇 **Continue In** 將工作階段移交給 Copilot Cloud agent。
   • **儲存庫**：在 GitHub 儲存庫中啟動的工作階段會使用 Copilot cloud agent。

4. 對於 Copilot CLI 工作階段，請選擇資料夾或工作樹 (worktree) 隔離模式。

   • **工作樹隔離 (Worktree isolation)**：Agent 會在由 Git worktree 支援的獨立資料夾中運作，這能讓變更與您的主要工作區保持隔離，直到您準備好合併為止。
   • **資料夾隔離 (Folder isolation)**：Agent 在您的主要工作區中運作，變更會直接套用到您的檔案。這是非 Git 專案的預設行為。

   （選用）選擇一個原始碼控制分支作為工作階段的基礎。

   

5. （選用）為工作階段選擇自訂 Agent 與語言模型。您可以在工作階段期間隨時更改這些選項。

6. 輸入描述您想要達成目標的提示詞，然後按 Enter。

   Agent 會將您的任務分解為步驟、編寫程式碼、執行命令，並在出錯時進行自我修正。您可以繼續對話以精進結果或變更方向。

管理與檢視檔案變更

Agents 視窗中的「變更面板」提供了一個專用視窗，其中包含有關工作階段期間檔案與 Agent 編輯內容的詳細資訊。「變更面板」分為兩個主要索引標籤

• **檔案 (Files) 索引標籤**：工作區中所有檔案的檔案總管檢視。
• **變更 (Changes) 索引標籤**：列出由 Agent 變更、新增或刪除的檔案清單。選擇 **Branch Changes** 下拉式選單以選擇要檢視的變更。

若要檢視 Agent 所做的變更，請在 **Changes** 索引標籤中選擇一個檔案，以開啟差異比對檢視 (diff view)，顯示 Agent 所做的編輯與目前工作區狀態的對照。

您可以將差異比對檢視與 Agents 視窗內的 Chat 檢視並排開啟，或在彈出視窗中開啟以專注於變更。使用差異比對檢視工具列中的版面控制選項，可在不同的顯示模式之間切換。

在檢視差異比對時，點擊某個編輯處並選擇 **Add Feedback**，即可直接在檔案中輸入回饋註解，提示 Agent 進行調整。

檢視變更後，「變更面板」提供了下列選項來處理 Agent 所做的編輯

• **Commit**：使用資料夾隔離時，將 Agent 所做的變更直接提交 (commit) 到您的工作區。
• **Merge**：使用工作樹隔離時，執行合併（並可選擇與上游同步）並建立提取請求 (pull request)。
• **Checkout**：對於 Copilot Cloud 工作階段，將與工作階段提取請求相關聯的分支簽出 (checkout) 到本機，以進行檢閱或請求進一步編輯。
• **Discard**：如果您不想保留編輯內容，可直接從「變更面板」捨棄一或多個編輯。

當您建立新工作階段時，「檔案」面板包含一個同步按鈕，讓您在 Agent 開始工作前先從基礎分支提取上游變更。這有助於 Agent 從分支的最新狀態開始，並減少將其變更合併回專案時發生合併衝突的可能性。

在本機驗證 Agent 的變更

除了在「變更面板」中檢視變更外，您還可以在提交或合併之前，於本機驗證 Agent 所做的編輯。Agents 視窗支援在目前工作階段的上下文中執行任務與命令。例如，您可以執行組建或測試以確保 Agent 所做的變更不會損壞您的專案，或是啟動開發伺服器以驗證編輯內容在執行環境中是否如預期般運作。

若要在 Agents 視窗中設定任務

1. 啟動或開啟一個工作階段。

2. 選擇標題列中的 **Tasks** 下拉式選單，並選擇 **Add Task**。

   

3. 提供任務詳細資訊

   • **名稱 (Name)**：任務的描述性名稱。
   • **命令 (Command)**：執行任務時所執行的命令（例如 npm run build 或 pytest）。
   • **執行選項 (Run Options)**：建立工作階段工作樹時自動執行任務。
   • **儲存於 (Save In)**：選擇將任務設定儲存在工作區或您的使用者設定檔中，以便跨專案重複使用。

4. 選擇 **Add Task** 以儲存任務設定。

任務設定完成後，它會出現在 **Tasks** 下拉式選單中，您可以在目前工作階段的上下文中執行它，以驗證 Agent 所做的變更。

如果您的應用程式涉及瀏覽器行為，您可以使用 Agents 視窗中的整合式瀏覽器。從對話工作階段中選擇 localhost 連結，即可在 Agents 視窗內的整合式瀏覽器中開啟。瀏覽器索引標籤會在切換工作階段時保留，因此如果您開啟另一個工作階段，瀏覽器索引標籤會開啟至您先前瀏覽的相同頁面，並保留該頁面的狀態。

或者，您也可以從整合式終端機選擇 localhost 連結，或使用命令選擇區中的 **Open Integrated Browser** 命令開啟整合式瀏覽器 (⇧⌘P (Windows, Linux Ctrl+Shift+P))。您可以使用整合式瀏覽器中的版面控制選項，將其顯示為彈出視窗，或與其他檢視並排嵌入在 Agents 視窗版面中。

如果您想在目前工作階段的上下文中執行終端機命令，請選擇標題列中的 **Open Terminal** 圖示，開啟一個將目前工作目錄設為該工作階段資料夾或工作樹的整合式終端機。

在遠端機器上開啟工作階段

您可以連線至遠端機器以在該處啟動工作階段，或追蹤在該機器上執行中之現有工作階段的進度。當您離開主要開發機器但仍想確認 Agent 工作進度，或是想利用遠端機器的資源（如特殊硬體或特定環境設定）時，這非常有用。

Agents 視窗透過 SSH 或開發通道，使用 Agent Host Protocol (AHP) 連線至遠端機器。當您連線時，Agents 視窗會自動在遠端機器上安裝並啟動 VS Code CLI。這也意味著遠端機器必須處於開機狀態，且必須能透過網路存取。

透過 SSH 連線

**必要條件**：遠端機器必須可透過 SSH 存取。遠端機器上無需額外安裝 Agent。

若要透過 SSH 在遠端機器上啟動工作階段

1. 選擇 **New** 或按 ⌘N (Windows, Linux Ctrl+N) 以啟動新的 Agent 工作階段。

2. 在工作區下拉式選單中，選擇 **Remote** 索引標籤，然後選擇 **SSH**。如果您已經設定過 SSH 連線，它們會以選項形式出現在下拉式選單中。

   

3. 輸入遠端機器的 SSH 連線字串（例如 user@hostname）。

4. 選擇遠端機器上要用於工作階段的資料夾。

5. 輸入提示詞並按 Enter 啟動工作階段。

透過開發通道 (dev tunnel) 連線

**必要條件**：遠端機器上必須已執行開發通道。請參閱 使用遠端通道進行開發 以取得設定說明。

若要透過開發通道在遠端機器上啟動工作階段

1. 選擇 **New** 或按 ⌘N (Windows, Linux Ctrl+N) 以啟動新的 Agent 工作階段。

2. 在工作區下拉式選單中，選擇 **Remote** 索引標籤，然後選擇 **Tunnels** 並選擇您的帳號類型。

   

3. 從清單中選擇啟用的開發通道。

4. 選擇遠端機器上要用於工作階段的資料夾。

5. 輸入提示詞並按 Enter 啟動工作階段。

在瀏覽器中使用 Agents 視窗

Agents 視窗也提供網頁用戶端版本，網址為 https://insiders.vscode.dev/agents，因此您可以從任何有瀏覽器的裝置管理 Agent 工作階段。當您離開主要開發機器、使用行動裝置工作，或想在不於本機安裝 Visual Studio Code 的情況下查看遠端主機上正在執行的工作階段時，這非常實用。

瀏覽器版的 Agents 視窗透過 開發通道 連線至您的開發機器。Agent 工作階段在遠端主機上執行，瀏覽器則作為對話、檢視變更與管理工作階段的輕量級用戶端。

設定開發通道

在瀏覽器中使用 Agents 視窗之前，請先在您要連線的機器上啟動開發通道

1. 在您的遠端主機上，執行下列命令以啟動開發通道

   code-insiders tunnel
   

   如果您使用的是穩定版 (stable release)，請改為執行 code tunnel。

   首次執行此命令時，系統會提示您使用 GitHub 或 Microsoft 帳號進行驗證。基於安全考量，通道預設需要驗證。

2. 通道執行後，在任何裝置的瀏覽器中開啟 https://insiders.vscode.dev/agents。

3. 出現提示時，選擇 **Continue with GitHub** 登入。如果您已通過驗證，Agents 視窗將直接載入。

4. 您的通道主機會出現在視窗頂部的「主機列」中。選擇它以進行連線。

5. 選擇遠端機器上的資料夾，選擇一個 Agent，然後啟動工作階段。

主機管理

瀏覽器版 Agents 視窗中的「主機列」會顯示您可用的通道主機。每台主機都會顯示其連線狀態

• **Online**：主機可連線，您可以在其上啟動或繼續工作階段。
• **Offline**：主機上的通道未執行。請在主機上啟動通道以使其恢復連線。

您可以直接透過「主機列」連線或中斷主機。如果您在有作用中工作階段時主機離線，工作階段會顯示中斷連線狀態。當主機恢復連線時，工作階段會自動重新連線。

建立子工作階段

當您有作用中工作階段時，可以啟動子工作階段，讓 Agent 在同一個工作區內執行平行的獨立任務。子工作階段與父工作階段共用同一個工作區與工作樹，但會以空白對話啟動。子工作階段不會繼承父工作階段的對話記錄。

當您想在同一個專案中處理獨立任務，而不想中斷目前工作階段或重新啟動一個全新的工作階段時，這非常實用。

若要建立子工作階段

1. 在作用中的工作階段中，選擇視窗標題列中的 **New Sub-Session** (+)。

   請注意，對話區域中會出現一個新的子工作階段索引標籤，與父工作階段的索引標籤並排。子工作階段不會以獨立項目出現在工作階段列表中。

   

2. 輸入提示詞並按 Enter 啟動子工作階段。

管理您的工作階段

側邊欄中的工作階段列表會顯示您跨工作區的所有作用中工作階段。您可以按專案或時間範圍分組工作階段，以追蹤相關工作。每個工作階段項目都會顯示關鍵資訊，例如工作階段名稱、工作區、Agent 類型與檔案變更統計資料。

使用篩選與搜尋選項縮小清單範圍，找到您想要處理的工作階段。

選擇任何工作階段以檢視對話記錄並從上次中斷的地方繼續。變更面板會顯示 Agent 的最新檔案更新與工作區的檔案總管檢視。

在列表中的任何工作階段上按右鍵可查看更多管理選項，例如重新命名、刪除等。如需進階工作階段管理，例如封存、分岔、檢查點與匯出，請參閱對話說明文件中的 管理對話工作階段。

針對您的專案與工作流程自訂 Agent

**自訂 (Customizations)** 面板讓您能直接存取所有 AI 自訂選項

「Agent 自訂」面板使您能輕鬆地在單一位置管理所有自訂設定

• 檢視與編輯專案 (工作區) 現有的自訂設定，或跨所有專案 (使用者) 的設定。
• 使用內建編輯器或從提示詞產生新自訂設定。
• 從市集安裝外掛程式或 MCP 伺服器。
• 啟用或停用自訂設定而無需將其移除。

使用「Agent 自訂」面板左上角的下拉式選單，選擇自訂設定應套用的 Agent。

信任資料夾

當您首次在 Agents 視窗中開啟新資料夾或儲存庫時，系統會提示您信任該資料夾及其子資料夾。資料夾信任是一項安全性措施，防止 Agent 在不受信任的資料夾中執行，這可能導致惡意程式碼在您的機器上執行。

如果您選擇不信任該資料夾，您將無法在 Agents 視窗中為該資料夾啟動或繼續 Agent 工作階段。

Agents 視窗與主 VS Code 視窗共用相同的「工作區信任」狀態。如果您在 VS Code 中信任了某個資料夾，它在 Agents 視窗中也會被信任，反之亦然。請參閱 工作區信任說明文件 以了解更多資訊。

切換至另一個 GitHub 帳號

若要在 Agents 視窗中使用不同的 GitHub 帳號，請選擇視窗右上角的帳號圖示並選擇 **Sign out**。登出後，選擇 **Sign in** 以使用不同的 GitHub 帳號進行驗證。

設定 Agents 視窗的選項

Agents 視窗共用您所有的 VS Code 設定，因此您已經投入設定的內容會自動延用。當您希望 Agents 視窗的行為與編輯器視窗不同時，您可以僅針對 Agents 視窗覆寫特定設定，而不影響您的主 VS Code 設定。

若僅針對 Agents 視窗覆寫設定，請編輯您的設定檔並將值限定在 Agents 視窗區段內。從 Agents 視窗開啟設定編輯器 (⌘, (Windows, Linux Ctrl+,))，查看設定所套用的範圍。

在 Agents 視窗中使用 VS Code 擴充功能

Agents 視窗可以執行您的 VS Code 擴充功能，因此您可以將您依賴的工具帶入以 Agent 為優先的工作流程中。

僅提供靜態內容的擴充功能（例如佈景主題、語法、語言與快速鍵）會自動在 Agents 視窗中啟用。我們也測試了市集前 100 名的擴充功能，其中部分在預設 VS Code 設定檔中安裝時也會啟用。

對於其他擴充功能，您可以使用 extensions.supportAgentsWindow 在 VS Code 中開啟 在 VS Code Insiders 中開啟 設定，按 ID 選擇啟用。

"extensions.supportAgentsWindow": {
    "myextension.id": true
}

啟用擴充功能時請記住下列事項

• 您以此方式啟用的任何擴充功能，都必須安裝在您的預設 VS Code 設定檔中。
• 擴充功能支援仍在發展中。如果某個擴充功能在 Agents 視窗中的表現不如預期，請提出問題以便我們討論。

如果您是擴充功能開發者，我們很樂意共同探討 Agents 視窗中的擴充功能支援能帶來哪些可能性。無論您是想構思利用跨專案執行 Agent 的新場景，還是分享現有擴充功能在 Agents 視窗中表現的回饋，都歡迎透過 GitHub Issues 分享您的意見與點子。

限制

• 目前 Agent 還無法直接為您開啟整合式瀏覽器。您可以從命令選擇區 (**Browser: Open Integrated Browser**) 啟動整合式瀏覽器，或是透過選取 Agents 視窗中的 localhost 連結來開啟。

• Agents 視窗目前僅支援下列 Agent 類型：Copilot CLI、Copilot Cloud 與 Claude agent。若要使用本機或其他第三方 Agent，請從主 VS Code 視窗管理您的工作階段。

• Copilot Cloud 工作階段僅支援 GitHub 託管的儲存庫。對於非 GitHub 專案，您仍可在 Agents 視窗中使用 Copilot CLI。

• Agent 下拉式選單目前沒有 plan agent。您仍然可以在 Copilot CLI 或 Claude agent 工作階段中使用 /plan 命令。在 Copilot CLI 工作階段中，當您在提示詞中要求建立計畫時，也會自動觸發 plan agent。

• Claude agent 工作階段目前尚未支援子工作階段。

• Agents 視窗目前尚未支援多根工作區 (Multi-root) 工作階段。您可以要求 Agent 在單一工作階段中跨專案運作。

常見問題

後續步驟

• 管理對話工作階段 - 檢查點、分岔、封存與匯出工作階段。
• 使用 Agent - Agent 類型、委派與自主等級。
• 自訂 AI - 完整自訂參考。
• 最佳實踐 - 有效提示詞的技巧。