Создайте проект для Microsoft Foundry

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

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

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

Предпосылки

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

Используйте следующие вкладки, чтобы выбрать метод, который вы хотите использовать для создания project 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 CLI.
Задайте значение по умолчанию для subscription.

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

Создать проект Foundry

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

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

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

Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry включен. Эти действия относятся к Foundry (new).
Проект, над которым вы работаете, отображается в верхнем левом углу.
Чтобы создать новый проект, выберите имя проекта, а затем выберите Создать новый проект.
Присвойте project имя и выберите Create project. Или см. следующий раздел для дополнительных параметров.

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

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

Подсказка

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

Чтобы создать project 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 включает создание проекта в этом ресурсе.
Создайте настраиваемый поддомен для ресурса. Имя custom domain должно быть глобально уникальным. Если 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
```
В выходных данных отображаются свойства project, включая его идентификатор ресурса.

Справочник: учетная запись az cognitiveservices

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

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

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

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

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

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

Чтобы добавить project в ресурс Foundry, выполните приведенные действия.
1. Выберите «Управлять» в правом верхнем углу навигации.
2. Выберите "Администратор" в левой области.
3. Выберите родительский ресурс, к которому нужно добавить проект.
4. Выберите "Добавить проект".
Добавьте этот код в свой скрипт, чтобы создать новый проект на существующем ресурсе.
```
# 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": {}
    }
)
```
Чтобы добавить новый project в my-foundry-resource:
```
 az cognitiveservices account project create \
 --name my-foundry-resource \
 --project-name {new_project_name} \
 --location eastus
```
Если удалить проект по умолчанию для ресурса Foundry, следующий созданный проект станет проектом по умолчанию.

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

На странице проекта Home отображаются конечная точка и ключ API проекта. Если вы используете проверку подлинности Microsoft Entra ID, ключ API не нужен.

# 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.

Чтобы просмотреть параметры project, используйте команду 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 (new).
В правой верхней области навигации выберите "Работа".
В левой области выберите "Администратор".
Выберите ваш проект.
В правом верхнем углу выберите значок корзины, чтобы удалить проект.

Этот код использует переменные и 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.

Это важно

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

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

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

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

Last updated on 2026-03-24

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

Создайте проект для Microsoft Foundry

Предпосылки

Создать проект Foundry

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

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

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

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

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

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

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