在 VS Code 中使用代理程式建置
Visual Studio Code 內建 AI 代理程式。以自然語言描述任務，代理程式便會規劃處理方式、編輯專案中的檔案、執行命令，並進行自我修正，直到完成工作。代理程式能融入您既有的工作流程與節奏，讓您專注於意圖與審查，而無須逐行輸入程式碼。
請確定已在 VS Code 設定中啟用代理程式 ( chat.agent.enabled 此設定可能由您的組織管理。請聯絡您的管理員進行變更。)。如果您的組織已停用代理程式，請聯絡您的 GitHub 組織管理員。
您可以使用代理程式做什麼
代理程式可端對端處理真實的編碼任務。以下是幾個常見的範例：
- 先規劃再寫程式：使用規劃代理程式 (Plan agent) 產生逐步實作計畫，讓您在進行任何檔案變更前進行審查與精進。
- 建置新功能：描述您想要的功能，並讓代理程式建立使用者介面 (UI) 鷹架、串接狀態並更新測試。
- 建立原型並探索變體：快速建立概念驗證 (PoC)，或並行產生同一功能的多種設計變體，然後保留表現最佳的一種。
- 大規模重構：跨工作區重新命名、重構或遷移程式碼，並由代理程式追蹤仍需變更的部分。
- 建置與測試網路應用程式：從對話中驅動執行中的網路應用程式，以便在整合式瀏覽器中端對端驗證行為。
- 偵錯並修復失敗的測試：將代理程式指向堆疊追蹤 (stack trace) 或失敗的測試，讓它找出根本原因並套用修復方案。
開始使用
AI 功能已內建於 VS Code 中。若要啟用它們，請登入您的 GitHub 帳戶
-
從 VS Code 標題列選取登入，或將滑鼠游標懸停在狀態列的 Copilot 圖示上並選取啟用 AI 功能。如果您沒有訂閱，系統會自動為您註冊免費方案，該方案對建議和對話設有每月使用限制。
-
從 VS Code 標題列選取在代理程式中開啟。
-
選取工作區資料夾並選取 Copilot CLI 代理程式來啟動工作階段。
-
輸入描述您想做什麼的提示詞，例如「在標頭中新增深色模式切換開關，並確保它能在行動裝置上運作」。
您也可以帶入您自己的 API 金鑰，以便在沒有 Copilot 訂閱的情況下使用來自任何提供者的模型。深入了解語言模型。
選擇您與代理程式協作的方式
VS Code 提供兩個主要的介面來與代理程式協作：代理程式視窗 (Agents window) 與對話檢視 (Chat view)。挑選適合您目前任務的一個，並在它們之間自由切換。兩者共用相同的代理程式工作階段，讓您可以在其中一個啟動工作階段，並在另一個繼續進行而不會遺失內容。
選擇取決於您的作法與範圍。代理程式視窗是代理程式優先 (agent-first) 的，可從單一視窗跨您所有的工作區運作，因此當您指派高階任務並跨專案並行協調多個代理程式時，它是理想的選擇。對話檢視則是程式碼優先 (code-first) 的，其範圍限定在您開啟的工作區中，因此當您指派程式碼任務並希望緊貼著它所產生的程式碼時，它是理想的選擇。
代理程式視窗 (預覽) 是一個專用視窗，專注於將對話作為主要介面。它從單一視窗跨所有工作區運作，讓您可以指派高階任務、評估成果，並並行執行與追蹤多個代理程式。代理程式視窗已針對代理程式優先的工作流程進行最佳化。
對話檢視是位於側邊欄中的對話面板，位於您的工作區編輯器分頁旁邊。它的範圍限定在您在 VS Code 中開啟的工作區，因此您可以指派程式碼任務給代理程式、審查它產生的程式碼，並讓代理程式專注於您目前正在處理的程式碼。對話檢視已針對程式碼優先的工作流程進行最佳化。
設定您的代理程式工作階段
每個代理程式工作階段都有一些控制其執行方式的設定。在您啟動工作階段時進行選擇，並隨著任務的演進隨時進行調整。
| 選擇 | 說明 |
|---|---|
| 代理程式類型 | 代理程式執行的位置以及您與其互動的方式：透過本機代理程式在 VS Code 中以互動方式進行、透過 Copilot CLI 在您機器上的背景中執行、透過雲端代理程式在 GitHub 的基礎設施上遠端執行，或透過 Anthropic 或 OpenAI 等第三方提供者執行。 您可以將進行中的工作階段交接給不同的代理程式類型，例如將本機規劃工作階段傳遞給 Copilot CLI 或雲端代理程式。 |
| Agent | 塑造代理程式如何處理任務以及可以使用哪些工具的角色形象 (persona)。挑選內建代理程式 (Agent、Plan、Ask)，或使用自訂代理程式來擔任安全專家或文件撰寫者等專門角色。 |
| 語言模型 | 驅動代理程式推理的模型。為快速編輯與問題挑選快速的模型，或為複雜、多步驟或研究工作挑選更強大的推理模型。 |
| 權限層級 | 代理程式執行工具與終端機命令的自主程度，從核准每個動作到讓它自行獨立運作。 |
為您的程式碼基底量身打造代理程式
當代理程式了解您專案的慣例並擁有正確的工具時，它們的表現會最好。VS Code 提供多種方式讓您量身打造代理程式，以便它們從一開始就能產生成符合您程式碼基底與團隊實務的程式碼
-
設定編碼標準：透過自訂指示 (custom instructions) 定義專案範圍的規則與慣例，讓代理程式以您的風格產生程式碼。
-
自動化可重複執行的任務：將多步驟工作流程、指令碼和範本檔案封裝為代理程式技能，或將單一可重複使用的提示詞擷取至提示詞檔案中。
-
使代理程式專業化：針對程式碼審查者、安全專家或測試人員等角色形象或職責建立自訂代理程式。
-
連接外部工具與資料：新增 MCP 伺服器以存取資料庫和 API，並使用鉤子 (hooks) 在代理程式工作階段的關鍵點執行指令碼。
若要決定哪種選項符合您的目標，請參閱自訂概念。如需設定步驟與範例，請參閱在 VS Code 中自訂代理程式行為。您也可以從 Marketplace 安裝外掛程式，以新增這些自訂項目的預先封裝組合。
信任與掌控
代理程式可以讀取與編輯檔案、執行終端機命令，以及呼叫外部服務。VS Code 讓您保有控制權：在工具呼叫執行之前予以核准或拒絕、設定符合您能接受之自主程度的權限等級，並啟用代理程式沙箱化以在作業系統層級限制檔案系統與網路存取。深入了解信任與安全性以及AI 安全性。
組織可以集中管理跨團隊可用的 AI 功能、模型與工具。管理員可定義控制代理程式功能、限制 MCP 伺服器或擴充功能，以及強制執行合規性要求的政策，讓開發人員從一開始就能獲得一致且受規範的體驗。深入了解企業 AI 政策。