月明的文档中心 分享AI实践与思考
入门
上手
教程
基础
概念解释
Microsoft Foundry
开发工具
操作指南
参考
治理与网络
工具与知识
概念解释
操作指南
Agent Service
总览
概念解释
Azure OpenAI
API 与开发
总览
Azure AI Search
权限与安全
参考
检索概念
概念解释
快速上手
教程
Foundry Tools
其他与已退役
总览
概念解释
RAG 与知识工程
智能体与工具
MCP 与 Skills
操作指南
基础
评测、观测与安全
安全
评测
概念解释
参考
企业架构与成本
解决方案场景
样例与学习资源
附录
从 Azure OpenAI 资源升级到 Foundry
把现有的 Azure OpenAI 资源升级为 Foundry 资源：保留原有 API 端点、密钥和配置，同时获得更大的模型目录、Agent 服务和评测能力。
适用场景
- 已有 Azure OpenAI 资源，希望在同一端点下使用更多模型（如 Foundry Models sold by Azure 中的其他供应商模型）。
- 需要 Agent 服务、Foundry Tools（Speech、Vision、Language、Content Understanding）或评测功能。
- 不希望新建 Foundry 资源、迁移端点或重新配置网络与身份。
前提
项目 | 要求 |
Azure 角色 | 订阅或资源组上的 Owner 角色（官方建议；用于升级与分配项目角色） |
托管标识 | 在 Azure OpenAI 资源上启用系统分配的托管标识（Identity 页面 System assigned 设为 On） |
私有网络 | 若使用私有终结点，需先删除私有终结点，再升级（Foundry 门户或 Azure 门户不支持带私有终结点的直接升级） |
区域 | 升级后可用的模型与功能因区域而异，Agent 服务仅在部分区域可用 |
步骤
- 确认托管标识已启用。
- 选择升级入口（四选一）：
- Foundry（classic）门户：在资源概览页找到升级横幅，选择 Get started，输入首个项目名称后确认。
- Azure 门户：在资源概览页找到同一横幅，确认升级。
- Bicep 或 ARM 模板：将 kind 从 OpenAI 改为 AIServices，并设置 allowProjectManagement 为 true。
- Terraform：AzAPI 或 AzureRM 提供程序；使用 AzureRM 时需 4.56.0 或更高版本以避免破坏性更新。
- 升级完成后，检查项目概览页上的两个端点：原 Azure OpenAI 端点与新的 Foundry 端点。
- 按需为私有网络补充 DNS 区域并重建私有终结点。
验证
检查项 | 预期结果 |
资源类型 | 门户中显示为 Foundry（原为 Azure OpenAI） |
端点与密钥 | 与升级前一致 |
既有状态 | 微调任务、批处理、存储的 completions 等保留 |
项目 | 出现默认项目，可访问升级前的工作内容 |
属性 | 只读属性 previousKind 为 OpenAI，表示该资源曾升级 |
升级前后对比
能力 | Azure OpenAI | Foundry |
Foundry Models sold by Azure | 仅 Azure OpenAI 模型 | 含 Azure OpenAI 以及其他供应商模型（待核实清单） |
Agent 服务 | 不可用 | 可用（区域受限） |
Foundry Tools | 不可用 | 可用（Speech、Vision、Language、Content Understanding） |
Azure OpenAI API（批处理、微调、评测等） | 可用 | 可用 |
保持不变的内容：资源名称、标签、网络配置、访问与身份配置、API 端点与密钥、自定义域名，以及既有状态。
排错表
现象 | 处理方式（以官方页面为准） |
当前用户没有账户或写权限 | 获取具有管理权限的 Azure RBAC 角色，如 Owner、Contributor 或 Azure AI Administrator |
未启用托管标识 | 通过模板或 Azure 门户启用 |
有 Owner 或 Contributor 角色仍无法创建 Agent | Agent 等开发操作需要数据平面角色，如 Foundry User、Foundry Project Manager、Foundry Owner |
Azure Policy 冲突 | 查看策略违规详情，改用 Bicep 等模板方式升级，网络配置可能只能通过模板设置 |
回滚时超出每区域订阅的 Azure OpenAI 实例数（30） | 删除或升级其他 Azure OpenAI 资源后重试 |
超出每区域订阅的 AIServices 实例数（100） | 删除不再使用的 Foundry 资源后重试 |
回滚
- 先删除项目、连接（Connections）以及非 Azure OpenAI 的模型部署。
- 通过 Foundry（classic）门户的 Management Center、Azure 门户的回滚选项，或将模板中的 kind 改回 OpenAI 完成回滚。
权限与治理注意
- 升级后，拥有 Cognitive Services User 角色的用户可访问全部 Foundry 功能；仅有 Cognitive Services OpenAI User 角色的用户仍只访问 OpenAI 功能（官方表格）。
- 含通配符的角色分配或未限定资源类型的策略，可能在升级后让用户意外获得 Foundry 功能，应在升级前审查。
- 若要分阶段开放非 OpenAI 功能，应先更新 RBAC 角色、Azure Policy 与自定义角色。
费用
- 官方称升级后既有 Azure OpenAI 功能的费用不会增加。
- 新增功能（更大的模型目录、Agent 服务、评测）可能有各自的计费方式，待核实，需用 Azure 定价计算器估算。
限制与待核实
- 不支持配置 Weights & Biases。
- 私有网络需额外配置 DNS，并确保三个域名（openai、services.ai、cognitiveservices）均可解析，升级后需重建部分私有终结点。
- 模型与功能的区域差异较大，升级前应在目标区域核对。
- 回滚与升级的时间窗口、门户入口名称（经过 Foundry 门户改版）均可能变化，待核实。
来源与核对
- 核对范围：正文已读（前提、升级方式、升级前后对比、私有网络、回滚、排错与费用说明均已核对）。
- 获取日期：2026-11-05。区域、模型清单与门户入口名称待核实。
上一篇
计费与成本
下一篇
VS Code 扩展
Loading...