Criar um projeto para o Microsoft Foundry

Este artigo descreve como criar um projeto do Foundry no Microsoft Foundry. Os projetos permitem organizar seu trabalho, como agentes, avaliações e arquivos, à medida que você cria aplicativos com estado e explora novas ideias.

Se sua organização exigir configurações personalizadas do Azure, como nomes alternativos, controles de segurança ou marcas de custo, talvez seja necessário usar o portal do Azure ou opções de modelo para atender aos requisitos do Azure Policy da sua organização.

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Se você não tiver uma, crie uma conta gratuita do Azure, que inclui uma assinatura de avaliação gratuita.

• Acesso a uma função que permite criar um recurso do Foundry, como Proprietário da IA da Conta do Azure ou Proprietário da IA do Azure na assinatura ou no grupo de recursos. Para obter mais informações sobre permissões, consulte o controle de acesso baseado em função para o Microsoft Foundry.

• Use as seguintes guias para selecionar o método que você deseja usar para criar um projeto do Foundry:

  Portal do Foundry

  • Uma conta do Azure com uma assinatura ativa. Se você não tiver uma, crie uma conta gratuita do Azure, que inclui uma assinatura de avaliação gratuita.

  SDK do Python

  • Configurar seu ambiente de desenvolvimento

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

  • Validação rápida: antes de criar um projeto, verifique se o SDK e a autenticação estão funcionando 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.")
    

  • Conclua estas etapas para iniciar o script Python:

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

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

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

    4. (Opcional) Se você tiver várias contas, adicione a identidade do locatário do Microsoft Entra ID que deseja usar no DefaultAzureCredential.

       DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
       

  Azure CLI

  • Instale a CLI do Azure.

  • Definir valores padrão para subscription.

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

Criar um projeto do Foundry

Portal do Foundry

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

Para criar um projeto do Foundry, siga estas etapas:

1. Entre no Microsoft Foundry. Certifique-se de que a chave New Foundry está ativada. Estas etapas referem-se à Fábrica (novo).

   

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 use 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.

SDK do Python

Para criar um projeto do Foundry:

• Adicione o código abaixo para criar um projeto de Foundry usando as variáveis e a client conexão do 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.

Azure CLI

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 da Fábrica. 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

Criar vários projetos no mesmo recurso

Crie vários projetos do Foundry em um recurso existente Foundry para habilitar a colaboração em equipe e o acesso de recursos compartilhados, incluindo segurança, implantações e ferramentas conectadas. Essa configuração é ideal em assinaturas restritas do Azure em que os desenvolvedores precisam de capacidade de exploração de autoatendimento dentro da configuração de um ambiente pré-configurado.

Projetos do Fábrica como recursos filhos do Azure podem ter seus próprios controles de acesso, mas compartilham configurações comuns, como segurança de rede, implantações e integração de ferramentas do Azure com o recurso pai.

Embora nem todas as funcionalidades do Foundry ofereçam suporte à organização de trabalho em projetos ainda, o primeiro projeto "padrão" do recurso é mais poderoso. Você pode identificá-lo pela tag "default" em experiências de UX e pela propriedade de recurso "is_default" ao usar opções de código.

Característica	Projeto padrão	Outros projetos
Inferência de modelo	✅	✅
Parques Infantis	✅	✅
Agents	✅	✅
Avaliações	✅	✅
Rastreamento	✅	✅
Datasets	✅	✅
Indexes	✅	✅
SDK e API do Foundry	✅	✅
Compreensão de conteúdo	✅	✅
SDK e API do OpenAI	✅	Respostas, arquivos, conversas
Lote openai, ajuste fino, conclusões armazenadas	✅	-
Ajuste fino da linguagem	✅	✅
Ajuste de fala	✅	-
Conexões	✅	✅

• Para adicionar um projeto a um recurso do Foundry:

  Portal do Foundry

  O portal foundry (novo) exibe apenas o projeto padrão para cada recurso do Foundry. Você não pode criar vários projetos ou exibir nenhum dos projetos não padrão no portal do Foundry (novo).

  SDK do Python

  Embora esse código possa adicionar projetos adicionais a um recurso, você não poderá exibi-los no portal do Foundry (novo). Somente o projeto padrão para um recurso está disponível no portal do Foundry (novo).
  Adicione este código ao script para criar um novo projeto em seu recurso existente:

  # 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

  Embora esse código possa adicionar projetos adicionais a um recurso, você não poderá exibi-los no portal do Foundry (novo). Somente o projeto padrão para um recurso está disponível no portal do Foundry (novo). Para adicionar um novo projeto a my-foundry-resource:

   az cognitiveservices account project create \
   --name my-foundry-resource \
   --project-name {new_project_name} \
   --location eastus
  

• Se você excluir o projeto padrão do recurso foundry, o próximo projeto criado se tornará o projeto padrão.

Exibir as configurações do projeto

Portal do Foundry

Na página Home do projeto, você verá o endpoint do projeto e a chave de API para o projeto. Você não precisará da chave de API se usar a autenticação da ID do Microsoft Entra.

SDK do 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)

Referências: CognitiveServicesManagementClient.

Azure CLI

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

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

Excluir projetos

Portal do Foundry

1. Entre no Microsoft Foundry. Certifique-se de que a chave New Foundry está ativada. Esses passos referem-se ao Foundry (novo).
2. Na navegação superior direita, selecione Operar.
3. No painel esquerdo, selecione Administrador.
4. Selecione o projeto.
5. No canto superior direito, selecione o ícone de lixeira para excluir o projeto.

SDK do Python

Este código usa as variáveis do pré-requisitos e client connection. Primeiro, crie a conexão do cliente:

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.

Azure CLI

Execute o comando a seguir:

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

Referências: az cognitiveservices account project delete.

Importante

Use-o com cuidado. Você não pode recuperar um projeto depois que ele é excluído.

Conteúdo relacionado

• Início Rápido do Microsoft Foundry
• O que é a Foundry?