Use este artigo para criar um projeto do Foundry e confirmar se seu ambiente está pronto antes de iniciar a criação de agentes, avaliações e arquivos.
Exibição no momento:
Versão do portal Foundry (clássico) - Alternar para a versão do novo portal Foundry
Este artigo descreve como criar um projeto do Foundry em 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.
-
Um projeto Foundry é gerenciado em um recurso Microsoft Foundry. É um contêiner para gerenciamento de acesso, carregamento e integração de dados e monitoramento. Isso permite que você mantenha seu trabalho separado entre casos de uso sem a necessidade de criar recursos adicionais de Azure.
Se você precisar de acesso a modelos de software livre ou PromptFlow, crie um tipo de projeto de hub .
Para obter mais informações sobre os diferentes tipos de projeto, consulte Tipos de projetos.
Se sua organização exigir configurações de Azure personalizadas, como nomes alternativos, controles de segurança ou marcas de custo, talvez seja necessário usar as opções Azure portal ou template para atender aos requisitos de Azure Policy da sua organização.
Pré-requisitos
-
Uma conta Azure com uma assinatura ativa. Se você não tiver uma, crie uma conta de Azure free, que inclui uma assinatura de avaliação gratuita.
-
Acesso a uma função que permita criar um recurso do Foundry, como Foundry Account Owner ou Foundry Owner, na assinatura ou no grupo de recursos. Para obter mais informações sobre permissões, consulte o controle de acesso baseado em Role para Microsoft Foundry.
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.
Se você não tiver essa função, solicite ao administrador da assinatura que crie um recurso do Foundry e, em seguida, pule para Criar vários projetos no mesmo recurso.
Use as seguintes guias para selecionar o método que você deseja usar para criar um projeto do 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>")
(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}"
Criar um projeto do Foundry
Use um dos métodos a seguir.
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:
-
Entre no Microsoft Foundry. Certifique-se de que o alternador New Foundry está desativado. Essas etapas se referem ao Foundry (clássico).
-
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.
Selecione o recurso Foundry e, em seguida, selecione Avançar.
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
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.
Selecione um Local ou utilize o padrão. O local é a região onde os recursos do projeto estão hospedados.
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.
Note
Essas etapas exigem o CLI do Azure versão 2.80.0 ou posterior e a função Colaborador ou Proprietário no grupo de recursos. Execute az version para verificar sua versão e az upgrade se você precisar de uma mais recente. Execute az login para entrar antes de começar. Para regiões com suporte, consulte o suporte à região.
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.
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. |
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
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.
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
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 Azure restritas em que os desenvolvedores precisam de capacidade de exploração de autoatendimento dentro da configuração de um ambiente pré-configurado.
Projetos do Foundry 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 com ferramentas do Azure do 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 utilizar opções de código.
| Funcionalidade |
Projeto padrão |
Outros projetos |
| Inferência de modelo |
✅ |
✅ |
| Áreas de lazer |
✅ |
✅ |
| Agentes |
✅ |
✅ |
| Avaliações |
✅ |
✅ |
| Rastreamento |
✅ |
✅ |
| Conjuntos de Dados |
✅ |
✅ |
| Índices |
✅ |
✅ |
| Foundry SDK e API |
✅ |
✅ |
| Compreensão de conteúdo |
✅ |
✅ |
| SDK e API do OpenAI |
✅ |
Respostas, arquivos, conversas |
| Lote do OpenAI, Ajuste Fino, Conclusões Armazenadas |
✅ |
- |
| Ajuste fino da linguagem |
✅ |
✅ |
| Ajuste de fala |
✅ |
- |
| Conexões |
✅ |
✅ |
Para adicionar um projeto a um recurso do Foundry:
Dica
Como você pode customize o painel esquerdo no portal do Microsoft Foundry, você pode ver itens diferentes dos mostrados nestas etapas. Se você não vir o que está procurando, selecione ... Mais na parte inferior do painel esquerdo.
-
Entre no Microsoft Foundry. Certifique-se de que o alternador New Foundry está desativado. Essas etapas se referem ao Foundry (clássico).
Selecione o projeto Foundry ou seu recurso associado.
No painel esquerdo, selecione Centro de Gerenciamento.
Na seção de recursos, selecione Visão geral.
Selecione Novo projeto e forneça um nome.
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": {}
}
)
Para adicionar um novo projeto a my-foundry-resource:
az cognitiveservices account project create \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--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 configurações do projeto
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
Excluir projetos
- Entre no Microsoft Foundry. Certifique-se de que o alternador New Foundry está desativado. Essas etapas referem-se ao Foundry (clássico).
- Abra seu projeto.
- Selecione o Centro de Gerenciamento.
- Em Recurso, selecione Visão geral.
- Selecione os projetos que você não deseja mais manter.
- Selecione Excluir projeto.
Para excluir o recurso foundry e todos os seus projetos:
- No Centro de Gerenciamento, selecione o nome do recurso na seção Visão geral para acessar o portal Azure.
- 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
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.
Importante
Use com cuidado. Você não pode recuperar um projeto depois que ele é excluído.
Conteúdo relacionado