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

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

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

Предпосылки

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

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

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

  Портал Foundry

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

  Пакет SDK для Python

  • Настройка среды разработки

  • Запустите az login или az login --use-device-code в среде перед выполнением кода.

  • Quick validation: перед созданием project убедитесь, что пакет 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:

    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. (Необязательно) Если у вас несколько учетных записей, добавьте идентификатор клиента Microsoft Entra ID, который вы хотите использовать в DefaultAzureCredential.

       DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
       

  Azure CLI

  • Установите Azure CLI.

  • Задайте значения по умолчанию для subscription.

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

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

Портал Foundry

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

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

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

   

2. Проект, над которым вы работаете, отображается в верхнем левом углу.

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

4. Присвойте project имя и выберите Create project. Или см. следующий раздел для дополнительных параметров.

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

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

   Подсказка

   Особенно для начала работы создайте новую группу ресурсов для вашего проекта. Группа ресурсов упрощает управление проектом и всеми его ресурсами совместно.

2. Выберите расположение или используйте значение по умолчанию. Расположение — это регион, в котором размещаются ресурсы проекта.

3. Нажмите кнопку "Создать". Вы видите прогресс создания ресурсов. После завершения процесса создается проект.

Пакет SDK для Python

Чтобы создать 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.

Azure CLI

1. Создайте группу ресурсов или используйте существующую. Например, создайте my-foundry-rg в eastus:

   az group create --name my-foundry-rg --location eastus
   

2. Создайте ресурс 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 включает создание проекта в этом ресурсе.

3. Создайте настраиваемый поддомен для ресурса. Имя custom domain должно быть глобально уникальным. Если my-foundry-resource используется, попробуйте использовать более уникальное имя.

   az cognitiveservices account update \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --custom-domain my-foundry-resource
   

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

5. Убедитесь, что проект был создан.

   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 в качестве дочерних ресурсов Azure могут иметь назначенные ими элементы управления доступом, но разделяют общие настройки, такие как безопасность сети, развертывания и интеграция средств Azure из родительского ресурса.

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

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

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

  Портал Foundry

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

  Пакет SDK для Python

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

  Azure CLI

  Хотя этот код может добавить дополнительные проекты в ресурс, вы не сможете просматривать их на портале Foundry (new). На новом портале Foundry для ресурса доступен только проект по умолчанию. Чтобы добавить новый project в my-foundry-resource:

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

• Если удалить проект по умолчанию для ресурса Foundry, следующий созданный проект станет проектом по умолчанию.

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

Портал Foundry

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

Пакет SDK для Python

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

Azure CLI

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

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

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

Портал Foundry

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

Пакет SDK для Python

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

Azure CLI

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

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

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

Это важно

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

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

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