尝试以扩展 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 子系统 (WSL) 中获得由 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 扩展提供的 Dev Containers: 添加开发容器配置文件... 命令来完成。

    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。扩展程序也可以贡献聊天参与者。

Remote - 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 聊天(vscode.devgithub.dev)。

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