Azure Developer CLI （azd） Microsoft Foundry 代理擴充功能可從您的終端機或編輯器架構、配置並部署代理至 Microsoft Foundry。 它結合了 Foundry 代理的功能與 azd 生命週期指令，實現一致的本地到雲端工作流程。 你可以從範例代理轉換成部署且可呼叫的端點，只需幾個指令。
本文介紹了這個擴充功能。 欲獲得完整的逐步指引，請參閱 Microsoft Foundry 託管代理文件。
主要功能
| Feature | Description |
|---|---|
| 項目模板 | 建立完整的代理專案，包括基礎設施作為程式碼範本、代理定義與設定，讓您能立即開始迭代。 |
| 宣告式設定 | 在檔案 azure.yaml 中定義服務、資源與模型部署，以實現一致的環境。 |
| 統一配置與部署 |
azd up執行時可一舉建立容器、推送映像檔、建立資源、部署模型，並發布代理程式。 |
| 代理定義管理 | 從目錄、GitHub 或本地路徑匯入代理定義，並將所需參數映射到環境變數。 |
| 預設安全 | 自動建立受管理身份與基線安全，無需手動處理憑證。 |
| 可擴展模型配置 | 指定模型名稱、版本與容量，並在各環境中一致部署。 |
探索工作流程
這個擴充功能遵循熟悉的 azd 生命週期：從建立骨架到上線的代理程式。
- 支架：初始化一個範例代理專案，包括基礎設施即程式碼、代理定義與配置。
- 配置與部署：建立 Foundry 帳號與專案，部署模型，建置並推送代理容器，並發布代理程式。
- 本地執行：在連接遠端 Azure 資源的同時，在本地機器上迭代代理程式。
- 呼叫與監控：向已部署的代理發送提示並串流即時日誌。
- 拆除：完成後移除所有已配置的資源。
試試看
試著部署一個只用最低工作流程的範例代理。 此範例使用了 Microsoft Foundry 文件中基本的代理框架範例。
在空資料夾中建立一個範例代理專案：
azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/azure.yaml一個步驟內配置資源並部署代理：
azd upTip
你也可以將此步驟拆分成
azd provision和azd deploy，以更好地控制每個階段。完成時移除所有已配置的資源：
azd down警告
azd down永久刪除資源群組中的所有資源。 在共享或生產環境中謹慎使用。
關於前置條件、模型選擇、本地測試及故障排除，請參閱 快速入門：部署您的第一個託管代理。
何時使用 agent 擴充功能
Microsoft Foundry 支援多種方式來建置與部署託管代理程式，包括 Python SDK、Visual Studio Code 以及入口網站。 當你想要執行以下操作時，azd 代理程式擴充功能是最合適的選擇：
- 主要從終端機或編輯器操作 ，並具備可腳本化且可重複的工作流程。
- 透過在原始檔控制下使用宣告式
azure.yaml和 Bicep 檔案，共同管理基礎結構與代理程式。 -
持續從本地移動到雲端，使用你已經在其他 Azure 應用程式中使用的相同
azd生命週期指令（azd init，azd up，azd down）。 - 標準化跨環境 （開發、測試與生產環境）的部署，並在 CI/CD 中自動化。
若想體驗導引式入口網站或使用 Python SDK 撰寫代理，建議從 Microsoft Foundry 託管代理文件開始。