设置开发环境

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

先决条件

安装编程语言

在所选的 IDE 中,为项目创建新文件夹。 在该文件夹中打开终端窗口。

首先需要创建新的 Python 环境。 请勿将包安装到你的全局 Python 安装中。 安装 Python 包时,应始终使用虚拟或 conda 环境,否则可能会中断 Python 的全局安装。

如果需要,请安装 Python

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

创建虚拟环境

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

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

激活 Python 环境意味着当你从命令行运行 pythonpip 时,将使用位于你应用程序 .venv 文件夹中的 Python 解释器。

注释

可以使用 deactivate 命令退出 python 虚拟环境,并在需要时重新激活它。

安装:

  • Java 开发工具包 (JDK) 17 或更高版本

安装 Node.js

确保已安装用于 .NET 开发的必要工具。

安装 .NET SDK

需要 .NET SDK(软件开发工具包)来创建、生成和运行 .NET 应用程序。 如果项目需要,建议安装最新的 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 项目

可以使用集成到 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# 项目。 使用 C# 开发工具包扩展的 VS Code 会自动检测项目,启用 IntelliSense、调试和生成任务等功能。

安装 Azure CLI 并登录

安装 Azure CLI 并从本地开发环境登录,以便可以使用用户凭据在 Azure AI Foundry 模型中调用 Azure OpenAI。

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

winget install -e --id Microsoft.AzureCLI

如果这些命令不适用于特定操作系统或设置,则可以遵循说明如何安装 Azure CLI

安装 Azure CLI 后,使用 az login 命令登录并使用浏览器登录:

az login

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

az login --use-device-code

使此终端窗口保持打开状态,以便从此处运行脚本,现在你已登录。

后续步骤