Обновление с Azure OpenAI до Microsoft Foundry (классическая версия)

В настоящее время просмотр:Классическая версия портала Foundry - Переключиться на версию нового портала Foundry

Тип ресурса Microsoft Foundry предоставляет супермножество возможностей по сравнению с типом ресурсов OpenAI Azure. Он предоставляет доступ к более широкому каталогу моделей, службам агентов и возможностям оценки.

Вы можете обновить свой ресурс Azure OpenAI до ресурса Foundry. Вы сохраняете существующую конечную точку Azure OpenAI API, состояние работы и конфигурации безопасности, и вам не нужно создавать новый ресурс Foundry.

Преимущества обновления

При обновлении ресурса OpenAI Azure до ресурса Foundry вы получите доступ к следующим возможностям.

Функция	Azure OpenAI	Литейный завод
Модели, проданные непосредственно Azure	только Azure OpenAI	Azure OpenAI, Black Forest Labs, DeepSeek, Meta, xAI, Mistral, Microsoft
Модели партнеров и сообщества, проданные через Marketplace — стабильность, Cohere и другие		✅
API Azure OpenAI — пакетная обработка, хранимые завершения, тонкая настройка, оценка и т. д.	✅	✅
Служба агента		✅
API Azure Foundry		✅
Средства Foundry — речь, зрение, язык, понимание содержания		✅

Существующие конфигурации ресурсов и состояние остаются неизменными, в том числе:

Имя ресурса
теги ресурсов Azure
Конфигурации сети
Конфигурации доступа и удостоверений
Конечная точка API и ключ API
Имя личного домена
Существующее состояние, включая работы по точной настройке, пакетные процессы, хранимые выполненные задачи и многое другое.

Ограничения

Модель фабрики и доступность функций отличаются по регионам. Например, служба агента доступна в некоторых регионах по сравнению со службой Azure OpenAI.
Ресурсы Azure OpenAI с ключами, управляемыми клиентом, для шифрования доступны для обновления только по запросу. Заполните форму запроса здесь.
Тип ресурса Foundry не поддерживает настройку Weights & Biases.
Для настройки частной сети требуется дополнительная конфигурация зоны DNS рядом с существующей зоной DNS Azure OpenAI перед использованием всех возможностей Foundry.

Уровень поддержки после обновления

Обновление преобразует тип ресурса OpenAI Azure в тип ресурса Foundry. Обе службы обычно доступны и поддерживаются до и после обновления. Обновление ресурса Azure OpenAI — это функция, доступная по желанию. При необходимости можно выполнить откат к предыдущей настройке.

Как обновить

Предварительные требования для обновления

Перед обновлением ресурса OpenAI Azure до ресурса Foundry убедитесь, что у вас есть следующие возможности:

требования к роли Azure: в подписке или группе ресурсов должна быть одна из следующих ролей Azure:
- Роль владельца в подписке или группе ресурсов для управления ресурсами и настройки и назначения ролей новому проекту.
Эта роль необходима для активации управляемого удостоверения и выполнения операции обновления.
Managed identity: необходимо включить управляемую идентификацию на ресурсе Azure OpenAI. Если он еще не включен, его можно включить с помощью портала Azure/c0>. Перейдите к ресурсу, выберите Идентификация в меню слева и переключите Системное назначение на включено.

Обновление ресурса

Обновление можно выполнить на портале Foundry (классическом) Azure или с помощью шаблонов Azure Bicep или Resource Manager (рекомендуется для конфигураций ресурсов с пользовательскими параметрами безопасности).

Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry отключен. Эти действия относятся к Foundry (classic).
Выберите ресурс Azure OpenAI.
На странице обзора найдите баннер "Хотите попробовать новейшие отраслевые модели и агентов?" и выберите "Начать работу".
Введите имя первого проекта. Проект — это папка для организации работы в Foundry. Первый проект по умолчанию является обратно совместимым с предыдущей работой в Azure OpenAI.
Подтвердите запуск обновления.

Успех. После завершения обновления вы перейдете в новый проект Foundry. Имя ресурса, конечная точка API и существующие конфигурации остаются неизменными. Теперь у вас есть доступ к более широкому каталогу моделей, службе агента и средствам Foundry.

