共用方式為


準備開發環境

設定你的開發環境以使用 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

許多 AI 解決方案範本 包含一個使用 azd 的部署選項。

安裝 The Foundry VS Code 擴充套件

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

安裝 Git

Git 是複製 Foundry SDK 範例所必需的。 如果您尚未安裝 Git,請 按照您平台的說明進行操作 ,然後選擇您的作業系統。

參考資料: Git