Important
本文中標示為預覽的項目目前仍在預覽中。 此預覽版未簽訂服務等級協議，Microsoft 不建議用於生產工作負載。 某些功能可能不被支援或功能受限。 欲了解更多資訊，請參閱 Microsoft Azure 預覽版補充使用條款。
Azure 開發者 CLI （azd） ai 擴充功能讓你能從終端機在 Microsoft Foundry 上建置、部署、評估及操作 AI 代理。 在本文中，你會安裝擴充功能、驗證安裝結果，並向 Azure 進行認證。
先決條件
- Azure 訂用帳戶。 免費創建一個。
- Azure Developer CLI （
azd） version 1.25.2 或更後版本。 安裝 azd。 - Python 3.10 或更新版本，或是 .NET 8 或更新版本，視你打算使用的代理框架而定。
Azure 許可權
你需要在 Azure 訂閱中設定以下角色。
| Role | Purpose |
|---|---|
| Contributor | 配置並管理 Azure 資源。 |
| 鑄造廠老闆 | 只有在創建新的 Foundry 專案時才需要。 |
Important
Foundry RBAC 角色最近已重新命名。 Foundry 用戶、Foundry 擁有者、Foundry Account Owner 以及 Foundry Project Manager 先前分別被稱為 Azure AI 使用者、Azure AI 擁有者、Azure AI 帳戶擁有者及 Azure AI Project 管理者。 在更名期間，你可能還會在某些地方看到之前的名字。角色 ID 與核心權限不會因命名而改變。
了解擴充功能是如何封裝的
azd ai 命名空間由多個彼此獨立的 azd 擴充功能組成。 每個項目都會在 azd ai 下新增一個頂層命令群組。
| 擴充識別碼 | 命令群組 | 其功能是什麼 |
|---|---|---|
microsoft.foundry |
元封包 | 一次性安裝就整合了所有 Foundry 擴充套件。 |
azure.ai.agents |
azd ai agent |
從你的終端機用 Foundry 寄送代理人。 |
azure.ai.connections |
azd ai connection |
管理 Foundry 專案連結。 |
azure.ai.inspector |
azd ai inspector |
供在本機執行的代理程式使用的瀏覽器式檢查器介面。 |
azure.ai.projects |
azd ai project |
管理 Foundry 專案上下文 （set， unset， show）。 |
azure.ai.routines |
azd ai routine |
管理 Foundry 的例行程序（計時器、排程、事件觸發器）。 |
azure.ai.skills |
azd ai skill |
管理 Foundry 技能（可重複使用的代理程式行為準則）。 |
azure.ai.toolboxes |
azd ai toolbox |
管理 Foundry 工具箱（版本化工具集合）。 |
這個 microsoft.foundry 套件是一個薄的元套件，不會自行貢獻指令。 安裝它時會一併安裝所有個別擴充功能，這是建議的起始點。 單獨安裝 azure.ai.agents 也會自動安裝 azure.ai.inspector，因為代理程式擴充功能相依於它。
安裝完整套裝
透過 meta-package 一步安裝所有 Foundry 擴充功能：
azd ext install microsoft.foundry
稍後更新：
azd ext upgrade microsoft.foundry
安裝或升級個別擴充功能
你也可以單獨管理每個擴充功能：
# Just the agent surface
azd ext install azure.ai.agents
# Just the routine surface
azd ext install azure.ai.routines
# Upgrade one extension without touching the others
azd ext upgrade azure.ai.connections
個別擴充功能都有各自獨立的版本，因此您可以一次只釘選或升級其中一個。
確認安裝情況
列出已安裝的擴充功能：
azd ext list
你應該會看到 microsoft.foundry 以及各個個別的擴充功能。 每個擴充功能也會暴露一個 version 子指令：
azd ai agent version
azd ai connection version
azd ai inspector version
azd ai project version
azd ai routine version
azd ai skill version
azd ai toolbox version
Authenticate
登入 Azure，讓 CLI 代表你配置和管理資源：
azd auth login
此指令會開啟一個瀏覽器視窗以進行互動式驗證。 登入後，CLI 會將你的憑證快取到本地，方便後續指令使用。