尝试以扩展 VS Code 中的代理模式!

管理 AI 上下文

通过提供正确的上下文,你可以从 VS Code 中的 AI 获得更相关和准确的响应。在本文中,你将学习如何管理聊天中的上下文,包括如何使用 #-提及来引用文件、文件夹和符号,如何引用 Web 内容,或者如何使用自定义指令来引导 AI 的响应。

隐式上下文

VS Code 会根据你当前的活动自动为聊天提示提供上下文。以下信息会隐式包含在聊天上下文中

  • 活动编辑器中当前选定的文本。
  • 活动编辑器的文件名或笔记本名称。
  • 如果你正在使用询问模式编辑模式,活动文件会自动作为上下文包含进来。

Screenshot of the Chat view, showing the active file as a suggested context item in the chat input box.

如果你正在使用代理模式,代理工具会自动确定是否需要将活动文件添加到聊天上下文中。

#-提及

在聊天中,你可以通过输入 # 后跟你想提及的上下文项来显式引用上下文。这使得 AI 能够根据你引用的特定上下文提供更相关的响应。

在聊天输入框中输入 # 符号以查看可用的上下文项列表。

Screenshot of VS Code Chat view, showing the chat variable picker.

要引用特定的工作区文件、文件夹或代码符号,请输入 # 后跟文件名、文件夹名或符号名。了解更多关于在聊天中引用文件和文件夹的信息。

或者,从可用的预定义上下文项列表中选择,例如 #changes 来获取已更改文件的差异,或 #codebase 来在你的工作区中执行代码库搜索。

请确保启用 github.copilot.chat.codesearch.enabled (预览) 设置以获得最佳结果。

在速查表的聊天变量部分查看支持的上下文项的完整列表。

提示示例

以下示例展示了如何在你的聊天提示中使用 #-提及

引用你待处理的源代码控制更改
  • "总结 #changes"
  • "基于 #changes 生成发布说明"
理解代码库
  • "解释 #codebase 中的身份验证如何工作"
  • "数据库连接字符串在哪里配置?#codebase"
  • "我该如何构建这个 #codebase?"
  • "#getUser 在哪里被使用?#usages"
生成与你的代码库一致的代码
  • "创建一个关于页面并将其包含在导航栏中 #codebase"
  • "为更新地址信息添加一个新的 API 路由 #codebase"
  • "添加一个登录按钮并根据 #styles.css 进行样式设置"
修复工作区中的问题
  • "修复 #problems 中的问题"
  • "修复失败的测试 #testFailure"
获取有关扩展的信息
  • "这个工作区的顶级 #extensions 是什么?"
引用来自 Web 的内容
  • "在 React 18 中如何使用 'useState' 钩子?#fetch https://18.reactjs.ac.cn/reference/react/useState#usage"
  • "构建一个 API 端点来获取地址信息,使用来自 #githubRepo contoso/api-templates 的模板"

添加文件作为上下文

要让 AI 自动在你的工作区中找到相关的文件和符号,你可以使用 #codebase。要提供特定的文件、文件夹或符号作为上下文,请使用以下方法将它们添加到聊天中

Screenshot of the Chat view, showing a prompt that references a file from the workspace.

  • 在你的聊天消息中通过输入 # 后跟文件、文件夹或符号的名称来 #-提及它们。要引用一个符号,请确保首先在编辑器中打开包含该符号的文件。

  • 将文件或文件夹从资源管理器视图、搜索视图或编辑器标签页拖放到聊天视图中,以将它们添加为上下文。

  • 在聊天视图中使用**添加上下文**按钮,并选择**文件和文件夹**或**符号**。

注意

如果可能,附加文件时将包含其全部内容。如果文件太大无法放入上下文窗口,则会包含一个文件大纲,其中包括函数及其描述,但不包括实现。如果大纲也太大,那么该文件将不会成为提示的一部分。

你可以让 VS Code 自动从你的代码库中找到正确的文件,而不是手动添加单个文件。当你不确定哪些文件与你的问题相关时,这会很有用。

在你的提示中添加 #codebase 或选择**添加上下文** > **工具** > **codebase** 来为你的工作区启用代码搜索。

以下提示示例展示了如何使用代码库搜索

  • "解释 #codebase 中的身份验证如何工作"
  • "数据库连接字符串在哪里配置?#codebase"
  • "为更新地址添加一个新的 API 路由 #codebase"

请确保启用 github.copilot.chat.codesearch.enabled (预览) 设置以获得最佳结果。

引用 Web 内容