Этот проект можно использовать на портале Foundry (классическая версия) или на портале Foundry (new). Чтобы переключиться на новый портал, установите переключатель New Foundry в положение вкл.

Начиная с существующей конфигурации шаблона OpenAI Azure задайте следующие свойства:

Обновление kind от значения OpenAI до AIServices.
Задайте для параметра allowProjectManagement значение true.
Настройте управляемое удостоверение.

Пример конфигурации:

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

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

Запустите шаблон с помощью Azure Bicep CLI или расширения Visual Studio Code для Bicep для внесения исправлений в ваш ресурс.

References: Microsoft.CognitiveServices/accounts, документация Bicep CLI.

Успех: операция исправления завершается без ошибок. Свойство ресурса kind изменяется с OpenAI на AIServices, и allowProjectManagement установлено на true. Существующие конечные точки, ключи API и конфигурации сохраняются.

Вы можете обновить ресурс Azure OpenAI с помощью поставщиков Terraform AzAPI или AzureRM.

Это важно

При использовании поставщика ресурсов AzureRM убедитесь, что вы используете версию клиента Terraform CLI выше 4.57.0 для неразрушающего обновления ресурса.

Начните с существующей конфигурации Azure OpenAI и обновите следующие свойства:

Обновите тип с значения OpenAI на AIServices.
Задайте allowProjectManagement: True.
Настройте управляемое удостоверение.

Наконец, запустите terraform apply , чтобы завершить обновление.

После обновления с Azure OpenAI на Foundry вы увидите обновления навигации и доступа к функциям портала:

Обновленная навигация слева

Портал переорганизует меню слева, чтобы объединить игровые площадки, включая помощников, на единой главной странице. Это изменение упрощает доступ к средам экспериментирования. Вы найдете доступ к новым функциям, включая службу агента и понимание содержимого.

Раздел Azure OpenAI предоставляет доступ к функциям, которые используются исключительно с моделями OpenAI Azure.

Замечание

На портале не отображаются все средства Foundry по умолчанию в левой части навигации. Навигация настраивается. Выберите ... Еще, чтобы найти их.
Теперь вид по умолчанию - это проект

Проекты — это папки для упорядочивания работы в Foundry. Они также контейнер для управления доступом и изоляции данных. Вы можете создать несколько проектов в рамках ресурса Foundry, чтобы разделить работу между вариантами использования, над которыми вы работаете. Первый проект после обновления имеет доступ к предыдущей работе в Azure OpenAI.

Этот проект также можно использовать на портале Foundry (new).
Более широкий набор моделей в каталоге моделей

Каталог моделей теперь включает в себя больше моделей, которые можно развернуть непосредственно с помощью ресурса Foundry.
Конечные точки разработчика

Страница обзора проекта включает вашу предыдущую конечную точку Azure OpenAI и новую конечную точку Foundry. API и пакет SDK foundry предоставляют доступ к более широкому набору моделей и функций, включая службу агента.

Основные сведения о ценах

При обновлении до Foundry вы не платите больше за существующие функции Azure OpenAI. Текущие шаблоны использования и затраты остаются неизменными. Однако Foundry предоставляет доступ к дополнительным функциям, таким как расширенные каталоги моделей, службы агентов и средства оценки. Эти функции могут иметь собственные структуры ценообразования в зависимости от используемых моделей и служб.

Чтобы оценить затраты на новые функции, доступные в Foundry, используйте калькулятор цен Azure.

Управление управлением	Доступ перед обновлением	Доступ после обновления
Пользователь Cognitive Services (роль RBAC)	Функции OpenAI	Все функции Foundry
Пользователь OpenAI в Cognitive Services (роль RBAC)	Функции OpenAI	Функции OpenAI
Пользовательские роли RBAC	Только функции, которые вы определили	Только функции, которые вы определили
Доступ к модели (политика не применяется)	Модели OpenAI	Любая модель Foundry
Доступ к модели (применена политика)	Только модели OpenAI, разрешенные политикой	Только модели, которые можно разрешить с помощью политики

Конфигурация частной сети

Ресурс 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, реализуйте условный сервер пересылки для каждой из указанных выше конфигураций.

После настройки DNS обновите или также удалите и повторно создайте конечную точку приватного канала в ресурсе. Конечная точка частного подключения создает IP-адрес в вашей виртуальной сети Azure для сопоставления с каждой конечной точкой.

