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

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

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

• Запустите 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.
• Задайте значение по умолчанию для subscription.

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

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

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

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

   

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

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

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

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

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

   Совет

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

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

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

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

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. Создайте настраиваемый поддомен для ресурса. Имя личного домена должно быть глобально уникальным. Если 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
   

   В выходных данных отображаются свойства проекта, включая его идентификатор ресурса.

Справочник: az cognitiveservices account

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

# 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 project show команду. Например:

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

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

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

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

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

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

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

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

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

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