Создание проекта для Майкрософт Foundry

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

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

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

Предпосылки

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

• Если вы создаете проект для себя:

  • Доступ к роли, которая позволяет создавать ресурс Foundry, такой как Владелец ИИ учетной записи Azure или Владелец ИИ Azure в рамках подписки или группы ресурсов. Дополнительные сведения о разрешениях см. в разделе Role-based access control for Майкрософт Foundry.

• Если вы создаете проект для команды:

  • Доступ к роли, которая позволяет выполнять назначения ролей, как, например, Owner. Дополнительные сведения о разрешениях см. в разделе Role-based access control for Майкрософт Foundry.
  • Список адресов электронной почты пользователя или идентификаторы групп безопасности Microsoft Entra для участников группы, которым требуется доступ.

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

Портал Foundry

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

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. Войдите в Майкрософт Foundry. Убедитесь, что переключатель New Foundry включен. Эти действия относятся к Foundry (new).

   

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

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

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

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

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

   Подсказка

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

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

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

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. Выберите "Добавить проект".

  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 \
   --resource-group my-foundry-rg \
   --project-name {new_project_name} \
   --location eastus
  

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

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

Портал Foundry

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

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

Предоставление доступа участникам команды

Если вы создали проект для команды, назначьте роль пользователя ИИ Azure ИИ участникам группы, чтобы они могли использовать проект и его ресурсы. Эта роль предоставляет минимальные разрешения, необходимые для создания и тестирования приложений ИИ. Для назначения других ролей см. Управление доступом на основе ролей для Майкрософт Foundry.

Это важно

Чтобы завершить назначения ролей, вам потребуется роль, такая как владелец на проекте. Для получения дополнительной информации см. Контроль доступа на основе ролей для Майкрософт Foundry.

Портал Foundry

1. На портале Foundry выберите "Работа " в правой верхней части навигации.
2. Выберите "Администратор" в левой области.
3. Выберите название вашего проекта в таблице.
4. Выберите "Добавить пользователя" в правом верхнем углу.
5. Введите адрес электронной почты участника группы.
6. Нажмите кнопку "Добавить".

Повторите эти действия для каждого члена команды или группы безопасности.

Подсказка

Чтобы добавить нескольких пользователей одновременно, используйте группу безопасности Microsoft Entra вместо отдельных адресов электронной почты.

Python

Используйте портал Azure CLI или Foundry для управления назначениями ролей. Пакет SDK Python не поддерживает операции назначения ролей.

Azure CLI

1. Получите идентификатор ресурса проекта:

   PROJECT_ID=$(az cognitiveservices account project show \
     --name my-foundry-resource \
     --resource-group my-foundry-rg \
     --project-name my-foundry-project \
     --query id -o tsv)
   

2. Назначьте роль пользователя Azure AI участнику команды:

   az role assignment create \
       --role "Azure AI User" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

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

   az role assignment create \
       --role "Azure AI User" \
       --assignee-object-id "<security-group-object-id>" \
       --assignee-principal-type Group \
       --scope $PROJECT_ID
   

3. Проверьте назначение роли:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "Azure AI User" \
       --output table
   

Справочник: az role assignment

Проверка доступа членов команды

Попросите члена группы проверить доступ, выполнив вход в Майкрософт Foundry и выбрав проект из списка проектов.

Если член группы не может получить доступ к проекту, убедитесь, что назначение роли выполнено успешно. Убедитесь, что вы использовали правильный адрес электронной почты или идентификатор группы безопасности. Убедитесь, что учетная запись Azure участника команды находится в том же клиенте Microsoft Entra.

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

Портал Foundry

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

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.

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

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

• быстрый старт Майкрософт Foundry
• Что такое Foundry?
• Создайте ресурсы, используя шаблон Bicep