Web 版 VS Code - Azure
VS Code for the Web 是 Visual Studio Code 的零安装、基于浏览器的版本。/azure(简称)环境可通过https://insiders.vscode.dev/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-Bit Server 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 集成,使代码更贴近开发人员。诸如在 VS Code for the Web 中打开之类的按钮直接在聊天平台和代理平台等环境中可用。请参阅示例用例或场景部分以了解更多信息。
开始使用
- 选择模型。
- 构建和测试您的代理。
- 选择查看代码,然后选择您的编程语言和 SDK。
- 点击在 VS Code 中打开按钮即可直接启动 VS Code for the Web,一键完成。
此外,开发人员可以使用 AI 应用库(https://aka.ms/aiapps)开始使用模板,并选择在 VS Code 中打开,以便一次性将他们的模板启动到/azure环境。
开始使用
- 导航到 AI 应用库(https://aka.ms/aiapps)
- 选择一个模板或搜索您想要运行的模板
- 从下拉菜单中选择在 VS Code 中打开
- 直接启动 VS Code,并使用 GitHub Copilot 回答您可能有的任何问题。
示例用例或场景
以下是\azure环境的常用场景。
-
使用 Azure AI Foundry 创建模型部署并在 VS Code 中打开您的代码
-
在 Azure AI Foundry 门户中,为您的用例选择最佳模型,包括 Foundry 模型中的 o3、o4-mini 或 MAI-DS-R1。在此案例中,我们将使用 gpt-4o-mini 作为代理工作流的示例模型。

-
从 gpt-4o-mini 模型卡中预配模型端点。

-
进入代理平台,更改生成控制,如最大响应和历史消息。添加知识、工具和操作。

-
在代理平台中迭代您的示例提示并继续实验。
-
满意后,选择查看代码按钮以查看您在代理平台中与代理交互的上下文代码示例。

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

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

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

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

-
通过终端运行模型,命令为
python agent_run.py。几秒钟内,您将看到成功的模型响应。
-
azd命令可用于使用代理预配和部署 Web 应用程序。azd init初始化 git 仓库,这将创建一个默认的 Azure 工作区,在该工作区中可以使用代理。
-
azd up预配 Web 应用程序以创建相关的 Azure 资源。完成后,您可以通过选择终端中提供的链接在浏览器中查看您的应用程序运行情况。
-
通过选择左下角的“在桌面版上继续”来在桌面版 VS Code 或 GitHub Desktop 中继续。此按钮允许您一键将工作区移动到您的本地环境。如果您的现有应用程序附加了开发容器,您可以选择使用该容器或移动到本地环境。

-
-
上述快速入门适用于 vscode.dev/azure,因为 vscode.dev/azure 涵盖了所有先决条件。
- 已安装 Python
- 已安装 Azure Functions Core Tools
- 您需要自行安装这些
- Azure Functions 扩展
-
使用 Azure AI Toolkit 构建和测试 AI 代理
主要功能
- 模型目录,包含丰富的生成式 AI 模型来源(GitHub、ONNX、OpenAI、Anthropic、Google 等)
- 自带远程托管模型或本地运行的 Ollama 模型
- 用于模型推理或通过聊天进行测试的平台
- 多模态语言模型的附件支持
- 批量运行选定 AI 模型的提示
- 使用数据集评估 AI 模型,支持流行的评估器,如 F1 分数、相关性、相似性、连贯性等
限制
尽管 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。

连接问题
如果您无法连接到https://insiders.vscode.dev/azure,通常可以通过重置 Azure Cloud Shell 来解决。这可以在 Azure 门户中完成。
使用右上角的按钮在 Azure 门户中打开 Cloud Shell。

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

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

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


相关资源
通过以下资源继续学习和探索
反馈和支持
在使用 vscode.dev/azure 时发现问题,请在我们的GitHub 仓库中创建问题。细节越详细越好。如果可能,请包含来自“VS Code for the Web - Azure”输出通道的日志。