聊天调试视图

聊天调试视图是Visual Studio Code中的一个专用视图,您可以在这里查看AI请求和响应的详细信息。利用它来理解向语言模型发送了哪些信息,模型如何响应,以及在聊天交互中调用了哪些工具。

该视图对扩展开发者、MCP服务器作者以及希望排查意外AI行为或优化提示的高级用户非常有用。

何时使用聊天调试视图

当你想这样做时,可以使用聊天调试视图:

  • 理解AI为何会有意外回应:检查上下文和系统提示,看看模型接收了哪些信息。
  • 核实发送的上下文:确认请求中包含了工作区文件、-提及或工具输出。#
  • 调试MCP服务器或扩展工具:查看工具是否被调用、收到了哪些输入以及返回了什么。
  • 优化提示:审查发送给模型的完整提示,以发现更清晰的指令或更好的上下文。

打开聊天调试视图

要打开聊天调试视图:

  • 在聊天中选择溢出菜单,选择“显示聊天调试视图”。

  • 从命令面板中执行“开发者:显示聊天调试视图”命令。

聊天调试视图会打开并显示你提出的每个聊天请求的详细信息。

聊天调试视图的截图,显示聊天请求和响应的详细信息。

读取调试输出

聊天调试视图中的每个交互都包含可扩展的部分。下表描述了每个部分的内容以及应注意的事项:

章节 它所显示的内容 需要注意什么
系统提示 定义AI行为、能力和约束的指令。 确认自定义说明或代理描述是否正确。
用户提示 你发送给模特的提示词的原文。 确认你的提示按预期发送,包括任何已解决为实际内容的 -提及。#
背景 文件、符号及其他上下文项目附加到请求中。 检查预期的文件和上下文是否出现。如果文件缺失,可能是没有被索引,或者上下文窗口已满。
反响 模型回答的全文,包括推理。 查看原始回复,了解模型如何解读你的请求。
工具响应 请求过程中调用的工具输入和输出。 验证工具是否收到了正确的输入并返回预期输出。对调试MCP服务器非常有用。

你可以展开每个章节,查看完整细节。这在使用代理时尤其有用,因为多个工具可能作为单一请求的一部分调用。

常见的故障排查场景

AI会忽略你的工作区文件

如果AI回复的是通用信息,而不是引用你的代码库:

  1. 打开聊天调试视图,检查上下文部分。
  2. 确认工作区文件是否出现在上下文中。如果没有,检查一下工作区索引是否激活。
  3. 试着添加明确的 -提及(例如##file#codebase)以确保包含正确的文件。了解更多关于管理上下文的信息。

没有调用MCP工具

如果AI没有调用预期的工具:

  1. 请查看系统提示部分,确认该工具是否列在可用工具中。
  2. 如果缺少该工具,请确认MCP服务器运行和配置正确。
  3. 试着明确提及这个工具,并用#tool 名在你的提示中。

AI的响应不完整或被切断

如果回复显得被截断:

  1. 查看上下文部分,查看总代币使用情况。
  2. 完整的上下文窗口可能导致模型截断响应。重新开一个聊天会话来重置上下文。