Подготовка среды разработки (классическая модель)

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

Примечание

Содержание в новой документации Microsoft Foundry может открываться по ссылкам в этой статье вместо документации Foundry (классической версии), которую вы просматриваете сейчас.

Настройте среду разработки для использования пакета SDK Microsoft Foundry. Кроме того, вам потребуется Azure CLI для проверки подлинности, чтобы код смог получить доступ к учетным данным пользователя.

В этой статье вы устанавливаете языковые среды выполнения, Azure CLI, Azure CLI разработчика, расширение Foundry VS Code и Git.

Важно

В этой статье рассматриваются только общие предварительные требования , такие как языковые среды выполнения, глобальные инструменты и настройка VS Code и расширение.
Он не охватывает определенные сценарии действия, такие как установка пакета SDK или проверка подлинности.
Когда среда будет готова, перейдите к руководству по быстрому началу, следуя этим инструкциям.

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

  • Учетная запись Azure с активной подпиской. Если у вас нет, создайте учетную запись free Azure, которая включает бесплатную пробную подписку.

  • Скачайте, установите и настройте Visual Studio Code или интегрированную среду разработки. Дополнительные сведения см. в разделе Download Visual Studio Code.

  • Чтобы создать и управлять ресурсами Foundry, необходима одна из следующих ролей RBAC в Azure

    • Azure Ai Project Manager (для управления проектами Foundry)
    • Владелец (для разрешений на уровне подписки). Владелец необходим для дополнительных назначений ролей, необходимых для других сценариев в Foundry. Чтобы обеспечить отсутствие блокировок для всех сценариев в Foundry, Владелец — обязательное назначение роли.

  • Чтобы использовать проект, но не создавать новые ресурсы, вам потребуется по крайней мере:

    • Пользователь Azure искусственного интеллекта в используемых вами проектах (роль с наименьшими возможными привилегиями для разработки)

    Дополнительные сведения о разрешениях каждой роли см. в разделе Role-based access control for Microsoft Foundry.

Установка языка программирования

В Visual Studio Code создайте новую папку для проекта. Откройте окно терминала в этой папке.

Сначала создайте новую среду Python. Не устанавливайте пакеты в глобальную установку Python. Всегда используйте виртуальную или конда-среду при установке пакетов Python. В противном случае можно разорвать глобальную установку Python.

При необходимости установите Python

Используйте Python 3.10 или более поздней версии, но требуется по крайней мере Python 3.9. Если у вас нет подходящей версии Python, следуйте инструкциям в руководстве VS Code Python для простого способа установки Python в операционной системе.

Создание виртуальной среды

Если у вас уже установлена Python 3.10 или более поздней версии, создайте виртуальную среду с помощью следующих команд:

py -3 -m venv .venv
.venv\scripts\activate

При активации среды Python выполнение python или pip из командной строки использует интерпретатор Python в папке .venv приложения.

Примечание

Используйте команду deactivate для выхода из виртуальной среды Python. При необходимости его можно повторно активировать.

Установите расширение Python для Visual Studio Code

Расширение Python для Visual Studio Code поддерживает Python с IntelliSense, отладкой, форматированием, структурированием, навигацией по коду, рефакторингом, обозревателем переменных, обозревателем тестов и управлением средой.

Установите расширение Python для Visual Studio Code.

Установить:

  • пакет средств разработки Java (JDK) 17 или более поздней версии
    • Мы рекомендуем Microsoft Build of OpenJDK, что это бесплатное, долгосрочное (LTS) распространение OpenJDK.

Установка пакета расширений Visual Studio Code для Java

Пакет расширений для Java — это коллекция популярных расширений, которые помогают создавать, тестировать и отлаживать приложения Java в Visual Studio Code.

Установите пакет расширений Visual Studio Code для Java.

Установка Node.js (рекомендуется использовать версию 20 или более позднюю).

Убедитесь, что для разработки .NET установлены необходимые средства.

Установка пакета SDK для .NET

Вам потребуется пакет SDK .NET (пакет средств разработки программного обеспечения) для создания, сборки и запуска приложений .NET. При необходимости рекомендуется установить последнюю версию LTS (долгосрочную поддержку) или более позднюю версию.

  1. Скачайте пакет SDK .NET с официальной страницы загрузки .NET official .NET download page. Выберите соответствующий установщик операционной системы (Windows, Linux или macOS).

  2. Следуйте инструкциям по установке операционной системы.

  3. Проверьте установку, открыв терминал или командную строку и выполнив следующую команду:

    dotnet --version

    Ответ должен быть установленной версией пакета SDK.

Установка пакета средств разработки C# для Visual Studio Code

Чтобы лучше всего использовать разработку C# в VS Code, установите официальное расширение комплекта разработки на C#:

  1. Откройте Visual Studio Code.
  2. Перейдите в представление расширений (CTRL+SHIFT+X или CMD+SHIFT+X).
  3. Найдите комплект разработки на C#.
  4. Установите расширение, опубликованное Microsoft. Это также установит базовое расширение C#, если у вас еще нет этого расширения.

Создать новый проект .NET

Вы можете создать проект .NET с помощью терминала, встроенного в Visual Studio Code (терминал > новый терминал).

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

# Navigate to the directory where you want to create your project
# cd path/to/your/projects

# Create a new console application in a subfolder named MyConsoleApp
dotnet new console -o MyConsoleApp

# Navigate into the newly created project folder
cd MyConsoleApp

Теперь вы можете открыть эту папку MyConsoleApp в VS Code (Файл > Открыть папку...), чтобы начать работу над вашим проектом C#. VS Code с расширением комплекта разработки на C# автоматически обнаружит проект, включив такие функции, как IntelliSense, отладка и задачи сборки.

Установка Azure CLI и вход

Установите Azure CLI и войдите из локальной среды разработки, чтобы код смог использовать учетные данные пользователя для вызова служб Azure через Foundry.

В большинстве случаев можно установить Azure CLI из терминала с помощью следующей команды:

winget install -e --id Microsoft.AzureCLI

Вы можете следовать инструкциям как установить Azure CLI, если эти команды не работают для вашей конкретной операционной системы или конфигурации.

После установки Azure CLI выполните вход с помощью команды az login и входа с помощью браузера:

az login

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

az login --use-device-code

Сохраните этот терминал открытым для запуска скриптов после входа.

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

Интерфейс командной строки разработчика Azure (azd) — это средство с открытым кодом, которое помогает настраивать и развертывать ресурсы приложений на Azure. Он предоставляет простые команды для ключевых этапов разработки, независимо от того, используется ли терминал, интегрированная среда разработки или конвейеры CI/CD. Установите Azure Developer CLI для вашей платформы.

Многие шаблоны решений ИИ включают вариант развертывания с помощью azd.

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

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

Установка Git

Для клонирования примеров пакета SDK для Foundry требуется Git. Если у вас нет Git, следуйте инструкциям для вашей платформы и выберите операционную систему.

Устранение неполадок

Проблема Разрешение
Команда не найдена после установки Закройте и снова откройте терминал или перезапустите VS Code, чтобы изменения PATH вступили в силу.
az login вызывает ошибку браузера Запустите az login --use-device-code, чтобы выполнить аутентификацию с использованием потока кода устройства.
Python не найдено Используйте python3 вместо python macOS или Linux или установите поддерживаемую версию (3.9 или более поздней).
Разрешение, отклоненное во время установки В macOS/Linux избегайте sudo pip install. Вместо этого используйте виртуальную среду .

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

  • Справочная документация по пакету SDK .NET
  • Основная документация по SDK Java
  • Last updated on