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

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

Tip

Foundry DevPack — это рекомендуемый способ установки средств разработчика в одной команде. Вы также можете установить каждое средство отдельно.

Важно

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

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

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

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

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

    • Foundry Project Manager для управления проектами Foundry.

    Важно

    Недавно были переименованы роли RBAC в Foundry. Foundry User, Foundry Owner, Foundry Account Owner и Foundry Project Manager ранее назывались пользователь Azure AI, владелец Azure AI, владелец учетной записи Azure AI и руководитель проекта Azure AI. Пока новое название внедряется, в некоторых местах вы всё ещё можете видеть прежние названия. Идентификаторы ролей и основные разрешения не меняются из-за переименования.

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

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

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

Установка Foundry DevPack

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

Windows

winget install Microsoft.FoundryDevPack

macOS

brew install --cask microsoft/foundry/devpack && foundry-devpack install

Linux

curl -fsSL https://aka.ms/foundry-devpack-install.sh | bash

DevPack устанавливает следующие средства:

инструмент Что можно сделать
набор средств Microsoft Foundry для Visual Studio Code Сборка, тестирование, оценка и развертывание из Visual Studio Code.
azd и azd ai. Создавайте шаблоны, развертывайте, оценивайте и автоматизируйте через терминал.
Foundry Canvas (предварительная версия) Создавайте и развертывайте размещаемых агентов в холсте Copilot с пошаговыми подсказками.
Навык Microsoft Foundry Предоставьте агентам для программирования повторно используемые рекомендации для рабочих процессов Foundry.

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

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

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

Питон

Установите Python 3.10 или более поздней версии. Python 3.9 — минимальная поддерживаемая версия. Создайте виртуальную среду для проекта вместо глобальной установки пакетов.

Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS и Linux

python3 -m venv .venv
source .venv/bin/activate

Для поддержки редактора установите расширение Python для Visual Studio Code.

Java

Установите JDK 17 или более поздней версии. Microsoft Build of OpenJDK — это бесплатный дистрибутив с долгосрочной поддержкой. Для поддержки редактора установите пакет расширения Visual Studio Code для Java.

JavaScript/TypeScript

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

C#

Установите последнюю версию с долгосрочной поддержкой .NET SDK. Для поддержки редактора установите пакет разработки C# для Visual Studio Code.

Установка 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

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

Установка Git

Чтобы клонировать примеры пакета SDK для Foundry, вам потребуется Git. Если у вас нет Git, скачайте и установите его с веб-сайта Git.

Установить инструменты разработчика по отдельности

Если вы не используете Foundry DevPack, установите каждое средство разработчика отдельно:

  1. Установите Azure Developer CLI.
  2. Установите все расширения Foundry для azd: 
    azd ext install microsoft.foundry
    Чтобы вместо этого установить отдельные расширения, см. раздел Установка расширений Foundry для Azure Developer CLI.
  3. Установите редактор и средства агента кодирования:

Многие шаблоны решений ИИ поддерживают развертывание через azd.

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

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

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

  • Last updated on