針對 Visual Studio Code 中的 AI 進行疑難排解
本文涵蓋了用於解決 VS Code 中 AI 相關問題的診斷工具與技術。使用這些工具來識別網路連線、自訂檔案以及 AI 回應方面的問題。
檢視 GitHub Copilot 的記錄檔
GitHub Copilot 延伸模組的記錄檔儲存在 Visual Studio Code 延伸模組的標準記錄位置。請使用這些記錄檔來診斷連線問題、延伸模組錯誤及非預期的行為。
若要檢視詳細記錄檔
- 開啟命令點選集 (⇧⌘P (Windows, Linux Ctrl+Shift+P))。
- 執行 Developer: Set Log Level（開發人員：設定記錄層級），並將 GitHub Copilot 與 GitHub Copilot Chat 延伸模組的值設為 Trace（追蹤）。
- 執行 Output: Show Output Channels（輸出：顯示輸出頻道），並從清單中選擇 GitHub Copilot 或 GitHub Copilot Chat。
- 在「輸出」(Output) 面板中，檢視所選延伸模組的記錄。
若要在不同的輸出頻道間切換，請從「輸出」面板右側的下拉式選單中選擇 GitHub Copilot 或 GitHub Copilot Chat。
收集網路診斷資訊
如果您在連線至 GitHub Copilot 時遇到問題，請收集網路連線診斷資訊，以識別防火牆、Proxy 或 VPN 相關問題。
- 開啟命令點選集 (⇧⌘P (Windows, Linux Ctrl+Shift+P))。
- 執行 GitHub Copilot: Collect Diagnostics（GitHub Copilot：收集診斷資訊）。
- 編輯器將開啟一個索引標籤，其中包含您可以檢閱並在回報問題時分享的診斷資訊。
如需更多關於網路設定的資訊，請參閱 Copilot 的網路與防火牆設定。
偵錯聊天互動
VS Code 提供了不同的工具，用以檢查當您向 AI 發送提示 (Prompt) 時發生了什麼事。
-
/troubleshoot斜線指令要求 AI 分析聊天工作階段的偵錯記錄檔。您可以選擇性地包含
#session來選取並診斷先前的聊天工作階段。輸入/troubleshoot後接您的問題，例如/troubleshoot how many tokens did I use?或/troubleshoot list all paths you tried to load customizations in #session。此功能需要啟用 github.copilot.chat.agentDebugLog.enabled 。 -
代理程式偵錯記錄面板 (預覽)
顯示聊天工作階段期間代理程式互動的按時間排序的事件記錄，包含工具呼叫順序、LLM 要求、Token 使用量、提示檔案探索以及錯誤。這是了解並偵錯聊天互動的主要工具。
若要開啟「代理程式偵錯記錄」面板
- 在「聊天」(Chat) 檢視中選擇省略符號 (...) 選單，並選擇 Show Agent Debug Logs（顯示代理程式偵錯記錄）。
您可以從「代理程式偵錯記錄」面板中，將代理程式偵錯事件的快照附加到聊天對話，藉此向 AI 詢問有關該工作階段的問題，並針對特定互動進行疑難排解。
深入了解 代理程式偵錯記錄面板。
-
聊天偵錯檢視
顯示每個 LLM 要求與回應的原始詳細資料，包含完整的系統提示、使用者提示、上下文以及工具調用承載 (Payloads)。使用此檢視來檢查每次互動時發送至語言模型，以及從中接收到的確切資料。
若要開啟「聊天偵錯」檢視
- 在「聊天」(Chat) 檢視中選擇溢位選單 (
...)。 - 選擇 Show Chat Debug View（顯示聊天偵錯檢視）。
- 在「聊天」(Chat) 檢視中選擇溢位選單 (
深入了解 聊天偵錯檢視。
針對 MCP 伺服器進行疑難排解
MCP 伺服器透過連線至外部服務來擴充聊天功能。如果 MCP 伺服器運作不正常，您可以檢視其記錄檔並將其重新啟動。
針對 MCP 伺服器進行疑難排解
- 開啟指令選擇區 (Command Palette) 並執行 MCP: List Servers（MCP：列出伺服器）。
- 選取伺服器以檢視其狀態與可用動作。
- 選擇 Show Output（顯示輸出）以檢視伺服器的記錄檔。
- 選擇 Restart Server（重新啟動伺服器）以重新啟動發生異常的伺服器。
深入了解 設定與偵錯 MCP 伺服器。
提供意見反應
如果您遇到無法解決的問題，請回報給我們以協助改進 GitHub Copilot
- Ghost 文字建議：將游標懸停在編輯器中的 Ghost 文字建議上，並選擇 Send Copilot Completion Feedback（傳送 Copilot 完成建議意見反應）。
- 下一個編輯建議：在編輯器邊緣的「下一個編輯建議」選單中，選擇 Feedback（意見反應）動作。
- 一般問題：開啟 Help（說明）> Report Issue（回報問題），選擇 VS Code Extension（VS Code 延伸模組），然後選擇 GitHub Copilot Chat。
回報問題時，請包含來自 Copilot 記錄檔的相關資訊，以協助診斷問題。