準備好你的開發環境，以便使用 Microsoft Foundry 來建置。 你需要支援的程式語言、Git 以及適合你工作流程的 Foundry 開發工具。
Tip
Foundry DevPack 是推薦用一個指令安裝開發工具的方法。 你也可以分別安裝每個工具。
重要
本文涵蓋一般的先決條件與開發者工具。 它不涵蓋特定情境的 SDK 套件或驗證碼。 當您的環境準備就緒後，請繼續前往快速入門。
先決條件
- 一個有有效訂閱的 Azure 帳號。 如果你還沒有，請建立一個free Azure帳號，其中包含免費試用訂閱。
- 存取你計劃使用的 Foundry 資源或專案。 如需設定指引，請參閱開始使用所需的最低角色指派。
安裝 Foundry DevPack
Foundry DevPack 會安裝 Foundry 開發工具，用於你的終端機、編輯器和程式代理程式。 選擇您的作業系統。
DevPack 會安裝其核心工具，並且僅在其應用程式存在時才新增主機延伸模組：
| Tool | 您可以執行的作業 |
|---|---|
azd 和 azd ai |
透過終端機建置、部署、評估及自動化。 |
| Microsoft Foundry 技能 | 為編碼代理提供可重複使用的 Foundry 工作流程指引。 |
| 適用於 Visual Studio Code 的 Microsoft Foundry 工具組 | 只有在 Visual Studio Code 存在時才會安裝。 從編輯器中建置、測試、評估並部署。 |
| Foundry Canvas（預覽） | 只有在 GitHub Copilot 應用程式存在時才會安裝。 從引導式畫布設計並部署代管代理程式。 |
DevPack 不會安裝 Visual Studio Code 或 GitHub Copilot 應用程式。
繼續以下章節，建立你的程式語言並安裝 Git。
使用程式語言工作
使用你申請所需的語言。 選取一個分頁，以安裝其執行階段或 Visual Studio Code 擴充功能。
安裝 Python 3.10 或更新版本。 Python 3.9 是最低支援版本。 為你的專案建立虛擬環境，而不是全域安裝套件。
Windows
py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
macOS 和 Linux
python3 -m venv .venv
source .venv/bin/activate
若要支援編輯器，請安裝 Visual Studio Code 的 Python 擴充功能。
安裝 Git
要複製 Foundry SDK 範例，你需要 Git。 如果你還沒安裝 Git，請從 Git 官網下載並安裝。
請分別安裝開發者工具
如果你不使用 Foundry DevPack，請選擇一個分頁只安裝你需要的工具。
安裝 Foundry 擴充功能：
azd ext install microsoft.foundry
若要安裝個別擴充功能而非完整套件，請參見安裝 Azure Developer CLI Foundry 擴充套件。
對於個別 Azure 資源的直接、細緻管理，請使用 Azure CLI （az）。 請參閱 Azure Developer CLI vs Azure CLI.
故障排除
| 問題 | 解決方法 |
|---|---|
| 安裝後找不到指令 | 關閉並重新開啟您的終端機。 如果你使用 Visual Studio Code，請重新啟動它，讓 PATH 變更生效。 |
| 找不到 Python | 在 macOS 或 Linux 上，請使用 python3 取代 python，或安裝 Python 3.9 或以上版本。 |
| 安裝 Python 套件時權限被拒絕 | 在 macOS 或 Linux 上，不要使用 sudo pip install. 改用虛擬環境吧。 |