本站点文档内容均翻译自code.visualstudio.com,仅供个人学习,如有差异请以官网为准。

聊天调试视图

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

此视图对扩展开发人员、MCP服务器作者以及希望排除意外AI行为或优化其提示的高级用户很有用。

何时使用聊天调试视图

使用 Chat 调试视图,当您想要:

  • 了解为什么人工智能给出了意外的回应:检查上下文和系统提示,看看模型接收到什么信息。
  • 验证发送了哪个上下文:确认工作区文件,#-提到,或工具输出包含在请求中。
  • 调试MCP服务器或扩展工具:查看工具是否被调用,它们接收到什么输入,以及它们返回了什么。
  • 优化提示:审查发送给模型的完整提示,以确定更清晰的说明或更好的上下文的机会。

打开聊天调试视图

要打开聊天调试视图:

  • 在聊天中选择溢出菜单并选择显示聊天调试视图

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

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

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

阅读调试输出

每个 Chat Debug 视图中的交互都包含可展开的部分。下表描述了每个部分显示的内容以及需要查找的内容:

部分 显示内容 查找内容
系统提示 定义AI行为、能力和限制的说明。 验证自定义指令或代理描述是否正确显示。
用户提示 您发送给模型的确切提示文本。 确认您的提示已按预期发送,包括任何#-提及已解决为实际内容。
上下文 与请求相关的文件、符号和其他上下文项。 检查预期的文件和上下文是否出现。如果文件缺失,可能是因为没有被索引或者上下文Windows已满。
响应 模型完整回复,包括推理过程。 查看原始响应以了解模型如何解释您的请求。
工具响应 请求期间调用工具的输入和输出。 验证工具接收正确的输入并返回预期的输出。对调试MCP服务器很有帮助。

您可以展开每个部分以查看全部详细信息。这在使用代理时特别有用,因为多个工具可能会在单个请求的一部分中被调用。

常见故障排除场景

人工智能会忽略你的工作区文件

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

  1. 打开聊天调试视图并检查上下文部分。
  2. 验证工作区文件是否出现在上下文中。如果没有,请检查工作区索引是否启用。
  3. 尝试添加明确的#-提及(例如#文件#代码库) 确保包含正确的文件。了解更多关于 管理上下文的信息。

MCP工具未被调用

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

  1. 查看系统提示部分,以验证该工具是否列在可用工具中。
  2. 如果工具缺失,请验证MCP服务器是否正在运行并且配置正确。
  3. 请明确提到该工具#工具名称在你的提示中。

AI回复不完整或被截断

如果响应显示被截断:

  1. 查看上下文部分以了解总代币使用情况。
  2. 一个完整的上下文Windows可能会导致模型截断其回复。开始一个新的聊天会话来重置上下文。