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

Замечание

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

🔄 Перейдите в новую документацию по Microsoft Foundry, если вы используете новый портал.

Замечание

Этот документ относится к порталу Microsoft Foundry (new).

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

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

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

Предпосылки

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

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

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

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

Используйте следующие вкладки, чтобы выбрать метод, который вы хотите использовать для создания проекта Foundry:
- Учетная запись Azure с активной подпиской. Если у вас его нет, создайте бесплатную учетную запись Azure, которая включает бесплатную пробную подписку.
- Настройка среды разработки
- Запустите az login или az login --use-device-code в среде перед выполнением кода.
- Быстрая проверка. Перед созданием проекта убедитесь, что пакет 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.")
```
- Выполните следующие действия, чтобы запустить скрипт Python:
  
  Установите пакеты: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. Если вы находитесь в ячейке записной книжки, используйте %pip install вместо этого.
  
  Используйте pip show azure-mgmt-cognitiveservices, чтобы убедиться, что ваша версия 13.7 или выше.
  
  Запустите скрипт со следующим кодом, чтобы создать 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" )
  
  (Необязательно) Если у вас несколько учетных записей, добавьте в DefaultAzureCredential идентификатор тенанта Microsoft Entra ID, который вы хотите использовать.
  
  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  
  (Необязательно) Если вы работаете в Azure Government - США или Azure, управляемом 21Vianet, укажите регион, в котором требуется пройти проверку подлинности. В этом примере выполняется проверка подлинности для Azure Government в регионе США.
  
  from azure.identity import AzureAuthorityHosts DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
- Выполните следующие действия, чтобы запустить скрипт Python:
  
  Установите пакеты: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. Если вы находитесь в ячейке записной книжки, используйте %pip install вместо этого.
  
  Используйте pip show azure-mgmt-cognitiveservices, чтобы убедиться, что ваша версия 13.7 или выше.
  
  Запустите скрипт со следующим кодом, чтобы создать 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" )
  
  (Необязательно) Если у вас несколько учетных записей, добавьте в DefaultAzureCredential идентификатор тенанта Microsoft Entra ID, который вы хотите использовать.
  
  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
- Установите Azure CLI.
- Задайте значения по умолчанию для subscription и resource group.
```
  # Set your default subscription
  az account set --subscription "{subscription-name}"

  # Set default resource group
  az config set defaults.group={resource-group-name}
```

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

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

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

Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry отключен. Эти действия относятся к Foundry (классическая).

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

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

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

Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry отключен. Эти действия относятся к Foundry (классическая).

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

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

Вы создаете проект 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.

Выполните проверку подлинности в подписке Azure из Azure CLI с помощью следующей команды:
```
az login
```
Дополнительные сведения о проверке подлинности см. в разделе "Методы проверки подлинности".
Создайте группу ресурсов, например в восточной части США:
```
az group create --name {my_resource_group} --location eastus
```

Создание ресурса Foundry

az cognitiveservices account create \
--name {your-foundry-resource-name} \
--kind AIServices \
--location eastus \
--sku s0 \
--allow-project-management

Создайте проект:

az cognitiveservices account project create \
--name {your-foundry-resource-name} \
--project-name {your-project-name} \
--location eastus

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

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

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

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

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

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

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

Так как вы можете настроить левую панель на портале Microsoft Foundry, вы можете увидеть другие элементы, отличные от указанных в этих шагах. Если вы не видите, что вы ищете, выберите ... Подробнее в нижней части левой панели.
1. Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry отключен. Эти действия относятся к Foundry (классическая).
  
  Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry включен. Эти действия относятся к Foundry (new).
2. Выберите проект Foundry или связанный с ним ресурс.
3. В левой области выберите центр управления.
4. В разделе ресурсов выберите "Обзор".
5. Выберите новый проект и укажите имя.
Портал Foundry (new) отображает только проект по умолчанию для каждого ресурса Foundry. Вы не можете создать несколько проектов или просмотреть любые недефакционные проекты на портале Foundry (new).
Хотя этот код может добавить дополнительные проекты в ресурс, вы не сможете просматривать их на портале Foundry (new). На портале Foundry (new) доступен только проект по умолчанию для ресурса.

Добавьте этот код в скрипт, чтобы создать проект на существующем ресурсе:
```
# 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": {}
    }
)
```
Хотя этот код может добавить дополнительные проекты в ресурс, вы не сможете просматривать их на портале Foundry (new). На портале Foundry (new) доступен только проект по умолчанию для ресурса.

Используйте существующие значения для {foundry_resource_name} для добавления другого проекта в ресурс:
```
 az cognitiveservices account project create \
 --name {foundry_resource_name} \
 --project-name {my_project_name} \
 --location {location}
```
Если удалить проект по умолчанию ресурса Foundry, следующий созданный проект станет проектом по умолчанию.

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

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

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

На домашней странице проекта отображается конечная точка проекта и ключ API для проекта. Ключ API не нужен, если вы используете проверку подлинности идентификатора Microsoft Entra.

# 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 connection show команду. Рассмотрим пример.

az cognitiveservices account connection show \
--name <my_project_name> \
--resource-group <my_resource_group>

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

Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry отключен. Эти действия относятся к Фаундри (классическая модель).

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

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

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

Войдите в Microsoft Foundry. Убедитесь, что переключатель New Foundry отключен. Эти действия относятся к Фаундри (классическая модель).

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

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

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 {foundry_resource_name} \
--project-name {my_project_name}

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

Это важно

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

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

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

Last updated on 2026-01-09

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

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

Предпосылки

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

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

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

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

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

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

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

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