Criar um projeto para Microsoft Foundry (clássico)

• Nenhum outro pré-requisito necessário ao usar o portal.

• Configure seu ambiente de desenvolvimento.

• Execute az login ou az login --use-device-code em seu ambiente antes de executar o código.

• Instalar pacotes: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Se você estiver em uma célula de notebook, use %pip install em vez disso.

• Use pip show azure-mgmt-cognitiveservices para verificar se sua versão é 13.7 ou superior.

• Validação rápida: antes de criar um projeto, verifique o SDK e a autenticação testando o cliente:

  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.")
  

• Inicie seu script com o código a seguir para criar a conexão e as client variáveis usadas ao longo deste artigo. Este exemplo cria o projeto no Leste dos EUA:

  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"
  )
  

• (Opcional) Se você tiver várias contas, adicione a ID do locatário do Microsoft Entra ID que deseja usar em DefaultAzureCredential:

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

• (Opcional) Se você estiver trabalhando no Azure Governamental – EUA ou Azure operado por regiões 21Vianet, especifique a região à qual deseja autenticar. Este exemplo é autenticado na região Azure Governamental - EUA:

  from azure.identity import AzureAuthorityHosts
  DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
  

• Instale o CLI do Azure.
• Defina o valor padrão para subscription.

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

Essas etapas fornecem uma maneira de criar um novo recurso de Azure com configurações padrão básicas.

Para criar um projeto do Foundry, siga estas etapas:

1. Entre no Microsoft Foundry. Certifique-se de que o alternador New Foundry está desativado. Essas etapas se referem ao Foundry (clássico).

   

2. O que você faz a seguir depende de onde você está:

   • Se você não estiver em um projeto ou ainda não tiver nenhum projeto: selecione Criar novo no canto superior direito para criar um novo projeto do Foundry

     

   • Se você estiver em um projeto: selecione a trilha do projeto e, em seguida, selecione Criar novo recurso.

     

3. Selecione o recurso Foundry e, em seguida, selecione Avançar.

4. Forneça um nome para seu projeto e selecione Criar. Ou consulte a próxima seção para obter opções avançadas.

Opções avançadas

1. Você cria um projeto do Foundry em um Foundry recurso. O portal cria automaticamente esse recurso quando você cria o projeto. Selecione um grupo de recursos existente para usar ou deixe o padrão para criar um novo grupo de recursos.

   Dica

   Especialmente para começar, crie um novo grupo de recursos para seu projeto. O grupo de recursos facilita o gerenciamento do projeto e de todos os seus recursos juntos.

2. Selecione um Local ou utilize o padrão. O local é a região onde os recursos do projeto estão hospedados.

3. Selecione Criar. Você verá o progresso da criação de recursos. O projeto é criado quando o processo é concluído.

Para criar um projeto do Foundry:

• Adicione o código a seguir para criar um projeto de Foundry usando as variáveis e a conexão client da seção de pré-requisitos.

  # 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": {}
      }
  )
  

  Referências: CognitiveServicesManagementClient.

1. Crie um grupo de recursos ou use um existente. Por exemplo, crie my-foundry-rg em eastus:

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

2. Crie o recurso Foundry. Por exemplo, crie my-foundry-resource no my-foundry-rg grupo de recursos:

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku s0 \
       --location eastus \
      --allow-project-management
   

   O --allow-project-management sinalizador habilita a criação de projetos dentro deste recurso.

3. Crie um subdomínio personalizado para o recurso. O nome de domínio personalizado deve ser globalmente exclusivo. Se my-foundry-resource for usado, tente um nome mais exclusivo.

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

4. Crie o projeto. Por exemplo, crie my-foundry-project no 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. Verifique se o projeto foi criado:

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

   A saída exibe as propriedades do projeto, incluindo sua ID de recurso.

Referência: az cognitiveservices account

Na página Inicial do projeto, você encontra informações sobre o projeto.

• Nome: o nome do projeto aparece no canto superior esquerdo.
• Assinatura: a assinatura que hospeda o recurso do projeto.
• Grupo de recursos: o grupo de recursos que hospeda o recurso que hospeda o projeto.

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

Referências: CognitiveServicesManagementClient.

Para exibir as configurações do projeto, use o az cognitiveservices account project show comando. Por exemplo:

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

1. Entre no Microsoft Foundry. Certifique-se de que o alternador New Foundry está desativado. Essas etapas referem-se ao Foundry (clássico).
2. Abra seu projeto.
3. Selecione o Centro de Gerenciamento.
4. Em Recurso, selecione Visão geral.
5. Selecione os projetos que você não deseja mais manter.
6. Selecione Excluir projeto.

Para excluir o recurso foundry e todos os seus projetos:

1. No Centro de Gerenciamento, selecione o nome do recurso na seção Visão geral para acessar o portal Azure.
2. No portal Azure, selecione Delete para excluir o recurso e todos os seus projetos associados.

Esse código usa as variáveis e a conexão client dos pré-requisitos. Para excluir um único projeto:

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Referências: CognitiveServicesManagementClient.

Exclua um recurso do Foundry e todos os seus projetos:

# 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()

Referências: CognitiveServicesManagementClient.

Execute o seguinte comando:

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

Referências: az cognitiveservices account project delete.