从 Azure OpenAI 升级到 Azure AI Foundry

与 Azure OpenAI 资源类型相比，Azure AI Foundry 资源类型提供了一个功能超集。 它允许访问更广泛的模型目录、智能体服务和评估功能。

一个升级选项可用于将 Azure OpenAI 资源转换为 Azure AI Foundry 资源。 你可保留现有的 Azure OpenAI API 终结点、工作状态和安全配置，无需创建新的 Azure AI Foundry 资源。

升级的好处

将 Azure OpenAI 资源升级为 Azure AI Foundry 资源可解锁以下功能。

你的现有资源配置和状态将保持不变，包括：

• 资源名称
• Azure 资源标记
• 网络配置
• 访问和标识配置
• API 终结点和 API 密钥
• 自定义域名
• 现有状态，包括微调作业、批处理、存储补全，等等。

局限性

后端限制：

• 使用 客户管理的密钥 进行加密的 Azure OpenAI 资源只能按请求进行升级。 在此处填写请求表单。
• AI Foundry 资源类型不支持配置权重和偏差。
• 专用网络设置需要 重新配置专用链接终结点和额外的 DNS 配置 ，然后才能使用所有 Foundry 功能。

Foundry 门户限制：

• 评估视图尚不支持 Azure OpenAI 评估视图中提供的所有功能。

升级后的支持级别

升级会将 Azure OpenAI 资源类型转换为 Azure AI Foundry 资源类型。 这两种服务在升级前后均已正式发布且受支持。 升级您的 Azure OpenAI 资源是一个可选择加入的功能。 如果需要，可以回滚到以前的设置。

如何升级

作为升级的先决条件，必须在 Azure OpenAI 资源上启用托管标识。 可以通过 Azure AI Foundry 门户或使用 Azure Bicep 或资源管理器模板（建议使用自定义安全设置的资源配置）完成升级。

resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-06-01' = {
    name: aiFoundryName // Your existing resource name
    location: location
    identity: {
        type: 'SystemAssigned'
    }
    sku: {
        name: 'S0'
    }
    kind: 'AIServices' // Update from 'OpenAI'
    properties: {
        // required to work in AI Foundry
        allowProjectManagement: true 

        // Needed for capabilities that require EntraID authentication
        customSubDomainName: aiFoundryName
        disableLocalAuth: true
    }
}

升级后的 UX 导航差异

从 Azure OpenAI 升级到 Azure AI Foundry 后，你会注意到门户的导航和功能访问的更新：

1. 更新了左侧导航

   左侧菜单已重新组织，将包括助手在内的操场整合到一个单独的登陆页面下，简化了对试验环境的访问。 你可以访问包括智能体服务和内容理解在内的新功能。

   “Azure OpenAI 部分”用于访问专用于 Azure OpenAI 模型的功能。

   注释

   默认情况下，并非所有 Foundry 工具在左侧导航栏中都可见，左侧导航栏可自定义。 选择“...更多”可找到它们。

2. 默认视图现在是一个项目

   项目是用于在 Foundry 中组织你的工作的文件夹。 它们还是用于进行访问管理和数据隔离的容器。 你可以在 AI Foundry 资源中创建多个项目，以便可以在正在使用的用例之间分隔工作。 升级后的第一个项目有权访问 Azure OpenAI 中的先前工作。

3. 模型目录中更广泛的模型集

   模型目录现在包含更多可以使用 Azure AI Foundry 资源直接部署的模型。

4. 开发人员终结点

   项目概述页面包括以前的 Azure OpenAI 终结点和新的 Azure AI Foundry 终结点。 Foundry API 和 SDK 可用于访问更广泛的模型和功能集（包括智能体服务）。

了解定价

升级到 Azure AI Foundry 时，现有 Azure OpenAI 功能没有定价差异-当前的使用模式和成本保持不变。 但是，Azure AI Foundry 可解锁对更多功能（例如扩展的模型目录、代理服务和评估工具）的访问权限，这些工具可能具有自己的定价结构，具体取决于所使用的模型和服务。

若要估算 Azure AI Foundry 中提供的新功能的成本，请使用 Azure 定价计算器。

专用网络配置

AI Foundry 资源是 Azure OpenAI 资源的超集，其功能通过三个 FQDN 公开：

• {custom-domain}.openai.azure.com
• {custom-domain}.services.ai.azure.com
• {custom-domain}.cognitiveservices.azure.com

DNS 配置必须能够解析上述每个 FQDN，才能使用完整的 Foundry 功能集。

• 如果使用 Azure DNS，则需要为上述每个域创建 一个 Azure DNS 区域 。

• 如果使用自定义 DNS 实现，则需要为每个上述配置实现条件转发器。

之后，请在资源上删除并 重新创建专用链接终结点 。 专用链接终结点会在 Azure 虚拟网络中创建一个 IP 地址，以映射到每个终结点。

回滚到 Azure OpenAI

如果遇到任何问题，可以使用回滚选项。 作为回滚的先决条件，首先需要删除以下任何配置：

• 项目
• 连接
• 非 Azure OpenAI 模型部署

然后，使用 AI Foundry 门户或 ARM 模板进行回滚：

resource aiFoundry 'Microsoft.CognitiveServices/accounts@2025-06-01' = {
name: aiFoundryName
location: location
identity: {
    type: 'SystemAssigned'
}
sku: {
    name: 'S0'
}
kind: 'OpenAI'
properties: {

    // Defines developer API endpoint subdomain
    customSubDomainName: aiFoundryName
    disableLocalAuth: true
}

排查常见问题

Azure 资源限制和组织配置可能需要执行额外的步骤才能完成升级。 下表列出了部分最常见的问题及其推荐的解决方案，以帮助进行故障排除。

如何检查资源是否已升级

以下 Azure 资源属性可用于检查资源以前是否已升级到 AI Foundry。

{
  {
    // Read only properties if your resource was upgraded:
    previouskind: "OpenAI"
  }
}

不确定谁已将资源升级到 Azure AI Foundry？ 可以在 Azure 门户中查看活动日志，以了解升级操作的发生时间以及操作用户：

1. 使用 Azure 活动日志（在“监视”下）查看是否已执行升级操作。
2. 按存储帐户上的“写入”操作进行筛选。
3. 查找列出为 Microsoft.CognitiveServices/accounts/write 的操作。

相关内容

• 为 AI Foundry 选择 Azure 资源类型
• Azure AI Foundry 常见基础结构配置的 Bicep 示例