Создание проекта для Microsoft Foundry (классическая модель)

Используйте эту статью для создания проекта Foundry и подтверждения готовности среды перед началом создания агентов, оценки и файлов.

В настоящее время просмотр:Версия портала Foundry (классическая версия) - Переключиться на версию для нового портала Foundry

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

Проект Foundry управляется в ресурсе Microsoft Foundry. Это контейнер для управления доступом, отправки и интеграции данных и мониторинга. Это позволяет разделять вашу работу по различным случаям использования, не требуя создания дополнительных ресурсов Azure.
Если вам нужен доступ к моделям с открытым исходным кодом или PromptFlow, создайте вместо него тип центрального проекта .
Дополнительные сведения о различных типах проектов см. в разделе "Типы проектов".

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

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

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

Если эта роль отсутствует, попросите администратора подписки создать ресурс Foundry и перейти к созданию нескольких проектов в одном ресурсе.

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

При использовании портала не требуется никаких других предварительных требований.

Настройте среду разработки.
Запустите az login или az login --use-device-code в среде перед выполнением кода.
Установка пакетов: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Если вы находитесь в ячейке записной книжки, используйте %pip install вместо этого.
Используйте pip show azure-mgmt-cognitiveservices для проверки того, что версия 13.7 или выше.

Быстрая проверка. Перед созданием проекта проверьте пакет SDK и проверку подлинности, проверив клиент:

from azure.identity import DefaultAzureCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient

# Test authentication by instantiating the client
credential = DefaultAzureCredential()
subscription_id = "<your-subscription-id>"  # Replace with your subscription ID
client = CognitiveServicesManagementClient(credential, subscription_id)
print("✓ Authentication successful! Ready to create a project.")

Запустите скрипт со следующим кодом, чтобы создать client соединение и переменные, используемые в этой статье. В этом примере проект создается в регионе Восток США.

from azure.identity import DefaultAzureCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient

subscription_id = 'your-subscription-id'
resource_group_name = 'your-resource-group-name'
foundry_resource_name = 'your-foundry-resource-name'
foundry_project_name = 'your-foundry-project-name'
location = 'eastus'

client = CognitiveServicesManagementClient(
    credential=DefaultAzureCredential(), 
    subscription_id=subscription_id,
    api_version="2025-04-01-preview"
)