Это важно

При обновлении до Foundry необходимо повторно создать конечную точку приватного канала для создаваемых конфигураций IP-адресов "services.ai.azure.com" и "{пользовательский домен}.cognitiveservices.azure.com".

Откат к Azure OpenAI

При возникновении проблем можно откатить. Чтобы выполнить откат, сначала удалите любую из следующих конфигураций:

Проекты
Connections
Развертывания моделей OpenAI, отличных от Azure

Затем используйте классический портал Foundry, портал Azure или шаблон ARM, чтобы откатить изменения.

Вариант 1. Использование портала Foundry

Выберите проект в портале Foundry (classic).
Выберите Центр управления в нижней левой части экрана.
На странице обзора ресурсов найдите опцию отката.
Выберите «Откат».

Option 2. Использование шаблона Azure Bicep

Чтобы выполнить откат, преобразуйте конфигурацию шаблона обратно в OpenAI тип.

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

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

Запустите шаблон с помощью Azure Bicep CLI или расширения Visual Studio Code для Bicep для внесения исправлений в ваш ресурс.

References: Microsoft.CognitiveServices/accounts, документация Bicep CLI.

Чтобы выполнить откат к Azure OpenAI, используйте поставщики AzAPI или AzureRM Terraform.

Замечание

Удалите все развертывания моделей, отличных от OpenAI.
Удалите подресурсы, специфичные для Foundry, включая проекты и подключения.
azurerm_cognitive_account В вашем ресурсе измените тип с значения 'AIServices' на 'OpenAI' и установите allowProjectManagement в значение False.

Устранение распространенных проблем

Azure ограничения ресурсов и конфигурации организации могут потребовать дополнительных шагов для завершения обновления. В следующей таблице описаны некоторые из наиболее распространенных проблем, а также рекомендуемые решения для устранения неполадок.

Проблема	Решение проблем или устранение рисков
Субъект-пользователь не имеет учетных записей или разрешений на запись	Получите привилегированную роль Azure RBAC для управления ресурсом Azure верхнего уровня. Например, Owner, Contributor или Azure администратор искусственного интеллекта.
Управляемое удостоверение не настроено в сервисе Azure OpenAI	Настройте управляемое удостоверение на ресурсе с помощью шаблонов или портала Azure.
Нет разрешений на создание агентов, в то время как вы являетесь владельцем или участником ресурса.	Для выполнения действий по разработке, включая агентов, требуется роль плоскости данных EntraID. Примеры включают роли пользователь Azure ИИ, менеджер проекта Azure ИИ или владелец Azure ИИ. Owner и Contributor роли предоставляют доступ только к операциям управления в Azure, например управление развертываниями.
В Azure Policy произошел конфликт.	В вашей организации могут быть ограничения на конфигурации ресурсов. Проверьте информацию об ошибке нарушения политики. Затем обновите ресурс с помощью параметров шаблона для дальнейшей настройки. Например, конфигурации сети для агентов можно настроить только с помощью параметров шаблона, таких как Azure Bicep.
Превышено количество экземпляров Azure OpenAI, равное 30 на подписку в каждом регионе при откате.	Удалите ресурс OpenAI Azure или обновите его до Foundry. Затем попробуйте снова выполнить откат текущего ресурса.
Превышено допустимое количество экземпляров AIServices — более 100 на одну подписку в каждом регионе.	Удалите ресурс Foundry, который может не использоваться в этой подписке. Затем повторите обновление текущего ресурса.
Доступ к ресурсу через частную сеть не удается получить	Сведения о конфигурации частной сети см. в разделе о необходимых шагах.

Как проверить, был ли обновлен ресурс

Вы можете проверить следующее свойство ресурса Azure, чтобы узнать, был ли ресурс обновлен до Foundry.

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

Если вы не уверены, кто обновил ресурс до Foundry, вы можете просмотреть журнал действий на портале Azure узнать, когда произошла операция обновления и какой пользователь выполнил его:

Используйте журналы действий Azure (в разделе "Мониторинг") для просмотра выполнения операции обновления.
Фильтрация по операциям записи в учетной записи хранения.
Найдите операции, перечисленные как Microsoft.CognitiveServices/accounts/write.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-03-10