本機代理程式在 Visual Studio Code 中

本機代理程式會在您的機器上，於 Visual Studio Code 內以互動方式執行。它們會在您目前的工作區中運作，並可存取 VS Code 中提供的所有工具和模型，包括由擴充功能提供的工具和 MCP 伺服器。透過建立自訂代理程式，您可以讓代理程式在任務中扮演特定角色或身份，例如程式碼審閱者、測試人員或文件撰寫者。

本機代理程式會在 VS Code 的聊天介面中運作。當您關閉聊天工作階段時，本機代理程式會保持作用中，您可以在工作階段檢視中追蹤它。

為何使用本機代理程式？

• 需要即時回饋的互動式對話，例如腦力激盪、規劃，或尚未完全定義的任務
• 需要您開發環境中內容的任務，例如 Linting 錯誤、堆疊追蹤、單元測試結果
• 需要存取 VS Code 擴充功能或 MCP 伺服器中特定工具，或需要使用 BYOK 模型等特定模型的任務
• 不需要其他團隊成員協作的任務

主要特性

• 在您的本機機器上的 VS Code 內執行，並在您目前的工作區中運作
• 用於即時回饋和迭代的互動式聊天介面
• 完整存取您的工作區、檔案和內容
• 可存取 VS Code 中設定的所有代理程式工具，例如內建工具、MCP 工具和擴充功能提供的工具
• 可使用 VS Code 中所有可用的模型，包括 BYOK 模型和其他供應商提供的模型

內建代理程式

本機代理程式工作階段使用三種內建代理程式之一，每種都針對不同類型的任務進行最佳化。您可以在聊天工作階段期間，隨時透過在聊天檢視中的代理程式選取器選取不同的代理程式來切換。對於更專業的工作流程，您可以建立自己的自訂代理程式。

Agent

代理程式已針對基於高層次需求，且可能需要執行終端機命令和工具的複雜程式碼撰寫任務進行最佳化。AI 會自主運作，判斷相關的內容和要編輯的檔案，規劃所需的工作，並在問題出現時進行迭代以解決問題。

VS Code 會直接在編輯器中套用程式碼變更，而編輯器重疊控制項可讓您在建議的編輯之間導覽並審閱它們。代理程式可能會叫用多個工具來完成不同的任務。

您可以透過新增 MCP 伺服器或安裝提供工具的擴充功能，來使用額外工具自訂聊天。

使用代理程式開啟聊天：穩定版 | 預覽版

規劃

規劃代理程式已針對為程式碼撰寫任務建立結構化實作計畫進行最佳化。當您想要在實作之前，將複雜功能或變更分解為更小、可管理的步驟時，請使用規劃代理程式。

規劃代理程式會產生詳細計畫，概述所需的步驟，並提出釐清問題，以確保對任務有全面的理解。然後，您可以將計畫交給實作代理程式或將其用作指南。

使用規劃開啟聊天：穩定版 | 預覽版

深入瞭解使用 Agent 進行規劃。

詢問

詢問功能最適用於回答有關您的程式碼庫、程式碼撰寫和一般技術概念的問題。當您想要了解某個東西的運作方式、探索想法或取得程式碼撰寫任務的協助時，請使用「詢問」。

「詢問」使用代理程式功能來研究您的程式碼庫並收集相關內容。回應可能包含您可以單獨套用至程式碼庫的程式碼區塊。若要套用程式碼區塊，請將滑鼠游標停留在程式碼區塊上，然後選取**在編輯器中套用**按鈕。

使用「詢問」開啟聊天：穩定版 | 預覽版

編輯模式 (已淘汰)

編輯模式已淘汰。請改用代理程式模式進行多檔案程式碼編輯。您可以透過啟用 chat.editMode.hidden 在 VS Code 中開啟 在 VS Code 預覽版中開啟 設定來還原編輯模式。

開始使用

若要啟動本機代理程式工作階段

1. 從聊天檢視中的代理程式選取器中選取**代理程式**。

2. 在聊天輸入欄位中輸入高階提示。例如，您可以詢問

   Implement a user authentication system with OAuth2 and JWT.
   

   或

   Set up a CI/CD pipeline for this project.
   

3. 使用工具選取器來啟用工具並賦予代理程式更多功能。

4. 選取**傳送**或按下 Enter 以提交您的提示。

5. 當代理程式處理您的請求時，審閱並確認程式碼變更和工具叫用。

   當代理程式正在運作時，您可以傳送後續提示。將訊息排入佇列以供稍後處理，引導代理程式朝新方向發展，或立即停止並傳送。深入了解在請求執行時傳送訊息。

   提示

   VS Code 有助於保護您避免對敏感檔案進行意外編輯，例如工作區組態設定或環境設定。深入了解編輯敏感檔案。

若要使用「詢問」開始

1. 在聊天輸入欄位中輸入您的提示。例如，您可以詢問

   Provide 3 ways to implement a search feature in React.
   

   或

   Where is the db connection configured in this project? #codebase
   

2. 從聊天檢視中的代理程式選取器中選取**詢問**。

3. 您可以選擇性地為您的提示新增內容以獲得更準確的回應。

4. 選取**傳送**或按下 Enter 以提交您的提示。

相關資源

• 代理程式概觀：選擇代理程式、設定權限並在代理程式類型之間進行移交。
• 管理聊天工作階段：建立、切換和整理您的工作階段。
• 代理程式教學課程：使用不同代理程式類型的實作教學課程。
• 工具：使用內建、MCP 和擴充功能工具擴充代理程式。
• 自訂代理程式：建立您自己的 AI 代理程式和擴充功能。