共用方式為

準備開發環境

設定你的開發環境以使用 Microsoft Foundry SDK。 你也需要Azure CLI來驗證，這樣你的程式碼才能access你的使用者憑證。

在本文中，你會安裝語言執行環境、Azure CLI、Azure Developer CLI、Foundry VS Code 擴充功能以及 Git。

這很重要

本文僅涵蓋 一般前置條件 ，例如語言執行環境、全域工具，以及 VS Code 與擴充功能的設定。
它沒有涵蓋特定情境步驟，例如安裝 SDK 或驗證。
當您的環境準備就緒後，請繼續移至快速入門以取得那些指示。

先決條件

  • 一個有有效訂閱的 Azure 帳號。 如果你還沒有，請建立一個free Azure帳號，其中包含免費試用訂閱。

  • 下載、安裝並設定 Visual Studio Code，或你選擇的 IDE。 欲了解更多資訊，請參閱Download Visual Studio Code。

  • 若要建立和管理 Foundry 資源，請擔任以下 Azure RBAC 角色之一

    • Azure AI Project Manager（用於管理鑄造廠專案）
    • 擁有者 （用於訂閱層級權限）。 在 Foundry 的其他案例中，擁有者是進行額外角色指派所必需的。 為了確保你在 Foundry 的所有案例下都能解除封鎖，擁有者是必須指派的角色。

  • 要使用項目但不建立新資源，至少需要：

    • Azure AI 使用者在你使用的專案中 (開發中權限最低的角色)

    關於每個角色權限的詳細資訊，請參閱 Microsoft Foundry 的角色型存取控制。

安裝您的程式設計語言

在 Visual Studio Code 裡，為你的 project 建立一個新資料夾。 在該資料夾中開啟終端機視窗。

首先，建立一個新的 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 擴充功能支援 Python，包括 IntelliSense、偵錯、格式化、程式碼檢查、程式碼導覽、重構、變數總管、測試總管以及環境管理功能。

安裝 Python 擴充套件為 Visual Studio Code。

安裝：

安裝 Visual Studio Java 擴充套件

Java 擴充套件是一系列受歡迎的擴充套件，能幫助你在 Visual Studio Code 中撰寫、測試及除錯 Java 應用程式。

安裝 Java 的 Visual Studio Code 擴充包。

安裝 Node.js （建議版本 18 或更新版本）。

確保你安裝了 .NET 開發所需的工具。

安裝 .NET SDK

你需要 .NET SDK（軟體開發套件）來建立、建置並執行 .NET 應用程式。 我們建議安裝最新的LTS（長期支援）版本，若project需要，則安裝更新版本。

  1. 從 官方.NET下載頁面下載 .NET SDK。 為您的作系統選取適當的安裝程式（Windows、Linux 或macOS）。

  2. 請遵循您的操作系統的安裝指引。

  3. 請開啟終端機或命令提示字元，並執行以下指令以確認安裝是否成功：

    dotnet --version

    回應應該是已安裝的 SDK 版本。

安裝 Visual Studio Code 的 C# 開發套件

如需 VS Code 中最佳的 C# 開發體驗，請安裝官方 C# 開發工具包擴充功能：

  1. 打開 Visual Studio 程式碼。
  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# project。 VS Code 搭配 C# Dev Kit 擴充功能，會自動偵測 project，啟用 IntelliSense、除錯和建置任務等功能。

安裝 Azure CLI 並登入

你安裝 Azure CLI，並從本地開發環境登入，這樣你就能用使用者憑證呼叫 Azure Microsoft Foundry 模型中的 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 pipelines。 安裝你平台的Azure開發者 CLI。

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

安裝 Foundry VS Code 擴充功能

Visual Studio Code 的 Foundry 擴充功能讓你能直接從 VS Code 介面部署模型、建置 AI 應用程式，並與代理程式互動。 安裝 Foundry VS Code 擴充功能。

安裝 Git

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

故障排除

問題 解決辦法
安裝後找不到指令 關閉並重新開啟終端機，或重新啟動 VS Code，讓 PATH 變更生效。
az login 會因瀏覽器錯誤而失敗 而是用 az login --use-device-code 裝置程式碼流程來執行驗證。
找不到 Python 請使用 python3 取代 python macOS/Linux，或安裝支援的版本（3.9 或更新版本）。
安裝時被拒絕授權 在 macOS/Linux 上，請避免 sudo pip install。 改用 虛擬環境 吧。

相關內容

  • Last updated on