設定你的開發環境以使用 Microsoft Foundry SDK。 您也需要 Azure CLI 進行驗證,讓您的程式代碼可以存取您的用戶認證。
這很重要
本文僅涵蓋 一般必要條件 ,即語言執行階段、全域工具、VS Code 和延伸模組設定。
它 不 包括 SDK 安裝或身份驗證等特定場景步驟。
當您的環境準備就緒後,請繼續移至快速入門以取得那些指示。
先決條件
- 具有有效訂閱的 Azure 帳戶。 如果您沒有,請建立 免費的 Azure 帳戶,其中包含免費試用訂用帳戶。
- 下載、安裝及設定 Visual Studio Code。 更多資訊:下載 Visual Studio Code
- 透過 Visual Studio Code 擴充功能設定適當的 RBAC 權限,以建立和管理 Microsoft Foundry 資源。 欲了解更多資訊,請參閱 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。
安裝 The Foundry VS Code 擴充套件
Visual Studio Code 的 Foundry 擴充功能讓你能直接從 VS Code 介面部署模型、建構 AI 應用程式,並操作代理。 安裝 Foundry VS Code 擴充功能。
安裝 Git
許多 Microsoft Foundry SDK 範例使用 Git 進行版本控制。 如果您尚未安裝 Git,請 按照您平台的說明進行操作 ,然後選擇您的作業系統。