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

通过 AI + 远程开发提高生产力

2025年5月27日,由 Brigit MurtaughChristof MartiJosh SpicerOlivia Guzzardo McVicker 撰写

使 VS Code 如此灵活和强大的功能之一是远程开发。无论您是从本地桌面连接到安全的虚拟机,从平板电脑连接到功能强大的计算机,还是连接到包含项目所需所有依赖项的容器化环境——VS Code 在任何地方开发任何东西的能力几乎可以在任何设置中提供帮助。

现在,将这些功能与 VS Code 中 AI 的灵活性和强大功能相结合,您将拥有一个极其通用的开发环境。您可以确保聊天对话具有关于远程工作区的上下文,获得 AI 帮助来设置和调试远程连接,并为代理模式自主工作提供一个更隔离的空间。

在本博客中,我们将探讨如何增强您现有的远程设置,使其能够与 AI “无缝协作”,以及一些更定制化的 AI + 远程工作流,包括自定义指令、聊天参与者和代理自动批准。

什么是远程开发?

当我们描述 VS Code 远程开发时,我们指的是五种主要体验:

  • 远程 - SSH - 通过使用 SSH 打开远程机器/虚拟机上的文件夹来连接到任何位置。
  • 开发容器 - 在容器内部(或挂载到容器中)使用独立的工具链或基于容器的应用程序。
  • WSL - 在适用于 Linux 的 Windows 子系统中获得由 Linux 驱动的开发体验。
  • 远程 - 隧道 - 通过安全隧道连接到远程机器,无需配置 SSH。
  • GitHub Codespaces -为您托管的远程环境。

Remote architecture

如何在远程环境中使用 AI?

我们希望让 VS Code 中的 AI 编码体验尽可能无缝,无论您是在本地机器上工作还是连接到远程环境。如果您已经在本地使用 GitHub Copilot,我们会自动在远程为您安装它。GitHub Codespaces 也已配置好!

虽然在远程环境中使用 AI 可以直接工作,但还有其他 AI 功能可以使您的远程工作流更加强大:

  • 自定义指令 - 为您的远程环境量身定制 AI 体验
  • 聊天参与者 - 使用聊天来设置和排查您的远程环境
  • 工具批准 - 在远程环境中安全地运行自主编码会话

为您的远程环境量身定制 AI 体验

我们从用户那里听到的关于使用 LLM 的首要请求之一是:我如何帮助 LLM 更好地理解我的代码和编码实践?您可以通过自定义指令来实现这一点,这些指令描述了通用的准则或规则,以获得符合您特定编码实践和技术栈的响应。自定义指令会自动将此信息包含在每个聊天请求中,而无需在每个 AI 聊天查询中手动包含此上下文(在我们的近期博文中了解更多)。

在我们团队最近的自托管中,我们发现使用自定义指令不仅可以告诉 Copilot 关于我们的代码和编码实践,还可以提供有关我们连接的远程环境类型的更多信息,例如:

  • 这是什么样的远程环境(例如,开发容器还是虚拟机)?
  • 安装了哪些语言或工具链?它们的用途是什么?
  • 工具链安装在哪里(例如,它们是否在 PATH 中可用)?

这是我们团队发现有用的一个示例指令:

This is a dev container that includes `python3` and `pip3` pre-installed and available on the `PATH`, along with the Python language extensions for Python development.

要在远程环境中开始使用自定义指令,您可以在远程使用与本地相同的指令文件

为您的开发容器配置 AI

开发容器通过预先配置所有工具和依赖项,使项目入门变得更容易。通过添加自定义指令,您可以确保 LLM 针对该环境进行定制,而不是提供通用答案。例如,用于 Python 编码的开发容器可能有关于安装了哪些工具或应遵循哪些编码准则的自定义指令(如上例所示)。

