Поделиться через

Подготовка среды разработки

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

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

Это важно

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

Предпосылки

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

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

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

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

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

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

    Дополнительные сведения о разрешениях каждой роли см. в разделе "Управление доступом на основе ролей" для Microsoft Foundry.

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

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

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

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

Используйте Python 3.10 или более поздней версии, но требуется по крайней мере Python 3.9. Если у вас нет подходящей версии Python, следуйте инструкциям в руководстве по Python VS Code , чтобы проще всего установить 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 с интеллектуальными подсказками, отладкой, форматированием, линтингом, анализом кода, навигацией по коду, рефакторингом, инспектором переменных, обозревателем тестов и управлением средой.

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

Установить:

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

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

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

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

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

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

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

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

  1. Скачайте пакет SDK для .NET с официальной страницы загрузки .NET. Выберите соответствующий установщик операционной системы (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. Установите расширение, опубликованное корпорацией Майкрософт. Это также установит базовое расширение C#, если у вас еще нет этого расширения.

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

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

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

# 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 OpenAI в Microsoft Foundry Models.

В большинстве случаев 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. Он предоставляет простые команды для ключевых этапов разработки, независимо от того, используете ли вы терминал, IDE или конвейеры CI/CD. Установите интерфейс командной строки разработчика Azure для своей платформы.

Многие шаблоны решений ИИ включают вариант развертывания с помощью 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. Вместо этого используйте виртуальную среду .

Связанный контент

  • Last updated on