在 VS Code 中试用

VS Code for the Web - Azure

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

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

入门

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

预安装的扩展

Azure Developer CLI - 此扩展使使用 Azure Developer CLI 运行、创建 Azure 资源和部署 Azure 应用程序变得更加容易。

支持的编程语言

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

  • Python - 3.12.9
  • Java - openjdk 17.0.14 2025-01-21 LTS
    • OpenJDK Runtime Environment Microsoft-10800290 (build 17.0.14+7-LTS)
    • OpenJDK 64 位服务器 VM Microsoft-10800290 (build 17.0.14+7-LTS, mixed mode, sharing)
  • Node.js - v20.14.0
  • C# - 9.0.0

GitHub 存储库

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

继续在桌面版 VS Code 中工作

当 Azure Cloud Shell 容器时间用完后,您可能希望继续在桌面版 VS Code 中工作。使用位于 VS Code for the Web 状态栏中的“继续工作”按钮,将您的代码提交到选定的 GitHub 存储库,并切换到您的本地环境。

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

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

Azure 入口点

/azure 体验与 Azure AI Foundry 集成,使代码更贴近开发人员。在“聊天操场”和“代理操场”等环境中,可以直接使用“在 Web 版 VS Code 中打开”等按钮。更多详情请参阅示例用例或场景部分。

开始使用

  1. 选择一个模型。
  2. 构建并测试您的代理。
  3. 选择“查看代码”,然后选择您的编程语言和 SDK。
  4. 单击“在 Web 版 VS Code 中打开”按钮,直接启动 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 AI Foundry 创建模型部署并在 VS Code 中打开您的代码

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

      Screenshot that shows Azure AI Foundry Portal

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

      Screenshot that shows Azure AI 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 中打开”,即可重定向到 Web 版 VS Code 的 /azure 环境。

      Screenshot that shows Open in VS Code button

      您会注意到,当环境设置完成后,代码示例、API 终结点和密钥会自动导入到新的 Web 版 VS Code 工作区中。

      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. 通过选择左下角的“在桌面版上继续”按钮,继续在桌面版 VS Code 或 GitHub Desktop 中工作。此按钮允许您一键将工作区移动到本地环境。如果您有一个开发容器附加到现有应用程序,您可以选择使用该容器或移动到本地环境。

      Screenshot that shows Continue On button

  • 快速启动 Azure 函数应用

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

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

    主要特点

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

限制

尽管 VS Code for the Web 与桌面版 VS Code 几乎功能相同,但开发环境仍有一些限制

  • 除了 Cloud Shell,没有终端访问权限
  • 对某些本机扩展或语言功能的支持有限
  • 不支持离线

故障排除

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

账户类型提示问题

如果您看到提示“您使用哪种类型的账户来启动此隧道?”,则很可能您在使用 vscode.dev/azure 而非 insiders.vscode.dev/azure。目前此产品仅在 Insiders 上可用。要解决此问题,请导航至 https://insiders.vscode.dev/azure

Screenshot that shows Account Type

连接问题

如果您无法连接到 https://insiders.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 的任何问题。您可以通过转到“输出”视图,然后选择“Web 版 VS Code - Azure”输出通道来访问它们。

Screenshot that shows Logs

Screenshot that shows Logs

通过以下资源继续学习和探索

反馈和支持

在使用 vscode.dev/azure 时发现问题,请在我们的 GitHub 仓库中创建问题。细节越详细越好。如果可能,请附上“Web 版 VS Code - Azure”输出通道的日志。