你可以在聊天提示中引用 Web 内容,例如获取最新的 API 参考或代码示例。

  • #fetch:使用此工具从特定网页检索内容,例如某个框架特定版本的文档页面。要使用此工具,请输入 #fetch 后跟你要引用的页面的 URL。

    • "VS Code 1.100 的亮点是什么 #fetch https://vscode.js.cn/updates/v1_100"
    • "将 asp.net 应用更新到 .net 9 #fetch https://learn.microsoft.com/zh-cn/aspnet/core/migration/80-90"
  • #githubRepo:使用此工具在 GitHub 仓库中执行代码搜索,例如引用其他项目的代码模式或示例。输入 #githubRepo 后跟仓库名称(例如,microsoft/vscode-docs)。

    • "next.js 中的路由是如何工作的 #githubRepo vercel/next.js"
    • "执行代码审查以验证其是否与 #githubRepo microsoft/typescript 一致"
    • "为我的应用添加单元测试。使用与 #githubRepo rust-lang/rust 相同的测试设置和结构"

引用工具

VS Code 中的聊天有几个内置工具,你还可以通过MCP 服务器或扩展来进一步扩展它。例如,#fetch 工具是一个内置工具,允许你从网页获取内容。你还可以将工具分组到工具集中,然后在你的聊天提示中引用它们。

要直接在你的聊天提示中引用一个工具或工具集,请输入 # 后跟工具(集)名称和可选的工具参数。以下提示示例展示了如何使用工具

  • 使用 GitHub MCP 服务器工具(在你的 mcp.json 中配置为 github-mcp

    • "我有哪些未解决的问题 #github-mcp"
    • "为 contoso/tailwindtraders 中的问题 #123 实现一个修复 #github-mcp"
    • "microsoft/vscode-docs 中的 PR 8407 是关于什么的?#github-mcp"
  • 使用 #postgres MCP 服务器查询 PostgreSQL 数据库

    • "生成一个 API 端点和数据访问层,用于从 #postgres 获取天气数据"
    • "#postgres 中公司名称的最大长度是多少"

@-提及

聊天参与者是专门的助手,使你能够在聊天中提出特定领域的问题。可以把聊天参与者想象成一个领域专家,你将聊天请求交给他,他会处理剩下的事情。

聊天参与者与作为代理流程一部分被调用以贡献和执行特定任务的工具不同。

你可以通过 @-提及来调用聊天参与者:输入 @ 后跟参与者名称。VS Code 有几个内置的聊天参与者,如 @vscode@terminal@workspace。它们经过优化,可以回答各自领域的问题。

以下示例展示了如何在你的聊天提示中使用 @-提及

  • "@vscode 如何启用自动换行"
  • "@terminal 当前目录中最大的 5 个文件是什么"

在聊天输入框中输入 @ 以查看可用的聊天参与者列表。

扩展也可以贡献它们自己的聊天参与者

从 VS Code 简单浏览器添加元素(实验性)

VS Code 有一个内置的简单浏览器,你可以用它来查看和与本地托管的 Web 应用程序交互,例如对你的 Web 应用程序进行快速测试和调试。

你可以将简单浏览器窗口中的元素作为上下文添加到你的聊天提示中。要做到这一点

  1. 请确保通过 chat.sendElementsToChat.enabled 设置来启用从简单浏览器中选择元素。

  2. 在本地运行你的 Web 应用程序。

  3. 通过从命令面板运行**简单浏览器:显示**命令来打开简单浏览器视图。

  4. 选择**开始**按钮以开始从当前页面选择元素。

  5. 将鼠标悬停在网页的元素上并点击以将它们添加到聊天提示中。

    请注意,所选元素已作为上下文添加到当前聊天提示中。

你可以配置上下文中包含哪些信息

提示

此功能在实时预览扩展(预发布版)中也可用。

聊天历史

VS Code 中的聊天被设计为多轮对话。在聊天会话中,VS Code 使用对话历史作为你当前提示的上下文。这意味着你可以提出后续问题或澄清你之前的问题,而无需重复上下文。

要重新开始一个新的聊天会话并丢弃当前上下文,请在聊天视图中选择**新聊天**(+)按钮(⌘N (Windows, Linux Ctrl+N))。如果你想切换到不同的话题并避免之前的上下文和历史,这会很有用。

了解更多关于聊天历史和上下文管理的信息。

自定义指令

通过指令文件,你可以为 AI 提供通用的指导方针和规则,以生成符合你编码风格和偏好的响应。指令文件是 Markdown 文件,你可以在你的工作区或当前配置文件中创建。

通过使用指令文件,你可以避免在聊天提示中重复添加通用指令,而是让 AI 自动将这些指令应用于你的聊天交互。

了解更多关于使用指令文件的信息。

工作区索引

VS Code 使用一个索引来快速准确地在你的代码库中搜索相关的代码片段。这个索引可以由 GitHub 维护,也可以存储在你的本地机器上。

以下工作区索引选项可用

  • 远程索引:如果你的代码托管在 GitHub 仓库中,你可以构建一个远程索引来快速搜索你的代码库,即使是大型代码库也一样。
  • 本地索引:使用存储在你本地机器上的高级语义索引,为你的代码库提供快速准确的搜索结果。
  • 基本索引:如果本地索引不可用,你可以使用经过优化的更简单的算法,以便在本地为大型代码库工作。

了解更多关于工作区索引的信息。