共用方式為


準備開發環境

設定你的開發環境以使用 Microsoft Foundry SDK。 您也需要 Azure CLI 進行驗證,讓您的程式代碼可以存取您的用戶認證。

這很重要

本文僅涵蓋 一般必要條件 ,即語言執行階段、全域工具、VS Code 和延伸模組設定。
包括 SDK 安裝或身份驗證等特定場景步驟。
當您的環境準備就緒後,請繼續移至快速入門以取得那些指示。

先決條件

安裝您的程式設計語言

在 Visual Studio Code 中,為您的專案建立新的資料夾。 在該資料夾中開啟終端機視窗。

首先,您需要建立新的 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 虛擬環境,並可以稍後視需要重新啟用它。

安裝 Visual Studio Code 的 Python 延伸模組

Visual Studio Code 的 Python 延伸模組支援具有 IntelliSense、偵錯、格式設定、linting、程式碼導覽、重構、變數總管、測試總管和環境管理的 Python。

安裝 Visual Studio Code 的 Python 延伸模組

安裝:

安裝適用於 Java 的 Visual Studio Code 擴充功能套件

Java 擴充套件是熱門擴充功能的集合,可協助在 Visual Studio Code 中撰寫、測試和偵錯 Java 應用程式。

安裝適用於 Java 的 Visual Studio Code 擴充功能套件

安裝 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# 專案。 VS Code 具有 C# 開發工具包擴充功能,會自動偵測專案,啟用 IntelliSense、偵錯和建置工作等功能。

安裝 Azure CLI 並登入

你安裝 Azure CLI 並從本地開發環境登入,這樣你就能用使用者憑證呼叫 Microsoft Foundry Models 中的 Azure OpenAI。

在大部分情況下,您可以使用下列命令,從終端機安裝 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 管道。 為您的平台安裝 Azure 開發人員 CLI

安裝 The Foundry VS Code 擴充套件

Visual Studio Code 的 Foundry 擴充功能讓你能直接從 VS Code 介面部署模型、建構 AI 應用程式,並操作代理。 安裝 Foundry VS Code 擴充功能

安裝 Git

許多 Microsoft Foundry SDK 範例使用 Git 進行版本控制。 如果您尚未安裝 Git,請 按照您平台的說明進行操作 ,然後選擇您的作業系統。

後續步驟