Создайте проект для 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:

Портал Foundry

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

Пакет SDK для Python

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

• Запустите 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

• Установите 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

  1. Выберите «Управлять» в правом верхнем углу навигации.
  2. Выберите "Администратор" в левой области.
  3. Выберите родительский ресурс, к которому нужно добавить проект.
  4. Выберите "Добавить проект".

  Пакет SDK для Python

  Добавьте этот код в свой скрипт, чтобы создать новый проект на существующем ресурсе.

  # 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

  Чтобы добавить новый 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 project show. Рассмотрим пример.

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

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

Портал Foundry

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

Пакет SDK для Python

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

Azure CLI

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

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.

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

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

• Краткое руководство по Microsoft Foundry
• Что такое Foundry?
• Создание ресурсов с помощью шаблона Bicep