Переход с портала Foundry (классический)

Microsoft Foundry развивался с помощью нескольких изменений именования и архитектуры. Если вы переходите с классического интерфейса портала, эта статья поможет вам спланировать и выполнить переход с помощью ссылочных сопоставлений для терминологии, возможностей, пакетов SDK и навигации на портале.

Необходимые условия

• Учетная запись Azure с активной подпиской. Создайте его бесплатно.
• Проект Foundry.
• Для миграции SDK: Python 3.9+ или .NET 8+ с установленными пакетами версии 2.x azure-ai-projects и openai.
• For resource upgrade: роль владельца или участника в ресурсе Azure OpenAI, который планируется обновить.

Планирование миграции

Выполните следующие действия, чтобы перейти с классического портала на текущий портал Foundry:

1. Просмотрите изменения терминологии. Проверьте сопоставление терминологии , чтобы понять переименованные понятия и новые типы ресурсов.
2. Проверьте сравнение признаков. Используйте таблицу сравнения функций , чтобы определить возможности, которые являются новыми, расширенными или классическими.
3. Обновите пакеты SDK. Замените устаревшие пакеты, используя таблицу сопоставления SDK.
4. Миграция агентов на Responses API. Переопределите агенты, использующие API Помощников для использования API ответов до заката августа 2026 года.
5. Убедитесь, что регион ресурсов Foundry поддерживает API ответов. API ответов и служба агента Foundry недоступны в каждом регионе Azure. Если ресурс Foundry находится в неподдерживаемом регионе, агенты и другие функции API ответов не работают на текущем портале. Перед переносом просмотрите список доступности регионов API ответов .
6. Проверьте на новом портале. Используйте ссылку на навигацию на портале , чтобы проверить рабочие процессы в текущем интерфейсе.

Сопоставление терминологии

В следующей таблице перечислены классические понятия с текущими эквивалентами.

Сопоставление пакета SDK

Используйте следующую таблицу, чтобы определить, какие пакеты SDK сопоставляются с текущим интерфейсом Foundry и которые они заменяют.

В следующем примере показана наиболее распространенная миграция пакета SDK на Azure, заменив клиент AzureOpenAI на стандартный клиент OpenAI.

Классический (до):

from openai import AzureOpenAI

client = AzureOpenAI(
    azure_endpoint="https://my-resource.openai.azure.com",
    api_key="my-key",
    api_version="2024-12-01-preview"
)

Текущий (после):

from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider

client = OpenAI(
    base_url="https://my-project.services.ai.azure.com/openai/v1",
    default_headers={"Authorization": f"Bearer {get_bearer_token_provider(DefaultAzureCredential(), 'https://cognitiveservices.azure.com/.default')()}"}
)

Сравнение функций

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

Доступно на обоих порталах

Новые возможности на текущем портале

Эти функции доступны только на текущем портале Foundry:

Только классическая версия (необходима миграция)

Навигация по порталу

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

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

Переключение между интерфейсами портала

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

1. Найдите переключатель New Foundry в верхнем баннере.
2. Выберите переключатель для переключения между классическими и текущими интерфейсами.
3. Страница перезагружается с выбранным интерфейсом портала.

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

Связанное содержимое

• Что такое Microsoft Foundry?
• Начало работы с Foundry Agent Service
• Разработка с помощью API ответов
• Развертывание моделей из каталога моделей
• Использовать средство чтения с экрана в сочетании с Microsoft Foundry