Быстрый старт. Настройка ресурсов Microsoft Foundry

В этом кратком руководстве описано, как создать проект Microsoft Foundry и развернуть модель. Если вы управляете командой, вы также предоставляете доступ участникам команды. После выполнения этих действий вы или ваша команда сможете создавать приложения ИИ с помощью развернутой модели.

Совет

В этом кратком руководстве показано, как создать ресурсы для создания агента с помощью базовой настройки. Дополнительные сценарии, использующие собственные ресурсы, см. в разделе "Настройка среды для разработки агентов".

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

  • Учетная запись Azure с активной подпиской. Если у вас нет, создайте учетную запись free Azure, которая включает бесплатную пробную подписку.
  • Если вы создаете проект для себя:
    • Доступ к роли, которая позволяет создавать ресурс Foundry, например владелец ИИ учетной записи Azure или владелец ИИ Azure в подписке или группе ресурсов. Дополнительные сведения о разрешениях см. в разделе Role-based access control for Microsoft Foundry.
  • Если вы создаете проект для команды:
    • Доступ к роли, которая позволяет выполнять назначения ролей в системе, например владельца. Дополнительные сведения о разрешениях см. в разделе Role-based access control for Microsoft Foundry.
    • Список адресов электронной почты пользователя или идентификаторы групп безопасности Microsoft Entra для участников группы, которым требуется доступ.

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

  • Установите Azure CLI версии 2.67.0 или более поздней (проверьте с помощью az version).

  • Войдите в Azure:

    az login

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

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

  1. Создайте группу ресурсов или используйте существующую. Например, создайте my-foundry-rg в eastus:

    az group create --name my-foundry-rg --location eastus

  2. Создайте ресурс Foundry. Например, создайте my-foundry-resource в my-foundry-rg группе ресурсов:

    az cognitiveservices account create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --kind AIServices \
    --sku s0 \
    --location eastus \
   --allow-project-management

    Флаг --allow-project-management включает создание проекта в этом ресурсе.

  3. Создайте настраиваемый поддомен для ресурса. Имя личного домена должно быть глобально уникальным. Если my-foundry-resource используется, попробуйте использовать более уникальное имя.

    az cognitiveservices account update \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --custom-domain my-foundry-resource

  4. Создайте проект. Например, создайте my-foundry-project в :my-foundry-resource

    az cognitiveservices account project create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project \
    --location eastus

  5. Убедитесь, что проект создан:

    az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project

    В выходных данных отображаются свойства проекта, включая его идентификатор ресурса.

Справочник: az cognitiveservices account

Развертывание модели

Разверните модель, которую можно использовать. В этом примере используется gpt-4.1-mini, но вы можете выбрать любую доступную модель.

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini \
    --model-name gpt-4.1-mini \
    --model-version "2025-04-14" \
    --model-format OpenAI \
    --sku-capacity 10 \
    --sku-name Standard

Убедитесь, что развертывание выполнено успешно:

az cognitiveservices account deployment show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini

Когда развертывание будет готово, выходные данные отображаются "provisioningState": "Succeeded".

Справка: Развертывание учетной записи az cognitiveservices

Узнайте детали подключения вашего проекта

Для подключения к коду требуется конечная точка проекта. Если вы администрируете этот проект для других пользователей, отправьте им эту конечную точку вместе с именем развертывания.

  1. Войдите в Microsoft Foundry с помощью учетной записи Azure.
  2. Выберите проект.
  3. Найдите конечную точку проекта на приветственном экране проекта.На скриншоте Microsoft Foundry Models, показывающем URL-адрес конечной точки и кнопку копирования.
  4. Скопируйте значение конечной точки. Это значение используется в других инструкциях быстрого старта и руководствах.

Для администраторов — предоставление доступа

Если вы управляете командой, назначьте роль Azure пользователя ИИ участникам группы, чтобы они могли использовать проект и развернутые модели. Эта роль предоставляет минимальные разрешения, необходимые для создания и тестирования приложений ИИ. Другие роли, которые могут потребоваться назначить, см. в разделе Role-based access control for Microsoft Foundry

  1. Получите идентификатор ресурса проекта:

    PROJECT_ID=$(az cognitiveservices account project show \
  --name my-foundry-resource \
  --resource-group my-foundry-rg \
  --project-name my-foundry-project \
  --query id -o tsv)

  2. Назначьте роль пользователя Azure AI участнику команды.

    az role assignment create \
    --role "Azure AI User" \
    --assignee "user@contoso.com" \
    --scope $PROJECT_ID

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

    az role assignment create \
    --role "Azure AI User" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

  3. Проверьте назначение роли:

    az role assignment list \
    --scope $PROJECT_ID \
    --role "Azure AI User" \
    --output table

Справочник: az role assignment

Проверка доступа участников команды

Попросите члена группы проверить доступ, выполнив вход в Microsoft Foundry и выбрав проект из списка проектов.

Если член группы не может получить доступ к проекту, убедитесь, что назначение роли выполнено успешно. Убедитесь, что вы использовали правильный адрес электронной почты или идентификатор группы безопасности. Убедитесь, что учетная запись Azure участника команды находится в том же клиенте Microsoft Entra.

Чтобы убедиться, что развернутая модель доступна, попросите члена группы выбрать Build в правом верхнем углу панели навигации, а затем Модели в левой области.

Очистка ресурсов

Если этот проект больше не нужен, удалите группу ресурсов, чтобы удалить все связанные с ней ресурсы.

az group delete --name my-foundry-rg --yes --no-wait

Следующий шаг

Краткое руководство по Microsoft Foundry

  • Last updated on