根据 2026 年 11 月 5 日发布的微软官方资料,Microsoft Foundry 扩展包(microsoft.foundry)面向 Azure Developer CLI(azd)的版本已达到 1.0,并正式可用。具体变化是:azd 在准备 Azure 资源和部署代码之外,新增了托管代理的初始化、配置、本地测试与上线;代理和部署定义统一写入项目的 azure.yaml,可随代码一起审阅。
同一条命令链贯穿本地与部署
微软称,Agent Inspector 可在调整提示词、工具或代码时查看本地请求与响应,本地、CI/CD 和 Foundry 部署则复用同一配置。托管代理运行用户自己的代理代码,框架及编排逻辑由用户选择,运行时由 Foundry 管理。扩展还提供配置预览、日志跟踪和诊断命令:
azd deploy --preview
azd ai agent monitor --follow
azd ai agent doctor
从官方样例建立托管代理
环境要求包括 azd 1.37.0 或更高版本、当前的 uv、Python 3.13 或更高版本,以及 Azure 订阅、Foundry 权限和目标区域的模型配额。官方提供 Python Agent Framework 的 Responses API 托管代理样例,核心流程为:
azd ext install microsoft.foundry
azd ai agent init --template <官方样例 URL> --deploy-mode code --src .
azd provision
azd ai agent run
azd ai agent invoke --local "Write a haiku about deploying cloud applications."
azd deploy
azd ai agent invoke "Write a haiku about deploying cloud applications."
azd provision 会创建声明的资源,并在复用项目时补齐缺失的模型部署;可选的在线部署类型包括 Global Standard 或 Data Zone Standard,实际选项和配额取决于订阅与区域。azd deploy 将源代码交给 Foundry 远程构建,无需在本地构建容器,输出中会包含 playground 与 endpoint 链接。
更适合代理工程化场景
- 需要在代码审阅中同时检查代理与部署变更的团队。
- 希望用同一配置衔接本地调试、托管运行和流水线发布的团队。
- 需要持续评估代理质量的团队。微软的
azure.ai.evaluations扩展可生成测试数据和评分规则;azd up可串联打包、预配与部署,azd pipeline config则为 GitHub Actions 或 Azure DevOps 生成认证、仓库设置和工作流。
成本、权限和清理有明确边界
准备 Azure 资源及调用模型都会产生 Azure 费用。流水线身份必须获得所需权限,各阶段宜使用独立的 azd 环境,运行时凭据应放入流水线机密;执行身份还需访问评估所引用的数据集和评估器。清理行为取决于项目来源:复用已有 Foundry 项目时,azd down 会保留项目、资源及托管代理,需另行删除;新建演示项目则会删除相应资源组。实际可用范围仍应以目标订阅、区域权限和实时配额为准。
样例配置可参阅微软官方的 Foundry 托管代理样例;反馈入口为 Azure Developer CLI 仓库。
资料来源:Microsoft Foundry extension for Azure Developer CLI is generally available(2026-11-05)。
一起聊聊
留下你的想法,评论审核通过后展示。