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 中打开”等按钮。更多详情请参阅示例用例或场景部分。
开始使用
- 选择一个模型。
- 构建并测试您的代理。
- 选择“查看代码”,然后选择您的编程语言和 SDK。
- 单击“在 Web 版 VS Code 中打开”按钮,直接启动 VS Code。
此外,开发人员可以使用 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 Models 中的 o3、o4-mini 或 MAI-DS-R1。在此示例中,我们将使用 gpt-4o-mini 作为代理工作流的示例模型。
-
从 gpt-4o-mini 模型卡中预配模型终结点。
-
进入代理操场,更改最大响应数和历史消息等生成控制。添加知识、工具和操作。
-
在代理操场中迭代您的示例提示并继续实验。
-
满意后,选择“查看代码”按钮,查看您在代理操场中与代理交互的上下文代码示例。
在那里,您可以看到代理的多语言代码示例(Python、C# 和 JavaScript),以及模型的多语言代码示例(JSON、cURL、JavaScript、C# 和 Go),现在可以使用“密钥授权”对模型进行 Entra ID 身份验证。
-
准备就绪后,选择“在 VS Code 中打开”,即可重定向到 Web 版 VS Code 的 /azure 环境。
您会注意到,当环境设置完成后,代码示例、API 终结点和密钥会自动导入到新的 Web 版 VS Code 工作区中。
在右下角,您会看到 API 密钥已设置在终端的环境变量中,并且示例代码已成功下载。
-
通过终端使用
python agent_run.py
在本地运行模型。几秒钟内,您将看到成功的模型响应。 -
azd
命令可用于预配和部署使用代理的 Web 应用。azd init
初始化 Git 仓库,创建默认的 Azure 工作区,其中代理可在应用程序中使用。 -
azd up
通过创建相关的 Azure 资源来预置 Web 应用。完成后,您可以通过选择终端中提供的链接在浏览器中查看您的应用程序。 -
通过选择左下角的“在桌面版上继续”按钮,继续在桌面版 VS Code 或 GitHub Desktop 中工作。此按钮允许您一键将工作区移动到本地环境。如果您有一个开发容器附加到现有应用程序,您可以选择使用该容器或移动到本地环境。
-
-
上述快速入门适用于 vscode.dev/azure,因为 vscode.dev/azure 涵盖了所有先决条件
- 已安装 Python
- 已安装 Azure Functions Core Tools
- 您需要自行安装这些
- Azure Functions 扩展
-
主要特点
- 模型目录,包含丰富的生成式 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 的任何问题。您可以通过转到“输出”视图,然后选择“Web 版 VS Code - Azure”输出通道来访问它们。
相关资源
通过以下资源继续学习和探索
反馈和支持
在使用 vscode.dev/azure 时发现问题,请在我们的 GitHub 仓库中创建问题。细节越详细越好。如果可能,请附上“Web 版 VS Code - Azure”输出通道的日志。