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

Замечание

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

Замечание

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

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

Проект Foundry управляется ресурсом Microsoft Foundry. Это контейнер для управления доступом, отправки и интеграции данных и мониторинга. Это позволяет сохранять работу между вариантами использования без необходимости создавать дополнительные ресурсы Azure.
Этот тип проекта предоставляет доступ к последним функциям генерируемого ИИ в Foundry, в том числе:
- Агенты
- Foundry SDK и API для создания агентов и легкого переключения между моделями.
- Модели, проданные непосредственно Azure — Azure OpenAI, Mistral, xAI, DeepSeek и т. д.
- Модели партнеров и сообщества, проданные через Marketplace — стабильность, Cohere и т. д.
- Понимание содержимого
- Оценки
- Точная настройка
- Пакетная обработка и хранимые завершения в OpenAI SDK и API
- Службы искусственного интеллекта
Вам нужен доступ к моделям с открытым кодом или PromptFlow? Создайте вместо него тип центрального проекта .
Дополнительные сведения о различных типах проектов см. в разделе "Типы проектов ".

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

Предпосылки

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

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

Вы должны быть владельцем подписки, чтобы иметь соответствующий контроль доступа, необходимый для создания ресурса Foundry, который является родительским объектом проекта. Если у вас нет этого доступа, попросите администратора создать для вас ресурс Foundry. Затем перейдите к разделу "Создание нескольких проектов в одном ресурсе ", чтобы создать проект.

Вы должны быть владельцем подписки, чтобы иметь соответствующий контроль доступа, необходимый для создания ресурса Foundry, который является родительским объектом проекта. Если у вас нет доступа, попросите администратора создать для вас проект.

Учетная запись Azure с активной подпиской. Если у вас его нет, создайте бесплатную учетную запись Azure, которая включает бесплатную пробную подписку.
Вы должны быть владельцем подписки, чтобы получить соответствующий контроль доступа, необходимый для использования проекта.
Настройка среды разработки
Запустите az login или az login --use-device-code в среде перед выполнением кода.

Выполните следующие действия, чтобы запустить скрипт Python:
1. Установите пакеты: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. Если вы находитесь в ячейке записной книжки, используйте %pip install вместо этого.
2. Используйте pip show azure-mgmt-cognitiveservices, чтобы убедиться, что ваша версия 13.7 или выше.
3. Запустите скрипт со следующим кодом, чтобы создать 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"
)
```
4. (Необязательно) Если у вас несколько учетных записей, добавьте в DefaultAzureCredential идентификатор тенанта Microsoft Entra ID, который вы хотите использовать.
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```
5. (Необязательно) Если вы работаете в Azure Government - США или Azure, управляемом 21Vianet, укажите регион, в котором требуется пройти проверку подлинности. В этом примере выполняется проверка подлинности для Azure Government в регионе США.
```
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
```

Выполните следующие действия, чтобы запустить скрипт Python:
1. Установите пакеты: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. Если вы находитесь в ячейке записной книжки, используйте %pip install вместо этого.
2. Используйте pip show azure-mgmt-cognitiveservices, чтобы убедиться, что ваша версия 13.7 или выше.
3. Запустите скрипт со следующим кодом, чтобы создать 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"
)
```
4. (Необязательно) Если у вас несколько учетных записей, добавьте в DefaultAzureCredential идентификатор тенанта Microsoft Entra ID, который вы хотите использовать.
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```

Учетная запись Azure с активной подпиской. Если у вас его нет, создайте бесплатную учетную запись Azure, которая включает бесплатную пробную подписку.
Вы должны быть владельцем подписки, чтобы получить соответствующий контроль доступа, необходимый для использования проекта.
Установка 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": {}
    }
)

Выполните проверку подлинности в подписке 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 (новое).
Добавьте этот код в скрипт, чтобы создать проект на существующем ресурсе:
```
# 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_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)

Чтобы просмотреть параметры проекта, используйте 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
)

Удалите ресурс 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()

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

az cognitiveservices account project delete \
--name {foundry_resource_name} \
--project-name {my_project_name}

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

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

Last updated on 2025-11-19