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

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

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

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

Prerequisites:

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

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

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

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

Подробнее.

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

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

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

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

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

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

• Майкрософт Foundry SDK оборачивает API Foundry, упрощая процесс интеграции возможностей в код, независимо от того, написано ваше приложение на Python, C#, JavaScript/TypeScript или Java.

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

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

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

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

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

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

Что не передается

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

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

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

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

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

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

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

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

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

Теперь вы готовы начать создание агентов в общедоступной доступности и с новейшими возможностями. Get started с помощью пакета 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())
   

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

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

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

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

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

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

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

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

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

Узнать больше

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

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

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

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