– 代理会话日,2月19日

Web 版 VS Code - Azure

VS Code for the Web 是 Visual Studio Code 的零安装、基于浏览器的版本。可通过 https://vscode.dev/azure 访问的 /azure (简称) 环境是一个专用于 Azure 开发的空间,让您可以在几秒钟内运行、调试和将应用程序部署到 Azure。

该环境由 Azure Cloud Shell 提供支持,提供高达 4 小时的计算时间,无需手动配置开发环境或安装依赖项。/azure 预装了最新的库、扩展和工具,让您立即开始编码。

VS Code for the Web Azure

入门

/azure 环境包含您开始开发和部署 Azure 应用程序所需的一切

预安装的扩展

Azure Developer CLI - 此扩展使您可以使用 Azure Developer CLI 更轻松地运行、创建 Azure 资源和部署 Azure 应用程序。

支持的编程语言

所有主要运行时均已预安装

  • Python - 3.12.9
  • Java - openjdk 17.0.16 2025-07-15 LTS
    • OpenJDK Runtime Environment Microsoft-11926113 (build 17.0.16+8-LTS)
    • OpenJDK 64-Bit Server VM Microsoft-11926113 (build 17.0.16+8-LTS, mixed mode, sharing)
  • Node.js - v20.14.0
  • C# - 9.0.304

GitHub 仓库

使用 GitHub Repository 扩展,您可以无缝地将更改提交到您的 GitHub 仓库。GitHub Repositories 允许您远程浏览和编辑仓库,而无需将代码拉取到本地机器。您可以在我们的 GitHub Repositories 指南中了解有关该扩展及其工作原理的更多信息。

继续在桌面 VS Code 中工作

在 Azure Cloud Shell 容器时间结束后,您可能希望在桌面 VS Code 中继续您的工作。使用位于 VS Code for the Web 状态栏中的 继续在...上工作 按钮,将您的代码提交到 GitHub 中选择的仓库,然后切换到您的本地环境。

在此体验中,您有两种本地继续使用的选项

  • 使用 Docker:启动预配置的开发容器。
  • 使用本地 VS Code:克隆仓库并使用 README 文件配置您的环境。

Azure 入口点

/azure 体验与 Microsoft Foundry 集成,以使代码更贴近开发人员。诸如 在 Web 版 VS Code 中打开 之类的按钮直接在 聊天游乐场代理游乐场 以及 Microsoft Foundry 主页 等环境中可用。请参阅示例用例或场景部分了解更多信息。

开始使用

  1. 选择一个模型。
  2. 构建并测试您的代理。
  3. 选择 查看代码,然后选择您的编程语言和 SDK。
  4. 使用 在 Web 版 VS Code 中打开 按钮以 一键方式启动到 VS Code。

