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

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

Настройте среду разработки для использования пакета SDK Майкрософт 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 AI в используемых вами проектах (роль с минимальными привилегиями для разработки)

    Дополнительные сведения о разрешениях каждой роли см. в разделе Role-based access control for Майкрософт 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, который является бесплатным дистрибутивом OpenJDK с долгосрочной поддержкой (LTS).

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

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

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

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

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

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

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

  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 (терминал > новый терминал).

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

# 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 через 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 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. Вместо этого используйте виртуальную среду .

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

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