Criar um projeto para Microsoft Foundry

• 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 no DefaultAzureCredential:

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

• 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. Verifique se o interruptor da Nova Fundição está ativado. Essas etapas referem-se ao Foundry (versão nova).

   

2. O projeto no qual você está trabalhando aparece no canto superior esquerdo.

3. Para criar um novo projeto, selecione o nome do projeto e, em seguida, selecione Criar novo projeto.

4. Dê um nome ao projeto e selecione Criar projeto. 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
   

   Verifique se o grupo de recursos existe:

   az group show --name my-foundry-rg --query properties.provisioningState --output tsv
   

   A saída mostra Succeeded.

2. Crie o recurso Foundry com o gerenciamento de projetos habilitado. 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 \
       --custom-domain my-foundry-resource \
       --assign-identity \
       --allow-project-management true
   

   Use estes valores:

   Parâmetro	Purpose
   --assign-identity	Cria a identidade gerenciada que o gerenciamento de projetos requer. Sem ele, a criação do projeto falha com um erro de que uma identidade gerenciada deve ser habilitada no recurso.
   --allow-project-management	Habilita o gerenciamento de projetos. Você não pode alterar essa configuração depois de criar o recurso.
   --custom-domain	Deve ser globalmente exclusivo. Se my-foundry-resource for levado, o comando falhará com CustomDomainInUse. Escolha um nome diferente e execute o comando novamente.

3. Crie um 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
   

4. Verifique se o recurso está provisionado:

   az cognitiveservices account show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --query properties.provisioningState --output tsv
   

   O resultado deve mostrar Succeeded. Se a saída mostrar um estado diferente, verifique suas permissões, a disponibilidade da região e as cotas de recursos. Para obter mais ajuda, consulte Criar um recurso de vários serviços.

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 \
       --query properties.provisioningState --output tsv
   

   O resultado deve mostrar Succeeded. Se o comando falhar com uma mensagem informando que uma identidade gerenciada deve ser habilitada, confirme se você criou o recurso com --assign-identity.

Referência: az cognitiveservices account project

Na página Início do projeto, você verá o ponto de extremidade e a chave de API do projeto. Você não precisará da chave de API se usar Microsoft Entra ID autenticação.

# 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. No portal do Foundry, selecione Gerenciar na navegação superior direita.
2. Selecione Detalhes do projeto no painel esquerdo.
3. Selecione a guia Usuários.
4. Selecione Adicionar usuário no canto superior direito.
5. Insira o endereço de email do membro da equipe.
6. Selecione Adicionar.

Repita estas etapas para cada membro da equipe ou grupo de segurança.

Use o portal CLI do Azure ou Foundry para gerenciar atribuições de função. O SDK do Python não dá suporte a operações de atribuição de função.

1. Obtenha a ID do recurso do projeto:

   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. Atribua a função de Usuário do Foundry a um membro da equipe:

   Importante

   As funções RBAC do Foundry foram renomeadas recentemente. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager eram anteriormente chamados de Usuário do Azure AI, Proprietário do Azure AI, Proprietário da conta do Azure AI e Gerente de Projeto do Azure AI. Você ainda pode ver os nomes anteriores em alguns lugares enquanto essa mudança de nome está sendo implementada. Os IDs das funções e as permissões principais não são alterados com a mudança de nome.

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --assignee-principal-type User \
       --scope $PROJECT_ID
   

Para adicionar um grupo de segurança em vez de um usuário individual:

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

1. Verifique a atribuição de função:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

Referência: az role assignment

1. Entre no Microsoft Foundry. Verifique se o interruptor da Nova Fundição está ativado. Estas etapas se referem ao Foundry (novo).
2. Na navegação superior direita, selecione Gerenciar.
3. No painel esquerdo, selecione Detalhes do projeto.
4. No canto superior direito, selecione o ícone de lixeira para excluir o projeto.

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

Para verificar a exclusão, execute az cognitiveservices account project show com os mesmos nomes de projeto e recursos. O comando retorna um erro não encontrado no recurso.

Referências: az cognitiveservices account project delete.