或者,您可以从 Microsoft Foundry 主页创建代理

  1. 打开 Microsoft Foundry 主页 (https://ai.azure.com)
  2. 查看主页上生成的建议代码片段
  3. 选择 在 VS Code 中打开,以获得基于生成的代码创建代理的一键体验

此外,开发人员可以使用 AI 应用库 (https://aka.ms/aiapps) 从模板开始,并选择 在 VS Code 中打开,以在一项操作中将模板启动到 /azure 环境。

开始使用

  1. 导航到 AI 应用库 (https://aka.ms/aiapps)
  2. 选择一个模板或搜索您想要运行的模板
  3. 从下拉菜单中选择 在 VS Code 中打开
  4. 直接启动到 VS Code 并使用 GitHub Copilot 回答您可能遇到的任何问题。

我们还与 Azure 门户进行了集成。开发人员现在可以在生成代码时从 Azure Copilot 访问“在 VS Code 中打开”按钮。

开始使用

  1. 打开 Azure 门户 并使用您的 Azure 帐户登录
  2. 导航到 Azure Copilot 并开始开发您想要构建的场景
  3. 一旦 Copilot 生成了代码,请选择生成的代码文件,然后选择 在 VS Code 中打开
  4. 直接启动到 VS Code 并使用 GitHub Copilot 回答进一步的问题。

示例用例或场景

以下是 \azure 环境中常用的场景。

  • 使用 Microsoft Foundry 创建代理

    1. 访问 Microsoft Foundry NextGen 门户,并在为您的代理生成的代码旁边选择 在 VS Code 中打开
    2. 让 VS Code for the Web - Azure 环境初始化并设置您的环境
    3. 阅读 README 文件并按照步骤运行 create_and_run_agent.py 文件
    4. 您的代理已创建并成功运行!继续使用预安装的 Foundry 扩展来微调您的代理,或按照以下步骤使用您的代理创建应用程序
  • 使用 Microsoft Foundry 创建模型部署并在 VS Code 中打开您的代码

    1. 从 Microsoft Foundry 门户中,选择最适合您用例的模型,包括 Foundry Models 中的 o3、o4-mini 或 MAI-DS-R1。在此示例中,我们将使用 gpt-4o-mini 作为代理工作流的示例模型。

      Screenshot that shows Microsoft Foundry Portal

    2. 从 gpt-4o-mini 模型卡片中配置模型终结点。

      Screenshot that shows Microsoft Foundry Portal Model

    3. 进入代理游乐场,更改生成控制,例如最大响应和过去的消息。添加知识、工具和操作。

      Screenshot that shows model output

    4. 迭代您的示例提示并继续在代理游乐场中进行实验。

    5. 满意后,选择 查看代码 按钮,以查看与代理游乐场中代理交互的上下文代码示例。

      Screenshot that shows view code button

      在那里,您可以查看 Python、C# 和 JavaScript 的多语言代码示例,以及模型包含 JSON、cURL、JavaScript、C# 和 Go,Entra ID 可用于使用现在可用于模型的“密钥授权”对代理进行身份验证。

      Screenshot that shows EntraID auth

    6. 准备就绪后,选择 在 VS Code 中打开 并重定向到 VS Code for the Web 的 /azure 环境。

      Screenshot that shows Open in VS Code button

      您会注意到,随着环境的设置,代码示例、API 终结点和密钥会自动导入到新的 VS Code for the Web 工作区。

      Screenshot that shows loading dial

      在右下角,您会看到 API 密钥已设置在终端的环境变量中,并且代码示例已成功下载。

      Screenshot that shows loaded environment

    7. 通过 python agent_run.py 通过终端在本地运行模型。几秒钟内,您将看到成功的模型响应。

      Screenshot that shows agent python file

    8. 可以使用 azd 命令来配置和部署使用代理的 Web 应用程序。azd init 初始化 git 仓库,从而创建默认 Azure 工作区,代理可以在其中用于应用程序。

      Screenshot that shows azd init

    9. azd up 通过创建相关的 Azure 资源来配置 Web 应用程序。完成后,您可以选择终端中提供的链接在浏览器中查看您的应用程序

      Screenshot that shows azd up

    10. 通过选择左下角的“继续到桌面”,在桌面或 GitHub Desktop 上继续。此按钮允许您将工作区以一项操作移动到本地环境。如果您将开发容器附加到现有应用程序,您可以选择使用该容器或移动到本地环境。

      Screenshot that shows Continue On button

  • 启动快速 Azure 函数应用程序

    上述快速入门适用于 vscode.dev/azure,因为 vscode.dev/azure 涵盖了所有先决条件

    • 已安装 Python
    • 已安装 Azure Functions Core Tools
    • 您需要自行安装这些
    • Azure Functions 扩展
  • 使用 AI 工具包构建和测试 AI 代理

    主要功能

    • 具有丰富的生成式 AI 模型来源的模型目录 (GitHub、ONNX、OpenAI、Anthropic、Google、...)
    • 从远程托管模型或正在本地运行的 Ollama 模型导入您自己的模型
    • 用于模型推理或通过聊天进行测试的游乐场
    • 支持多模态语言模型的附件支持
    • 批量运行所选 AI 模型的提示
    • 使用支持的流行评估器(如 F1 分数、相关性、相似性、连贯性等)使用数据集评估 AI 模型
  • 使用 VS Code 扩展和 Python 进行快速原型设计

  • 使用 Azure Copilot 创建、编辑和部署代理

限制

虽然 Web 版 VS Code 几乎与桌面版 VS Code 相当,但开发环境存在一些限制

  • 无法访问 Cloud Shell 之外的终端
  • 对某些本机扩展或语言功能的有限支持
  • 不支持离线使用

故障排除

如果您在使用 VS Code for the Web – Azure 时遇到任何问题,请在我们的 GitHub 仓库中提交问题

连接问题

如果您无法连接到 https://vscode.dev/azure,通常可以通过重置您的 Azure Cloud Shell 来解决。这可以从 Azure 门户完成。

使用右上角按钮在 Azure 门户中打开 Cloud Shell。

Screenshot that shows Azure Portal

接下来,在设置下拉菜单中,选择 重置用户设置

Screenshot that shows Settings

完成后,您应该看到此屏幕。

Screenshot that shows Azure Cloud Shell

收集日志

扩展日志将帮助我们诊断 vscode.dev/azure 的任何问题。您可以通过转到输出视图,然后选择 VS Code for the Web - Azure 输出通道来访问它们。

Screenshot that shows Logs

Screenshot that shows Logs

继续学习和探索以下资源

反馈与支持

在您使用 vscode.dev/azure 时发现问题时,在我们的 GitHub 仓库中创建问题。细节越多越好。如果可能,请包含来自“VS Code for the Web - Azure”输出通道的日志。

© . This site is unofficial and not affiliated with Microsoft.