通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

准备开发环境

设置开发环境以使用 Microsoft Foundry SDK。 还需要Azure CLI进行身份验证，以便代码可以访问用户凭据。

在本文中，将安装语言运行时、Azure CLI、Azure Developer CLI、Foundry 的 VS Code 扩展以及 Git。

重要

本文仅介绍 一般先决条件 ，例如语言运行时、全局工具和 VS Code 和扩展设置。
它不包括特定于方案的步骤，如 SDK 安装或身份验证。
环境准备就绪后，请继续阅读 快速入门 ，了解这些说明。

先决条件

  • 具有活动订阅的Azure帐户。 如果没有订阅，请创建一个 free Azure 帐户，其中包括免费试用订阅。

  • 下载、安装和配置所选Visual Studio Code或 IDE。 有关详细信息，请参阅 Download Visual Studio Code。

  • 若要创建和管理 Foundry 资源，需要以下 Azure RBAC 角色之一。

    • Azure AI Project Manager（用于管理 Foundry 项目）
    • 所有者 （对于订阅级权限）。 所有者角色是 Foundry 中其他场景所需的额外角色分配所必需的。 为确保你在 Foundry 的所有场景中都不会遇到阻碍，所有者是所需的角色分配。

  • 若要使用Project但不创建新资源，至少需要：

    • 使用的项目上的 Azure AI 用户（用于开发的最低权限角色）

    有关每个角色的权限的详细信息，请参阅 Microsoft Foundry 的角色访问控制。

安装编程语言

在Visual Studio Code中，为项目创建新文件夹。 在该文件夹中打开终端窗口。

首先，创建新的Python环境。 不要将包安装到全局Python安装中。 安装Python包时，请始终使用虚拟或 conda 环境。 否则，可以中断Python的全局安装。

如果需要，请安装Python

使用 Python 3.10 或更高版本，但至少需要Python 3.9。 如果没有安装合适的Python版本，请按照 VS Code Python Tutorial 中的说明操作，在操作系统上安装Python的最简单方法。

创建虚拟环境

如果已安装 Python 3.10 或更高版本，请使用以下命令创建虚拟环境：

py -3 -m venv .venv
.venv\scripts\activate

激活Python环境时，从命令行运行 python 或 pip 使用应用程序的 .venv 文件夹中的 Python 解释器。

注释

使用 deactivate 命令退出Python虚拟环境。 稍后可以根据需要重新激活它。

安装用于Visual Studio Code的 Python 扩展

Visual Studio Code 的 Python 扩展支持 Python 语言的 IntelliSense、调试、格式化、代码检查、代码导航、代码重构、变量资源管理器、测试资源管理器和环境管理功能。

为 Visual Studio Code 安装 Python 扩展。

安装：

  • Java开发工具包 （JDK） 17 或更高版本

安装适用于 Java 的 Visual Studio Code 扩展包

适用于 Java 的扩展包是一组常用扩展，可帮助在 Visual Studio Code 中编写、测试和调试Java应用程序。

为 Java 安装 Visual Studio Code 扩展包。

安装 Node.js （建议使用版本 20 或更高版本）。

确保已安装用于.NET开发所需的工具。

安装.NET SDK

需要.NET SDK（软件开发工具包）来创建、生成和运行.NET应用程序。 如果project需要，建议安装最新的 LTS（长期支持）版本或更高版本。

  1. 从 官方.NET下载页面下载 .NET SDK。 为操作系统（Windows、Linux 或 macOS）选择适当的安装程序。

  2. 按照操作系统的安装说明进行操作。

  3. 通过打开终端或命令提示符并运行来验证安装：

    dotnet --version

    响应应为已安装的 SDK 版本。

安装适用于 Visual Studio Code 的 C# 开发工具包

若要在 VS Code 中获得最佳 C# 开发体验，请安装官方 C# 开发工具包扩展：

  1. 打开Visual Studio Code。
  2. 转到“扩展”视图（Ctrl+Shift+X 或 Cmd+Shift+X）。
  3. 搜索 C# 开发工具包。
  4. 安装由Microsoft发布的扩展。 如果您还没有基本的 C# 扩展，它也会随之安装。

创建新的.NET Project

可以使用集成到 Visual Studio Code 的终端（终端 > 新终端）创建新的.NET项目。

例如，若要创建新的控制台应用程序，请执行以下作：

# Navigate to the directory where you want to create your project
# cd path/to/your/projects

# Create a new console application in a subfolder named MyConsoleApp
dotnet new console -o MyConsoleApp

# Navigate into the newly created project folder
cd MyConsoleApp

现在可以在 VS Code 中打开此 MyConsoleApp 文件夹（文件 >打开文件夹...），开始处理 C# project。 使用 C# 开发工具包扩展的 VS Code 会自动检测项目，从而启用 IntelliSense、调试和生成任务等功能。

安装Azure CLI并登录

安装 Azure CLI 并从本地开发环境登录，以便代码可以使用用户凭据通过 Foundry 调用Azure服务。

在大多数情况下，可以使用以下命令从终端安装Azure CLI：

winget install -e --id Microsoft.AzureCLI

如果这些命令不适用于您的特定操作系统或设置，可以按照如何安装Azure CLI的说明进行操作。

安装Azure CLI后，请使用 az login 命令登录并使用浏览器登录：

az login

或者，可以使用设备代码通过浏览器手动登录。

az login --use-device-code

使此终端保持打开状态，以在登录后运行脚本。

安装Azure开发人员 CLI

Azure开发人员 CLI（azd）是一种开源工具，可帮助你在Azure上设置和部署应用资源。 无论使用终端、IDE 还是 CI/CD pipelines，它都为开发的关键阶段提供了简单的命令。 为平台安装Azure开发人员 CLI。

许多 AI 解决方案模板 都包括一个使用 azd部署选项。

安装 Foundry VS Code 扩展

通过适用于 Visual Studio Code 的 Foundry 扩展，你可以直接从 VS Code 接口部署模型、生成 AI 应用和使用代理。 安装 Foundry VS Code 扩展。

安装 Git

克隆 Foundry SDK 示例需要 Git。 如果没有安装 Git，请根据您的平台说明并选择操作系统。

故障排除

問题 决议
安装后找不到命令 关闭并重新打开终端，或重启 VS Code，使 PATH 更改生效。
az login 失败并出现浏览器错误 改为运行 az login --use-device-code 以使用设备代码流进行身份验证。
找不到Python 使用python3替代python，在macOS/Linux上，或者安装受支持的版本（3.9或更新版本）。
安装期间权限被拒绝 在 macOS/Linux 上，请避免 sudo pip install。 请改用 虚拟环境 。

相关内容

  • 开始使用 Foundry
  • Last updated on