設定你的開發環境以使用 Microsoft Foundry SDK。 您也需要 Azure CLI 進行驗證,讓您的程式代碼可以存取您的用戶認證。
這很重要
本文僅涵蓋 一般前置條件 ,例如語言執行環境、全域工具,以及 VS Code 與擴充功能的設定。
它沒有涵蓋特定情境步驟,例如安裝 SDK 或驗證。
當您的環境準備就緒後,請繼續移至快速入門以取得那些指示。
先決條件
-
具有有效訂閱的 Azure 帳戶。 如果您沒有,請建立 免費的 Azure 帳戶,其中包含免費試用訂用帳戶。
下載、安裝並設定 Visual Studio Code,或你選擇的 IDE。 如需詳細資訊,請參閱下載 Visual Studio Code。
請擔任以下 Azure RBAC 職務之一,以建立和管理 Foundry 資源:
- Azure AI User (開發中最低權限角色)
- Azure AI 專案經理 (用於管理 Foundry 專案)
- 貢獻者或擁有者(用於訂閱層級權限)
關於每個角色權限的詳細資訊,請參見 Microsoft Foundry 的角色基礎存取控制。
安裝您的程式設計語言
在 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 環境時,執行 python 或 pip 從命令列執行時,會使用存放在你應用程式資料夾的 .venv 中的 Python 直譯器。
備註
使用指令 deactivate 退出 Python 虛擬環境。 你需要時可以再重新啟用。
安裝 Visual Studio Code 的 Python 延伸模組
Visual Studio Code 的 Python 延伸模組支援具有 IntelliSense、偵錯、格式設定、linting、程式碼導覽、重構、變數總管、測試總管和環境管理的 Python。
安裝:
- Java 開發工具套件 (JDK) 17 或更新版本
安裝適用於 Java 的 Visual Studio Code 擴充功能套件
Java 擴充套件是一系列受歡迎的擴充套件,能幫助你在 Visual Studio Code 中撰寫、測試及除錯 Java 應用程式。
安裝 Node.js。
請確定您已安裝用於 .NET 開發的必要工具。
安裝 .NET SDK
您需要 .NET SDK (軟體開發工具包)來建立、建置和執行 .NET 應用程式。 建議您視專案需要安裝最新的 LTS(長期支援)版本或更新版本。
從 官方 .NET 下載頁面下載 .NET SDK。 為您的作系統選取適當的安裝程式(Windows、Linux 或macOS)。
請遵循您的操作系統的安裝指引。
請開啟終端機或命令提示字元,並執行以下指令以確認安裝是否成功:
dotnet --version回應應該是已安裝的 SDK 版本。
安裝適用於 Visual Studio Code 的 C# 開發工具包
如需 VS Code 中最佳的 C# 開發體驗,請安裝官方 C# 開發工具包擴充功能:
- 開啟 Visual Studio Code。
- 移至 [延伸模組] 檢視 (Ctrl+Shift+X 或 Cmd+Shift+X)。
- 搜尋 C# 開發工具組。
- 安裝由 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。
許多 AI 解決方案範本 包含一個使用 azd 的部署選項。
安裝 The Foundry VS Code 擴充套件
Visual Studio Code 的 Foundry 擴充功能讓你能直接從 VS Code 介面部署模型、建構 AI 應用程式,並操作代理。 安裝 Foundry VS Code 擴充功能。
安裝 Git
Git 是複製 Foundry SDK 範例所必需的。 如果您尚未安裝 Git,請 按照您平台的說明進行操作 ,然後選擇您的作業系統。
參考資料: Git