Точно настроить модели ИИ в Microsoft Foundry с расширением Azure Developer CLI

В этой статье вы узнаете, как использовать модуль командной строки разработчика Azure (azd) ИИ для настройки и выполнения заданий точной настройки в Microsoft Foundry. Расширение позволяет инициализировать проекты из шаблонов, отправлять задания тонкой настройки и управлять ими и развертывать точно настроенные модели непосредственно из терминала.

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

  • Интерфейс командной строки разработчика Azure (azd) установлен (версия 1.22.1 или более поздней версии) и прошел проверку подлинности (azd auth login).
  • Расширение azd, предназначенное для точной настройки ИИ, установлено (azd ext install azure.ai.finetune). Дополнительные сведения см. в разделе "Установка расширения тонкой настройки ".
  • Подписка Azure с разрешением на создание и управление ресурсами Microsoft Foundry.
  • (Необязательно) Установлен GitHub CLI, если вы планируете скачать примеры шаблонов из репозиториев GitHub.

Установка интерфейса командной строки разработчика Azure

Установите azd для вашей операционной системы.

winget install microsoft.azd

Проверка установки

После установки убедитесь, что azd установлен и соответствует минимальному требованию к версии:

azd version

Убедитесь, что выходные данные показывают версию 1.22.1 или более позднюю версию. Если вам нужно обновить, выполните следующую команду:

winget upgrade Microsoft.azd

Установите расширение параметров точной настройки

Добавьте расширение для fine-tuning Azure AI в azd:

azd ext install azure.ai.finetune

Убедитесь, что расширение установлено:

azd ext list

Аутентифицировать

Вход в Azure (обязательно)

Проверка подлинности с помощью учетной записи Azure для доступа к подписке и ресурсам:

azd auth login

Инициализация проекта

Используйте команду azd ai finetuning init, чтобы создать каркас проекта тонкой настройки. Перейдите к нужному рабочему каталогу перед выполнением любого из следующих методов инициализации.

Совет

Вы можете полностью пропустить инициализацию, используя параметр Quick Submit, который позволяет отправлять задание на точную настройку, указав непосредственно подписку и конечную точку проекта Foundry.

Найдите идентификатор ресурса ARM вашего проекта

Чтобы инициализировать проект Azure AI Foundry, вам потребуется идентификатор ресурса ARM проекта. Идентификатор ресурса соответствует следующему формату:

/subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project}

Это значение можно найти на портале Azure, перейдя на страницу проекта AI Foundry Profile в разделе Подробные сведения о проекте.

Вариант 1. Project + шаблон

Используйте существующий проект Azure AI Foundry с шаблоном:

azd ai finetuning init -p <project-resource-id> -t <template-url>

Пример

azd ai finetuning init \
  -t https://github.com/achauhan-scc/foundry-samples/blob/main/samples/python/finetuning/supervised \
  -p /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project}

Вариант 2: Project + существующее задание

Клонирование конфигурации из существующего задания тонкой настройки:

azd ai finetuning init -p <project-resource-id> -j <job-id>

Пример

azd ai finetuning init \
  -p /subscriptions/{sub}/resourceGroups/{rg}/providers/Microsoft.CognitiveServices/accounts/{account}/projects/{project} \
  -j ftjob-4cad7de198a34baeb4f0c95ff01ac844

Вариант 3. Только шаблон

Начните с шаблона и настройте проект позже:

azd ai finetuning init -t <template-url>

Пример

azd ai finetuning init -t https://github.com/achauhan-scc/foundry-samples/blob/main/samples/python/finetuning/supervised

Вариант 4: Клонирование из задачи

Клонирование конфигурации из существующего идентификатора задания:

azd ai finetuning init -j <job-id>

Пример

azd ai finetuning init -j ftjob-4cad7de198a34baeb4f0c95ff01ac844

Вариант 5: Только конечная точка Project

Инициализируйте, указав лишь конечную точку проекта Azure AI Foundry:

azd ai finetuning init -e <project-endpoint>

Пример

azd ai finetuning init -e https://account.services.ai.azure.com/api/projects/project-name

Вариант 6. Интерактивный режим

Запустите без параметров для получения приглашений к интерактивной установке:

azd ai finetuning init

Вариант 7: Минимальная инициализация (с поиском подписки)

Используйте минимальную инициализацию для упрощенного интерактивного взаимодействия с поиском подписки.

azd init --minimal

Этот параметр предоставляет направляющие подсказки для выбора подписки и настройки вашей среды.

Выполнение команд тонкой настройки

Перейдите в папку проекта (где fine-tune-job.yaml находится) и используйте следующие команды для управления заданиями точной настройки.

Совет

Ищете примеры YAML файлов для задач? Ознакомьтесь с примерами интерфейса командной строки точной настройки в репозитории примеров Foundry.

Быстрая отправка (пропуск инициализации)

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

azd ai finetuning jobs submit -f <path-to-yaml> -s <subscription-id> -e <project-endpoint>

Пример

azd ai finetuning jobs submit \
  -f /path-from-working-directory-to-config/job.yaml \
  -s a9096eb7-bfec-47e8-be27-b040b82afac9 \
  -e https://my-resource.services.ai.azure.com/api/projects/my-project
Параметр Описание
-f Путь к файлу YAML задания
-s идентификатор подписки Azure
-e URL-адрес конечной точки проекта

Отправка задания

azd ai finetuning jobs submit -f ./fine-tune-job.yaml

Список заданий

azd ai finetuning jobs list

Отображение сведений о задании

azd ai finetuning jobs show -i <job-id>

Приостановка задания

azd ai finetuning jobs pause -i <job-id>

Возобновление задания

azd ai finetuning jobs resume -i <job-id>

Отмена задания

azd ai finetuning jobs cancel -i <job-id>

Разверните вашу точно настроенную модель

После успешного завершения задания тонкой настройки разверните модель для вывода:

azd ai finetuning jobs deploy -i <job-id> -d "<deployment-name>" -c 100 -m "OpenAI" -s "GlobalStandard" -v "1"
Параметр Описание
-i Идентификатор задания
-d Имя развертывания
-c Емкость
-m Поставщик моделей
-s Имя SKU
-v Версия

Краткий справочник

Параметры инициализации

Параметр Описание
-p Идентификатор ресурса проекта (ARM)
-e URL-адрес конечной точки проекта
-t URL-адрес шаблона или путь
-j Клонирование из идентификатора задания
-w Рабочий каталог
-n Имя среды
-s Идентификатор подписки

Параметры задания

Параметр Описание
-f Путь к файлу YAML
-i Идентификатор задания

Дополнительные ресурсы

  • Last updated on