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

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

Совет

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

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

Учетная запись Azure с активной подпиской. Если у вас нет, создайте учетную запись free Azure, которая включает бесплатную пробную подписку.
Если вы создаете проект для себя:
- Доступ к роли, которая позволяет создать ресурс Foundry, например владелец учетной записи Foundry или владелец Foundry в подписке или группе ресурсов. Дополнительные сведения о разрешениях см. в разделе Role-based access control for Microsoft Foundry.
  
  Important
  
  Недавно были переименованы роли RBAC в Foundry. Foundry User, Foundry Owner, Foundry Account Owner и Foundry Project Manager ранее назывались пользователь Azure AI, владелец Azure AI, владелец учетной записи Azure AI и руководитель проекта Azure AI. Пока новое название внедряется, в некоторых местах вы всё ещё можете видеть прежние названия. Идентификаторы ролей и основные разрешения не меняются из-за переименования.
Если вы создаете проект для команды:
- Доступ к роли, которая позволяет выполнять назначения ролей в системе, например владельца. Дополнительные сведения о разрешениях см. в разделе Role-based access control for Microsoft Foundry.
- Список адресов электронной почты пользователя или идентификаторы групп безопасности Microsoft Entra для участников группы, которым требуется доступ.

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

Azure CLI;
Портал Foundry

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

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

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

Azure CLI;
Портал Foundry

Создайте группу ресурсов или используйте существующую. Например, создайте my-foundry-rg в eastus:
```
az group create --name my-foundry-rg --location eastus
```
Создайте ресурс 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 включает создание проекта в этом ресурсе.
Создайте настраиваемый поддомен для ресурса. Имя личного домена должно быть глобально уникальным. Если my-foundry-resource используется, попробуйте использовать более уникальное имя.
```
az cognitiveservices account update \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --custom-domain my-foundry-resource
```

Создайте проект. Например, создайте 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

Убедитесь, что проект создан:
```
az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project
```
В выходных данных отображаются свойства проекта, включая его идентификатор ресурса.

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

Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry включен. Эти действия относятся к Foundry (new).
Создайте проект.
- Если это первое использование Foundry, вам будет предложено создать или найти проект для продолжения. Выберите "Создать проект" в раскрывающемся списке.
- Если у вас уже загружен проект, выберите его имя в левом верхнем углу и нажмите кнопку "Создать проект".
Введите имя проекта, например my-foundry-project.
Выберите дополнительные параметры , чтобы настроить группу ресурсов и расположение:
- Группа ресурсов: создайте новую группу ресурсов или выберите существующую. Если вы создаете новую группу ресурсов, вы можете более легко управлять проектом и всеми его ресурсами вместе.
- Расположение. Выберите регион, ближайший к вашей команде.
Выберите "Создать проект".

Дождитесь создания проекта. Когда появится страница обзора проекта, проект готов.

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

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

Azure CLI;
Портал Foundry

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

Выберите "Обнаружить " в правой верхней части навигации, а затем " Модели " на левой панели.
Найдите gpt-4.1-mini.
Выберите "Развернуть>параметры по умолчанию", чтобы добавить его в проект.
Обратите внимание на имя развертывания (например, gpt-4.1-mini). Вашей команде необходимо это имя, чтобы использовать модель.

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

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

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

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

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

Important

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

Azure CLI;
Портал Foundry

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

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)

Назначьте роль "Пользователь Foundry" участнику команды:

Important

Недавно были переименованы роли RBAC в Foundry. Foundry User, Foundry Owner, Foundry Account Owner и Foundry Project Manager ранее назывались пользователь Azure AI, владелец Azure AI, владелец учетной записи Azure AI и руководитель проекта Azure AI. Пока новое название внедряется, в некоторых местах вы всё ещё можете видеть прежние названия. Идентификаторы ролей и основные разрешения не меняются из-за переименования.
```
az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee "user@contoso.com" \
    --scope $PROJECT_ID
```

Note

Так как роли Foundry RBAC были недавно переименованы, используйте идентификатор определения роли (GUID) вместо имени роли в коде, чтобы избежать проблем во время развертывания переименования:

Пользователь Foundry: 53ca6127-db72-4b80-b1b0-d745d6d5456d
Владелец Foundry: c883944f-8b7b-4483-af10-35834be79c4a
Владелец учетной записи Foundry: e47c6f54-e4a2-4754-9501-8e0985b135e1
Менеджер проектов Foundry: eadc314b-1a2d-4efa-be10-5d325db5065e

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

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

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

az role assignment list \
    --scope $PROJECT_ID \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --output table

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

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

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

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

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

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

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

Azure CLI;
Портал Foundry

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

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

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

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-05-20