Работа с Microsoft Foundry над плагином Visual Studio Code (классическая модель)

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

В этой статье вы узнаете, как установить и использовать Microsoft Foundry для расширения Visual Studio Code. Создавайте проекты, развертывайте модели из каталога моделей Foundry и взаимодействуйте с площадками для работы с моделями из VS Code.

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

• Подписка Azure. Создайте его бесплатно.
• установлен Visual Studio Code.
• Подписка должна быть ниже квоты , чтобы развернуть новую модель в этой статье. Если квота уже достигнута, необходимо иметь развернутую модель чата.
• Соответствующие разрешения RBAC для создания ресурсов Foundry и управления ими. Дополнительные сведения см. в разделе "Управление доступом на основе ролей" для Foundry.

Установка расширения

Чтобы использовать возможности Foundry в VS Code, установите Foundry для расширения Visual Studio Code. Установите из Visual Studio Code Marketplace или непосредственно из VS Code.

Установка из Visual Studio Code Marketplace

Используйте Marketplace, чтобы установить расширение, не открывая VS Code первым.

1. Откройте страницу расширения Foundry для Visual Studio Code.
2. Нажмите кнопку "Установить ".
3. Следуйте инструкциям по установке расширения в Visual Studio Code.
4. После установки откройте Visual Studio Code и убедитесь, что расширение успешно установлено из сообщений о состоянии.
5. Значок Foundry отображается в основной панели навигации слева от VS Code.

Установка из Visual Studio Code

Кроме того, выполните поиск расширения непосредственно из представления расширений VS Code.

1. Откройте VS Code.

2. Выберите расширения в левой области.

3. Щелкните значок "Параметры" в правом верхнем углу области расширений.

4. Найдите и выберите Foundry.

5. Выберите "Установить".

6. После завершения установки сообщение о состоянии подтверждает установку расширения. Значок Foundry отображается на левой панели навигации.

Подключение к ресурсам Azure

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

Вход в ваши ресурсы

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

1. Щелкните значок Azure на панели навигации VS Code.

2. Выберите Войти в Azure... в представлении Azure Resources.

3. В разделе Resources выберите подписку Azure и группу ресурсов.

4. Выберите Foundry и щелкните проект правой кнопкой мыши.

5. Выберите "Открыть" в расширении Foundry.

   Ресурсы проекта Foundry отображаются в представлении расширения, а значок Foundry отображается на панели навигации VS Code.

Навигация по интерфейсу расширения

Расширение Foundry упорядочивает рабочую область в три основных раздела.

Создание проекта

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

1. Щелкните значок "плюс" рядом с ресурсами в разделе "Ресурсы" представления расширения Foundry.

   Можно создать новую группу ресурсов или выбрать существующую.

2. Чтобы создать новую группу ресурсов, выполните приведенные действия.

   1. Выберите Создать новую группу ресурсов и нажмите клавишу ВВОД.

   2. Введите имя группы ресурсов Azure в текстовом поле Enter новой группы ресурсов и нажмите клавишу ВВОД.

   3. Выберите расположение, которое нужно использовать в списке доступных расположений, и нажмите клавишу ВВОД.

3. Чтобы использовать существующую группу ресурсов:

   • Выберите группу ресурсов, которую вы хотите использовать из списка доступных, и нажмите клавишу ВВОД.

4. Введите имя проекта Foundry в текстовом поле Ввод имени проекта и нажмите клавишу Enter.

После развертывания project появится всплывающее окно с сообщением Project успешно развернуто.

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

Переключение проекта по умолчанию

При открытии проекта в расширении Foundry этот проект устанавливается в качестве проекта по умолчанию. Чтобы переключить проект по умолчанию, выполните приведенные действия.

1. Щелкните правой кнопкой мыши на проекте Foundry и выберите опцию Switch Default Project в Azure Extension.

2. Выберите проект Foundry из списка доступных проектов, который вы хотите использовать, и нажмите клавишу Enter.

Выбранный проект теперь отображает Default после имени проекта.

Работа с моделями

Расширение Foundry позволяет обнаруживать, развертывать и взаимодействовать с моделями из каталога моделей Foundry непосредственно в VS Code.

Обзор каталога моделей

Каталог моделей предоставляет доступ к моделям из Microsoft, OpenAI, Meta, DeepSeek и других поставщиков. Каталог моделей можно открыть несколькими способами:

• Выполните команду Foundry: откройте каталог моделей из палитры команд.
• Щелкните значок плюса рядом с моделями в разделе "Ресурсы " представления расширения Foundry.
• Выберите ссылку каталога моделей в разделе "Сервис " представления расширения Foundry.

