聊天调试视图
聊天调试视图是Visual Studio Code中的一个专用视图,您可以在这里查看AI请求和响应的详细信息。利用它来理解向语言模型发送了哪些信息,模型如何响应,以及在聊天交互中调用了哪些工具。
该视图对扩展开发者、MCP服务器作者以及希望排查意外AI行为或优化提示的高级用户非常有用。
何时使用聊天调试视图
当你想这样做时,可以使用聊天调试视图:
- 理解AI为何会有意外回应:检查上下文和系统提示,看看模型接收了哪些信息。
- 核实发送的上下文:确认请求中包含了工作区文件、-提及或工具输出。
# - 调试MCP服务器或扩展工具:查看工具是否被调用、收到了哪些输入以及返回了什么。
- 优化提示:审查发送给模型的完整提示,以发现更清晰的指令或更好的上下文。
打开聊天调试视图
要打开聊天调试视图:
-
在聊天中选择溢出菜单,选择“显示聊天调试视图”。
-
从命令面板中执行“开发者:显示聊天调试视图”命令。
聊天调试视图会打开并显示你提出的每个聊天请求的详细信息。

读取调试输出
聊天调试视图中的每个交互都包含可扩展的部分。下表描述了每个部分的内容以及应注意的事项:
| 章节 | 它所显示的内容 | 需要注意什么 |
|---|---|---|
| 系统提示 | 定义AI行为、能力和约束的指令。 | 确认自定义说明或代理描述是否正确。 |
| 用户提示 | 你发送给模特的提示词的原文。 | 确认你的提示按预期发送,包括任何已解决为实际内容的 -提及。# |
| 背景 | 文件、符号及其他上下文项目附加到请求中。 | 检查预期的文件和上下文是否出现。如果文件缺失,可能是没有被索引,或者上下文窗口已满。 |
| 反响 | 模型回答的全文,包括推理。 | 查看原始回复,了解模型如何解读你的请求。 |
| 工具响应 | 请求过程中调用的工具输入和输出。 | 验证工具是否收到了正确的输入并返回预期输出。对调试MCP服务器非常有用。 |
你可以展开每个章节,查看完整细节。这在使用代理时尤其有用,因为多个工具可能作为单一请求的一部分调用。
常见的故障排查场景
AI会忽略你的工作区文件
如果AI回复的是通用信息,而不是引用你的代码库:
- 打开聊天调试视图,检查上下文部分。
- 确认工作区文件是否出现在上下文中。如果没有,检查一下工作区索引是否激活。
- 试着添加明确的 -提及(例如
##file或#codebase)以确保包含正确的文件。了解更多关于管理上下文的信息。
没有调用MCP工具
如果AI没有调用预期的工具:
- 请查看系统提示部分,确认该工具是否列在可用工具中。
- 如果缺少该工具,请确认MCP服务器运行和配置正确。
- 试着明确提及这个工具,并用
#tool 名在你的提示中。
AI的响应不完整或被切断
如果回复显得被截断:
- 查看上下文部分,查看总代币使用情况。
- 完整的上下文窗口可能导致模型截断响应。重新开一个聊天会话来重置上下文。