我们的团队已采取措施预先配置自定义指令,以便您在使用开发容器时更加轻松。我们发布开发容器资源(如镜像和功能),以简化创建和连接到开发容器的过程,现在我们在这些文件中包含了自定义指令。以下是如何使用我们团队添加的自定义开发容器指令的示例:

  • 使用我们的一个镜像或功能创建一个新的开发容器配置。您可以手动执行此操作,也可以通过开发容器扩展提供的开发容器:添加开发容器配置文件...命令来执行。

    Dev Containers: Add Dev Container Configuration Files command in VS Code Command Palette

  • 按照快速选择中的步骤操作。对于此示例,我们将选择 Python 模板。

    Select Python 3 dev container config in VS Code Command Palette

  • 在 VS Code 中构建并连接到您的开发容器

    VS Code notification to reopen project in dev container

  • 您选择并现在连接到的环境基于我们的Python 模板,该模板通过 Python 功能包含自定义指令。尝试在您的开发容器中与 Copilot 聊天——Copilot 会自动从 Python 镜像中提取自定义指令!

    AI chat using custom instructions

除了使用我们添加到镜像和功能中的自定义指令外,您还可以在项目的 devcontainer.json 中添加额外的自定义指令——我们已经做到了让自定义指令可以成功地跨镜像和模板合并。您可以使用 "github.copilot.chat.codeGeneration.instructions" 设置,就像我们在上面描述的 Python 开发容器配置中所做的一样。

如果您发布任何开发容器配置供他人使用,我们建议您探索如何向其中添加自定义指令!这里是在 Python 开发容器功能中使用自定义指令的示例。

"github.copilot.chat.codeGeneration.instructions": [
    {
        "text": "This dev container includes `python3` and `pip3` pre-installed and available on the `PATH`, along with the Python language extensions for Python development."
    }
],

使用聊天来设置和排查您的远程环境

聊天参与者通过提供特定领域的知识来增强您的聊天体验,例如如何与数据库或特定 API 交互。在聊天输入字段中键入 @ 以查看并从可用参与者列表中选择——它们将在“询问”模式下可用。有几个内置的聊天参与者,如 @workspace@vscode@terminal。扩展也可以贡献聊天参与者。

远程 - SSH 扩展包含一个 Copilot 聊天参与者。向 @remote-ssh 寻求帮助以配置或排查您的远程环境元素。

Using Remote - SSH participant in VS Code chat panel

该参与者还了解常规的 SSH 和远程开发主题。

Asking Remote - SSH participant about remote auth

如果发生连接失败,使用 Copilot 诊断功能提供了一种快速了解问题的方法。

Diagnose with Copilot option in notification

Copilot 将调查问题并提供可操作的见解。

在远程环境中安全地运行自主编码会话

作为完成用户提示任务的一部分,代理模式可以运行工具和终端命令。代理模式之所以强大,是因为它不仅能提出代码更改建议,还能运行终端命令和工具。例如,它可以安装项目依赖项或运行测试。然而,其中一些操作可能是破坏性的,例如删除文件、修改本地配置等。因此,您需要批准在代理模式下使用工具和终端命令。

Agent mode tool approval options dropdown

如果您想自动批准所有工具,现在可以使用实验性的 chat.tools.autoApprove 设置。为了给您提供一定程度的保护,防止无意的终端命令或工具调用,您可以选择仅在开发容器或远程机器中设置此项,以防止您的本地开发机器受到影响。

Auto Approve tool setting in VS Code remote settings

这将自动批准所有工具,当语言模型希望运行工具时,VS Code 将不会请求确认。这可以通过赋予代理模式更多自主权来节省时间,但请记住,启用此设置后,您将没有机会取消模型想要执行的潜在破坏性操作。

请注意,作为您本地机器一部分的远程环境(如开发容器)或可以访问您凭据的远程环境将构成不同级别的风险。

下一步

我们对 VS Code 中远程开发和 AI 的未来感到兴奋。我们的月度发布充满了令人兴奋的新功能,我们也在不断展望未来,比如支持 Copilot Chat 在网页版vscode.devgithub.dev)中使用。

祝您编码愉快(智能且远程)!Brigit、Christof、Josh 和 Olivia