Открытие каталога моделей из палитры команд

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

1. Выберите F1 , чтобы открыть палитру команд.

2. Введите команду Foundry: Откройте Каталог Моделей и нажмите клавишу Ввод.

3. Откроется страница каталога моделей .

   

4. Фильтрация каталога Model по Hosted byPublisher, Feature или Model type с помощью раскрывающихся списков в верхней части страницы. Выберите переключатель поддержки "Fine-Tuning", чтобы фильтровать модели, поддерживающие "Fine-Tuning".

5. Найдите определенную модель с помощью панели поиска в верхнем центре страницы.

Открытие каталога моделей из раздела "Ресурсы"

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

Откройте каталог моделей из раздела "Инструменты"

В разделе "Сервис" представления расширения Foundry дважды щелкните ссылку каталога моделей .

Развертывание модели из каталога моделей

После поиска модели в каталоге разверните ее в проекте Foundry, чтобы его можно было использовать в приложениях.

1. Нажмите кнопку "Развернуть " рядом с именем выбранной модели.

2. Откроется страница развертывания модели .

3. Введите имя развертывания модели в текстовом поле "Ввод имени развертывания " и нажмите клавишу ВВОД.

4. Выберите тип развертывания в раскрывающемся списке "Тип развертывания ".

5. Выберите версию модели в раскрывающемся списке "Версия модели ".

6. (Необязательно) Отрегулируйте количество маркеров в минуту с помощью ползунка Маркеры в минуту.

7. Нажмите кнопку "Развернуть в Foundry" в левом нижнем углу.

8. В диалоговом окне подтверждения нажмите кнопку "Развернуть".

9. После завершения развертывания модель отображается по имени развертывания в разделе "Модели " проекта.

Просмотр развернутых моделей и управление ими

Разверните раздел "Модели " в представлении расширения Foundry, чтобы просмотреть все развернутые модели в проекте.

Просмотр сведений о карточке модели

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

• Сведения о развертывании: имя, состояние подготовки, тип развертывания, ограничение скорости, сведения о версии, имя модели и версия модели.
• Сведения о конечной точке: ссылка на целевой URI, тип проверки подлинности и ключ.
• Полезные ссылки: примеры репозитория кода и ссылки на учебники для разработки приложений ИИ.

Обновление параметров развертывания модели

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

1. Нажмите кнопку "Изменить " в правом верхнем углу карточки модели.
2. Обновите редактируемые поля.
3. Нажмите кнопку "Сохранить ", чтобы применить изменения.

Создание примера кода для модели

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

1. Щелкните правой кнопкой мыши развернутую модель и выберите "Открыть файл кода".

2. Выберите предпочитаемый пакет SDK в раскрывающемся списке "Выбор предпочтительного пакета SDK ".

3. Выберите предпочитаемый язык в раскрывающемся списке "Выбор языка ".

4. Выберите предпочтительный метод проверки подлинности в раскрывающемся списке "Выбор метода проверки подлинности ".

5. Пример файла кода открывается на новой вкладке в VS Code.

На следующем снимке экрана показан созданный Python пример, который выполняет синхронный вызов API ответов:

Взаимодействие с моделями на детской площадке

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

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

1. Откроется страница "Детская площадка ".

2. Введите запрос и просмотрите выходные данные.

3. Выберите "Просмотреть код " в правом верхнем углу, чтобы узнать, как получить доступ к развертыванию модели программным способом.

4. Щелкните ссылку "Журнал " в левом верхнем углу игровой площадки, чтобы просмотреть журнал чата.

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

Если при использовании расширения Foundry возникают проблемы, проверьте следующие распространенные проблемы:

Очистка ресурсов

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

Удалите ваши модели

1. На панели навигации VS Code обновите расширение Foundry. В разделе "Ресурсы" разверните подраздел "Модели ".

2. Щелкните правой кнопкой мыши развернутую модель, которую вы хотите удалить, и выберите пункт "Удалить".

Удаление ресурсов Azure

Чтобы удалить группу ресурсов и все ресурсы в ней, выполните следующие действия.

1. Откройте портал Azure.
2. Перейдите к группе ресурсов, содержащей проект Foundry.
3. Выберите "Удалить группу ресурсов " и подтвердите удаление.

Дальнейшие действия

• Работа с агентом службы в Visual Studio Code
• Изучение моделей Foundry
• Развертывание моделей с помощью Foundry