排查 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（开发者：设置日志级别）并将值设置为 Trace（跟踪）用于 GitHub Copilot 和 GitHub Copilot Chat 扩展。
运行 Output: Show Output Channels（输出：显示输出通道）并在列表中选择 GitHub Copilot 或 GitHub Copilot Chat。
在“输出”面板中，查看所选扩展的日志。

要在输出通道之间切换，请从“输出”面板右侧的下拉菜单中选择 GitHub Copilot 或 GitHub Copilot Chat。

如果您在连接到 GitHub Copilot 时遇到问题，请收集网络连接诊断信息以识别防火墙、代理或 VPN 问题。

有关网络配置的更多信息，请参阅 Copilot 的网络和防火墙配置。

VS Code 提供了工具来检查您向 AI 发送提示时发生的情况。

Agent Debug panel（代理调试面板）是主要的调试工具。它显示代理交互的按时间顺序排列的事件日志，包括工具调用序列、LLM 请求、令牌使用情况、提示文件发现和错误。

要打开 Agent Debug panel

或者，从命令面板运行 Developer: Open Agent Debug Panel（开发者：打开代理调试面板）。

Chat Debug view（聊天调试视图）显示每个 LLM 请求和响应的原始详细信息，包括完整的系统提示、上下文和工具有效负载。

要打开 Chat Debug view

或者，从命令面板运行 Developer: Show Chat Debug View（开发者：显示聊天调试视图）。

了解更多关于调试聊天交互的信息。

聊天自定义诊断视图显示当前加载的所有自定义代理、提示文件、指令文件和技能。使用此视图来排查未应用或导致错误的自定义文件的问题。

要打开诊断视图

这将打开一个 Markdown 文档，其中列出了

提示

如果未应用自定义文件，请检查诊断视图以验证其是否已成功加载，并查看任何错误消息。

MCP 服务器通过连接到外部服务来扩展聊天功能。如果 MCP 服务器无法正常工作，您可以查看其日志并重新启动它。

要排查 MCP 服务器问题

了解更多关于配置和调试 MCP 服务器的信息。

如果您遇到无法解决的问题，请报告它们以帮助改进 GitHub Copilot

幽灵文本建议：将鼠标悬停在编辑器中的幽灵文本建议上，然后选择 Send Copilot Completion Feedback（发送 Copilot 完成反馈）。
下一个编辑建议：选择编辑器gutter中的下一个编辑建议菜单中的 Feedback（反馈）操作。
常规问题：打开 Help（帮助）> Report Issue（报告问题），选择 VS Code Extension（VS Code 扩展），然后选择 GitHub Copilot Chat。

在报告问题时，请包含来自 Copilot 日志的相关信息，以帮助诊断问题。