尝试以扩展 VS Code 中的代理模式!

Web 版 VS Code - 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-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 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 体验与 Azure AI Foundry 集成,使代码更贴近开发人员。在 VS Code for the Web 中打开等按钮可直接在 Chat PlaygroundAgent Playground 等环境中找到。有关更多信息,请参阅示例用例或场景部分。

开始使用

  1. 选择一个模型。
  2. 构建并测试您的代理。
  3. 选择 View Code,然后选择您的编程语言和 SDK。
  4. 使用网页版 在 VS Code 中打开 按钮,一键直接启动 VS Code。

此外,开发人员可以使用 AI App Gallery (https://aka.ms/aiapps) 中的模板开始,并选择 Open in VS Code,一键将他们的模板启动到 /azure 环境中。

开始使用

  1. 导航到 AI App Gallery (https://aka.ms/aiapps)
  2. 选择一个模板或搜索您想要运行的模板
  3. 从下拉菜单中选择 Open in 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. 满意后,选择 View Code 按钮,查看您与代理在代理操场中交互的上下文代码示例。

      Screenshot that shows view code button

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

      Screenshot that shows EntraID auth

    6. 准备就绪后,选择 Open in VS Code,您将被重定向到网页版 VS Code 的 /azure 环境。

      Screenshot that shows Open in VS Code button

      您会注意到,随着环境的设置,代码示例、API 终结点和密钥会自动导入到新的网页版 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 预配 Web 应用程序以创建相关的 Azure 资源。完成后,您可以通过选择终端中提供的链接在浏览器中看到您的应用程序正在运行。

      Screenshot that shows azd up

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

      Screenshot that shows Continue On button

  • 快速启动 Azure Function 应用

    上述快速入门适用于 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 扩展和 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 的任何问题。您可以通过转到“输出”视图,然后选择 VS Code for the Web - Azure 输出通道来访问它们。

Screenshot that shows Logs

Screenshot that shows Logs

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

反馈与支持

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