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

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

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

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

Это важно

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

Предпосылки

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

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

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

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

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

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

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

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

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

Сначала создайте новую среду 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

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

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

Установить:

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

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

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

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

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

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

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

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

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

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

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

    dotnet --version

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

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

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

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

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

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

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

# 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 (файл > Открыть папку...), чтобы начать работу с project C#. VS Code с расширением C# Dev Kit автоматически обнаруживает проект, предоставляя такие возможности, как 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. Он предоставляет простые команды для ключевых этапов разработки, независимо от использования терминала, интегрированной среды разработки или CI/CD pipelines. Установите 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. Вместо этого используйте виртуальную среду .

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

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