Use este artigo para criar um projeto Foundry e confirme que o seu ambiente está pronto antes de começar a construir agentes, avaliações e ficheiros.
Atualmente a ver:
versão do portal Foundry (clássica) - Trocar para a versão do novo portal Foundry
Este artigo descreve como criar um projeto Foundry em Microsoft Foundry. Os projetos permitem-lhe organizar o seu trabalho — como agentes, avaliações e ficheiros — enquanto constrói aplicações com estado e explora novas ideias.
-
Um projeto Foundry é gerido sob um recurso Microsoft Foundry. É um contentor para gestão de acessos, carregamento e integração de dados, e monitorização. Isto permite-lhe manter o seu trabalho separado entre casos de uso sem precisar de criar recursos extra no Azure.
Se precisares de acesso a modelos open-source ou ao PromptFlow, cria antes um tipo de projeto hub .
Para mais informações sobre os diferentes tipos de projetos, consulte Tipos de projetos.
Se a sua organização necessitar de configurações de Azure personalizadas, como nomes alternativos, controlos de segurança ou etiquetas de custo, poderá precisar de utilizar o portal Azure ou as opções template para cumprir os requisitos de Azure Policy da sua organização.
Pré-requisitos
-
Uma conta no Azure com uma subscrição ativa. Se não tiveres uma, cria uma conta Azure free, que inclui uma subscrição de teste gratuita.
-
Aceder a uma função que lhe permita criar um recurso Foundry, como Foundry Account Owner ou Foundry Owner na subscrição ou grupo de recursos. Para mais informações sobre permissões, consulte Controlo de acesso baseado em funções para Microsoft Foundry.
Importante
As funções RBAC do Foundry foram recentemente renomeadas.
Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager foram anteriormente nomeados Azure AI User, Azure AI Owner, Azure AI Account Owner e Azure AI Project Manager. Poderá ainda ver os nomes anteriores em alguns locais enquanto esta alteração de nome está a ser implementada. Os IDs das funções e as permissões principais não são alterados por esta mudança de nome.
Se não tiver esta função, peça ao seu administrador de subscrição que crie um recurso Foundry e depois salte para Criar múltiplos projetos no mesmo recurso.
Use os separadores seguintes para selecionar o método que pretende usar para criar um projeto Foundry:
- Não são necessários outros pré-requisitos ao usar o portal.
Configura o teu ambiente de desenvolvimento.
Antes de executar código, execute az login ou az login --use-device-code no seu ambiente.
Instalar pacotes: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Se estiver numa célula de notebook, use, em vez disso, o %pip install.
Usa pip show azure-mgmt-cognitiveservices para verificar se a tua versão é 13.7 ou superior.
Validação rápida: Antes de criar um projeto, verifique o seu SDK e 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.")
Comece o seu script com o seguinte código para criar a ligação e as client variáveis utilizadas 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 tiver várias contas, adicione o ID do inquilino da Microsoft Entra ID que quer usar em DefaultAzureCredential:
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
(Opcional) Se estiveres a trabalhar nas regiões Azure Government - EUA ou Azure operadas pela 21Vianet, especifica a região à qual queres autenticar-te. Este exemplo autentica para a região Azure Government - EUA:
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
- Instala o CLI do Azure.
- Defina o valor padrão para
subscription.
# Set your default subscription
az account set --subscription "{subscription-name}"
Criar um projeto Foundry
Utilize um dos seguintes métodos.
Estes passos fornecem uma forma de criar um novo recurso do Azure com as definições básicas predefinidas.
Para criar um projeto Foundry, siga estes passos:
-
Iniciar sessão no Microsoft Foundry. Certifica-te de que a opção do New Foundry está desligada. Estes passos referem-se à Foundry (clássica).
-
O que faz a seguir depende de onde está:
Se não estiveres num projeto, ou ainda não tiveres projetos: Seleciona Criar novo no canto superior direito para criar um novo projeto Foundry
Se estiveres num projeto: Seleciona a breadcrumb do projeto e depois seleciona Criar novo recurso.
Selecione o recurso Foundry e depois selecione Próximo.
Forneça um nome para o seu projeto e selecione Criar. Ou consulte a próxima secção para opções avançadas.
Opções avançadas
Você cria um projeto Foundry num recurso Foundry. O portal cria automaticamente este recurso quando 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 o seu projeto. O grupo de recursos facilita a gestão conjunta do projeto e de todos os seus recursos.
Selecione uma localização ou use o padrão. O local é a região onde os recursos do projeto são alojados.
Selecione Criar. Vê-se o progresso da criação de recursos. O projeto é criado quando o processo está concluído.
Para criar um projeto Foundry:
Adicione o seguinte código para criar um projeto Foundry usando as variáveis e a conexão client da secçã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
Estes passos requerem a versão 2.80.0 ou posterior da CLI do Azure e o papel de Contribuidor ou Proprietário no grupo de recursos. Corre az version para verificar a tua versão e az upgrade se precisas de uma mais recente. Executa az login para iniciares sessão antes de começares. Para regiões suportadas, veja Apoio regional.
Cria um grupo de recursos ou usa um já 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 a gestão de projetos ativada. 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:
| Parameter |
Purpose |
--assign-identity |
Cria a identidade gerida que a gestão de projetos exige. Sem ela, a criação do projeto falha devido a um erro que indica que uma identidade gerida deve ser ativada no recurso. |
--allow-project-management |
Permite o gerenciamento de projetos. Não podes mudar esta definição depois de criares o recurso. |
--custom-domain |
Deve ser globalmente único. Se my-foundry-resource for tomado, o comando falha com CustomDomainInUse. Escolha um nome diferente e execute o comando novamente. |
Cria um projecto. Por exemplo, crie my-foundry-project em :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 o resultado apresentar um estado diferente, verifique as suas permissões, a disponibilidade na sua região e as quotas de recursos. Para mais ajuda, consulte Criar um recurso multi-serviço.
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 a indicar que uma identidade gerida deve ser ativada, confirme que criou o recurso com --assign-identity.
Referência: az cognitiveservices account project
Crie múltiplos projetos no mesmo recurso
Crie múltiplos projetos Foundry num recurso existente Foundry para permitir colaboração em equipa e acesso partilhado de recursos, incluindo segurança, implementações e ferramentas conectadas. Esta configuração é ideal em subscrições Azure restritas, onde os programadores precisam de capacidade de exploração self-service dentro da configuração de um ambiente pré-configurado.
Os projetos Foundry enquanto recursos secundários do Azure podem receber os seus próprios controles de acesso, mas partilham definições comuns como segurança de rede, implementações e integração com ferramentas Azure do recurso principal.
Embora nem todas as capacidades do Foundry suportem ainda a organização do trabalho nos projetos, o primeiro projeto "padrão" do seu recurso é mais poderoso. Pode identificá-lo pela etiqueta "default" nas experiências de UX e pela propriedade de recurso "is_default" ao usar opções de código.
| Destaque |
Projeto padrão |
Outros projetos |
| Inferência de modelos |
✅ |
✅ |
| Parques infantis |
✅ |
✅ |
| Agentes |
✅ |
✅ |
| Avaliações |
✅ |
✅ |
| Rastreamento |
✅ |
✅ |
| Conjuntos de dados |
✅ |
✅ |
| Índices |
✅ |
✅ |
| SDK e API do Foundry |
✅ |
✅ |
| Compreensão do conteúdo |
✅ |
✅ |
| SDK e API OpenAI |
✅ |
Respostas, Ficheiros, Conversas |
| OpenAI Batch, Ajuste fino, Completações armazenadas |
✅ |
- |
| Ajuste fino da linguagem |
✅ |
✅ |
| Aperfeiçoamento da fala |
✅ |
- |
| Ligações |
✅ |
✅ |
Para adicionar um projeto a um recurso da Foundry:
Dica
Como podes personalizar o painel esquerdo no portal Microsoft Foundry, podes ver itens diferentes dos mostrados nestes passos. Se não vires o que procuras, seleciona ... Mais na parte inferior do painel esquerdo.
-
Iniciar sessão no Microsoft Foundry. Certifica-te de que a opção do New Foundry está desligada. Estes passos referem-se à Foundry (clássica).
Selecione o projeto Foundry ou o seu recurso associado.
No painel esquerdo, selecione Centro de gestão.
Na secção de recursos, selecione Visão Geral.
Selecione Novo projeto e forneça um nome.
Adicione este código ao seu script para criar um novo projeto no 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 eliminar o projeto padrão do seu recurso Foundry, o próximo projeto criado tornar-se-á o projeto padrão.
Ver definições do projeto
Na página do projeto inicial , encontra-se informações sobre o projeto.
-
Nome: O nome do projeto aparece no canto superior esquerdo.
-
Subscrição: A subscrição que aloja o recurso que aloja o projeto.
-
Grupo de recursos: O grupo de recursos que aloja o recurso que aloja 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 visualizar as definiçõ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
Apagar projetos
- Iniciar sessão no Microsoft Foundry. Certifica-te de que a opção do New Foundry está desligada. Estes são os passos que se referem à Foundry (clássica).
- Abre o teu projeto.
- Selecione o centro de gestão.
-
Em Recurso, selecione Visão Geral.
- Seleciona quaisquer projetos que já não queiras manter.
- Selecionar Eliminar projeto.
Para eliminar o recurso Foundry e todos os seus projetos:
- No centro de gestão, selecione o nome do recurso na secção Visão Geral para aceder ao portal Azure.
- No portal Azure, selecione Delete para eliminar o recurso e todos os seus projetos associados.
Este código utiliza as variáveis e a ligação client dos pré-requisitos. Para eliminar um único projeto:
client.projects.begin_delete(
resource_group_name, foundry_resource_name, foundry_project_name
)
Referências: CognitiveServicesManagementClient.
Eliminar um recurso da 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 ao comando: az cognitiveservices account project delete.
Importante
Use com cautela. Não consegues recuperar um projeto depois de ele ser apagado.
Conteúdo relacionado