(Необязательно) Если у вас несколько учетных записей, добавьте идентификатор клиента Microsoft Entra ID, который вы хотите использовать в DefaultAzureCredential:
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```

(Необязательно) Если вы работаете в Azure для государственных организаций - US или Azure, управляемых регионами 21Vianet, укажите регион, в который требуется выполнить проверку подлинности. В этом примере выполняется проверка подлинности в облаке Azure для государственных организаций - регионе США.
```
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
```

Установите Azure CLI.
Задайте значение по умолчанию для subscription.

# Set your default subscription
az account set --subscription "{subscription-name}"

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

Используйте один из следующих методов.

Эти действия позволяют создать новый ресурс Azure с основными параметрами по умолчанию.

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

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

Дополнительные параметры

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

Совет

Особенно для начала работы создайте новую группу ресурсов для проекта. Группа ресурсов упрощает управление проектом и всеми его ресурсами вместе.
Выберите расположение или используйте значение по умолчанию. Расположение — это регион, в котором размещаются ресурсы проекта.
Нажмите кнопку "Создать". Вы видите ход создания ресурсов. Проект создается после завершения процесса.

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

Добавьте следующий код для создания проекта Foundry с использованием переменных и подключения client из раздела с предварительными требованиями.

# Create resource
resource = client.accounts.begin_create(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    account={
        "location": location,
        "kind": "AIServices",
        "sku": {"name": "S0",},
        "identity": {"type": "SystemAssigned"},
        "properties": {
            "allowProjectManagement": True,
            "customSubDomainName": foundry_resource_name
        }
    }
)

# Wait for the resource creation to complete
resource_result = resource.result()

# Create default project
project = client.projects.begin_create(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name,
    project={
        "location": location,
        "identity": {
            "type": "SystemAssigned"
        },
        "properties": {}
    }
)

Ссылки: CognitiveServicesManagementClient.

Создайте группу ресурсов или используйте существующую. Например, создайте 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

Создание нескольких проектов в одном ресурсе

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

Схема показывает, как команда может совместно использовать доступ к ресурсам с несколькими проектами в ресурсе Foundry.

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

Хотя не все возможности Foundry поддерживают организацию работы в проектах, но первый проект ресурса по умолчанию более мощный. Его можно определить по тегу default в интерфейсах пользовательского интерфейса и свойству ресурса "is_default" при использовании параметров кода.

Функция	Проект по умолчанию	Другие проекты
Вывод модели	✅	✅
Игровые площадки	✅	✅
Агенты	✅	✅
Оценки	✅	✅
Трассировка	✅	✅
Наборы данных	✅	✅
Индексы	✅	✅
Foundry SDK и API	✅	✅
Понимание содержимого	✅	✅
Пакет SDK для OpenAI и API	✅	Ответы, файлы, беседы
Пакет OpenAI, тонкая настройка, сохраненные завершения	✅	-
Настройка языка	✅	✅
Точная настройка речи	✅	-
Соединения	✅	✅

Чтобы добавить проект в ресурс Foundry, выполните приведенные действия.
- Портал Foundry
- пакет SDK Python
- Azure CLI
Совет

Так как вы можете настроить левую панель на портале Microsoft Foundry, вы можете увидеть элементы, которые могут отличаться от тех, что показаны в этих шагах. Если вы не видите, что вы ищете, выберите ... Подробнее в нижней части левой панели.
1. Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry отключен. Эти шаги относятся к Foundry (classic).
2. Выберите проект Foundry или связанный с ним ресурс.
3. В левой области выберите центр управления.
4. В разделе ресурсов выберите "Обзор".
5. Выберите новый проект и укажите имя.
Добавьте этот код в скрипт, чтобы создать проект на существующем ресурсе:
```
# Create additional project
new_project_name = 'your-new-project-name'

project = client.projects.begin_create(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=new_project_name,
    project={
        "location": location,
        "identity": {
            "type": "SystemAssigned"
        },
        "properties": {}
    }
)
```
Добавление нового проекта в my-foundry-resource:
```
 az cognitiveservices account project create \
 --name my-foundry-resource \
 --resource-group my-foundry-rg \
 --project-name {new_project_name} \
 --location eastus
```
Если удалить проект по умолчанию ресурса Foundry, следующий созданный проект станет проектом по умолчанию.

Просмотр параметров проекта

На домашней странице проекта вы найдете сведения о проекте.

Имя: имя проекта отображается в левом верхнем углу.
Подписка: подписка, на которой размещен ресурс, на котором размещен проект.
Группа ресурсов: группа ресурсов, в которую размещается ресурс, на котором размещен проект.

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

Ссылки: CognitiveServicesManagementClient.

Чтобы просмотреть параметры проекта, используйте az cognitiveservices account project show команду. Например:

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

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

Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry отключен. Эти действия относятся к Foundry (classic).
Откройте проект.
Выберите центр управления.
В разделе "Ресурс" выберите "Обзор".
Выберите все проекты, которые вы больше не хотите хранить.
Выберите "Удалить проект".

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

В центре управления выберите имя ресурса из раздела "Обзор", чтобы перейти на портал Azure.
На портале Azure выберите Delete, чтобы удалить ресурс и все связанные с ним проекты.

Этот код использует переменные и client подключение из раздела предварительных требований. Удаление одного проекта:

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Ссылки: CognitiveServicesManagementClient.

Удалите ресурс Foundry и все его проекты:

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

Ссылки: CognitiveServicesManagementClient.

Выполните следующую команду:

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

Ссылки: az cognitiveservices account project delete.

Важно

Используйте с осторожностью. После удаления проекта невозможно восстановить.

Создание первого подключения

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

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

Last updated on 2026-05-01

Создание проекта для Microsoft Foundry (классическая модель)

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

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

Дополнительные параметры

Создание нескольких проектов в одном ресурсе

Просмотр параметров проекта

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

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

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

Дополнительные ресурсы