尝试以扩展 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 存储库允许您从编辑器中远程浏览和编辑存储库,而无需将代码拉取到本地计算机。您可以在我们的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 中打开”等按钮直接在“聊天游乐场”和“代理游乐场”等环境中提供。请参阅示例用例或场景部分了解更多信息。

开始使用

  1. 选择一个模型。
  2. 构建并测试您的代理。
  3. 选择“查看代码”,然后选择您的编程语言和 SDK。
  4. 通过“在 VS Code 中打开”按钮直接启动 VS Code for the Web,一键完成。

此外,开发人员可以使用 AI App Gallery (https://aka.ms/aiapps) 中的模板,然后选择“在 VS Code 中打开”,即可一键将其模板启动到 /azure 环境中。

开始使用

  1. 导航到 AI App Gallery (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 中打开”并重定向到 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. 通过选择左下角的“继续在桌面版”按钮,继续在桌面版 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”输出通道的日志。