Миграция из концентраторов в проекты Foundry (классическая модель)

Применяется только к:Портал Foundry (классический). Эта статья недоступна для нового портала Foundry. Дополнительные сведения о новом портале.

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

Оценка времени: 5–10 минут.

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

• Существующий центральный проект
• роль Azure: роль Owner на уровне подписки или группы ресурсов для создания ресурсов и проектов, а также для назначения ролей новому проекту.

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

Microsoft Foundry переходит на единую платформу как службу, заменив предыдущую модель ресурсов, требующую управления несколькими службами Azure. По мере того как рабочие нагрузки ИИ становятся более сложными, проект Foundry:

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

Дополнительные сведения.

Обзор проектов New Foundry

Проекты Foundry объединяют и упрощают состав рабочих процессов разработчиков и управление основными стандартными блоками приложений ИИ. К этим стандартным блокам относятся:

• Модели
• Агенты и их инструменты
• Наблюдаемость, безопасность и доверие

Ранее возможности проекта Foundry требовали управления несколькими ресурсами Azure и пакетами SDK для рабочих процессов в серверной части для создания этих компонентов.

К новым возможностям относятся:

• Доступ к API Foundry, который предназначен для создания и оценки агентных приложений, ориентированных на API, включающих агентов, оценки, индексы моделей и данные в едином пользовательском опыте и с согласованным контрактом между всеми поставщиками моделей.

• Microsoft Foundry SDK оборачивает Foundry API, что упрощает интеграцию функционала в код приложений, написанных на Python, C#, JavaScript/TypeScript или Java.

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

• Проекты теперь являются дочерними ресурсами; им могут быть назначены собственные элементы управления администратора, такие как Azure RBAC, но по умолчанию они разделяют общие параметры с родительским ресурсом. Этот принцип направлен на то, чтобы ИТ-администраторы вышли из повседневного цикла. После установления безопасности, подключения и управления на уровне ресурсов вы, как разработчик, можете создать собственный проект в виде папки для организации вашей работы.

Как переключиться на проект Foundry

Создайте новые проекты Foundry в ресурсе модели Foundry из центрального проекта. Этот процесс позволяет новым проектам получать доступ к работе, выполняемой первоначально в проекте на основе концентратора.

Что переносится в проекты Foundry

• Развертывания моделей
• Файлы данных
• Точно настроенные модели
• Помощники
• Векторные хранилища

Что не передается дальше

• Состояние агента предварительной версии (сообщения, потоки, файлы) — вы можете повторно создать агент с помощью кода в новом проекте.
• Развертывание моделей с открытым исходным кодом — проекты Foundry в настоящее время это не поддерживают.
• Доступ к проекту концентратора — у проектов на основе концентратора нет доступа к каким-либо из новых проектов, созданных на ресурсе моделей Foundry

В следующих разделах вы узнаете, как перейти из центральных проектов в проекты Foundry:

1. Найдите ваш существующий ресурс Foundry
2. Создайте проект Foundry в ресурсе ИИ.

После создания нового проекта может потребоваться:

• (Необязательно) Повторное создание подключений
• (Необязательно) Миграция агентов

1. Поиск существующего ресурса Foundry

Большинство пользователей Foundry уже имеют ресурс Foundry (прежнее название — службы ИИ), который они ранее создали вместе с проектом на основе концентратора для доступа к развертываниям моделей.

2. Создание нового проекта

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

Теперь вы готовы начать разработку агентов в стадии общего доступа и с новейшими возможностями. Начните пользоваться SDK или демонстрационной средой агента.

(Необязательно) Повторное создание подключений

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

(Необязательно) Миграция программных агентов

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

1. Установите последнюю версию предпочтительного клиента ПАКЕТА SDK.

2. Обновите клиент проекта, чтобы использовать API Foundry. Вместо строки подключения теперь используется конечная точка проекта Foundry. Например, в Python:

   from azure.identity import DefaultAzureCredential
   from azure.ai.projects import AIProjectClient
   
   project = AIProjectClient(
     endpoint="your_project_endpoint",  # Replace with your endpoint
     credential=DefaultAzureCredential())
   

   Этот фрагмент кода производит аутентификацию с использованием библиотеки удостоверений Azure в проекте Foundry и создает экземпляр клиента проекта. endpoint — это конечная точка проекта Foundry; DefaultAzureCredential использует учетные данные Azure для проверки подлинности.

   Справочник: AIProjectClient, DefaultAzureCredential, SDK migration guide

3. Обновите скрипт, чтобы отразить изменения структуры классов между предварительным просмотром и стабильными пакетами SDK.

Дополнительные сведения см. в руководстве по миграции SDK.

(Необязательно) Упорядочивание проектов на основе хабов

Если вам больше не нужен доступ к вашим проектам, основанным на хабе, удалите их из подписки Azure.

Возможно, вы хотите сохранить хабы и проекты на основе хабов в своей подписке по ряду причин:

• Доступ к выбору функций, которые еще не поддерживаются в проектах Foundry. См. эту матрицу поддержки.

• Варианты использования, ориентированные на обучение пользовательской модели машинного обучения. Проект на базе концентратора строится на стеке Машинное обучение Azure и остается доступным через Машинное обучение Azure Studio, CLI или SDK.

Подробнее

• Развертывание Foundry системы в моей организации

• Примеры шаблонов Bicep

• Примеры шаблонов Terraform

• руководство по миграции SDK