Criar um projeto para o Microsoft Foundry

Observação

Este documento refere-se ao portal Microsoft Foundry (clássico).

Observação

Este documento refere-se ao portal Microsoft Foundry (novo ).

Este artigo descreve como criar um projeto Foundry no Microsoft Foundry. Os projetos permitem-lhe organizar o seu trabalho, como agentes, avaliações e ficheiros, enquanto cria aplicações com estado e explora novas ideias.

Um projeto Foundry é gerido através de um recurso Microsoft Foundry. É um contêiner para gerenciamento de acesso, upload e integração de dados e monitoramento. Isso permite que você mantenha seu trabalho separado entre casos de uso sem precisar criar recursos extras do Azure.
Este tipo de projeto dá-lhe acesso às mais recentes funcionalidades de IA generativa no Foundry, incluindo:
- Agentes
- SDK e API do Foundry para criar agentes e alternar facilmente entre modelos
- Modelos vendidos diretamente pelo Azure - Azure OpenAI, Mistral, xAI, DeepSeek, etc.
- Parceiros e Modelos de Comunidade vendidos através do Marketplace - Estabilidade, Cohere, etc.
- Compreensão de conteúdo
- Avaliações
- Ajuste fino
- SDK e API do OpenAI, incluindo finalizações em lote e armazenadas
- Serviços de IA
Você precisa de acesso a modelos de código aberto ou PromptFlow? Em vez disso, crie um tipo de projeto de hub.
Consulte Tipos de projetos para obter mais informações sobre os diferentes tipos de projetos.

Se a sua organização necessitar de configurações personalizadas do Azure, como nomes alternativos, controlos de segurança ou etiquetas de custo, poderá ter de utilizar o portal do Azure ou as opções de modelo para cumprir os requisitos da Política do Azure da sua organização.

Pré-requisitos

Use as guias a seguir para selecionar o método que você usará para criar um projeto 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.

Deve ser o Proprietário da subscrição para ter o controlo de acesso adequado necessário para criar o recurso Foundry que é o projeto principal. Se não tiveres este acesso, pede ao teu administrador para criar um recurso Foundry para usares. Em seguida, pule para Criar vários projetos no mesmo recurso para criar seu projeto.

Deve ser o Proprietário da subscrição para ter o controlo de acesso adequado necessário para criar o recurso Foundry que é o projeto principal. Se você não tiver esse acesso, peça ao administrador que crie um projeto para você.

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.
Você deve ser proprietário da assinatura para obter o controle de acesso apropriado necessário para usar o projeto.
Configure seu ambiente de desenvolvimento
Execute az login ou az login --use-device-code em seu ambiente antes de executar o código.

Conclua estas etapas para iniciar seu script Python:
1. Instalar pacotes: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. Se você estiver em uma célula de bloco de anotações, 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 o 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 tiveres várias contas, adiciona a identificação do locatário da Microsoft Entra ID que pretendes usar no DefaultAzureCredential.
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```
5. (Opcional) Se estiver a trabalhar nas regiões Azure Government - US ou Azure operado por 21Vianet , especifique a região na qual pretende autenticar. Este exemplo autentica na região Azure Government - EUA:
```
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
```

Conclua estas etapas para iniciar seu script Python:
1. Instalar pacotes: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. Se você estiver em uma célula de bloco de anotações, 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 o 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 tiveres várias contas, adiciona a identificação do locatário da Microsoft Entra ID que pretendes usar no DefaultAzureCredential.
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```

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.
Você deve ser o proprietário da assinatura para receber o controle de acesso apropriado necessário para usar o projeto.
Instalar a CLI do Azure

Defina valores predefinidos para subscription e resource group.

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

  # Set default resource group
  az config set defaults.group={resource-group-name}

Criar um projeto de fundição

Estas 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:

Inicie sessão no Microsoft Foundry. Certifica-te de que a opção do New Foundry está desligada. Estes passos referem-se à Foundry (clássica).

Inicie sessão no Microsoft Foundry. Certifica-te de que a opção New Foundry está ativada. Estes passos referem-se ao Foundry (novo).
O que você faz a seguir depende de onde você está:
- Se não tem projetos existentes: Siga os passos em Quickstart: Comece com o Microsoft Foundry para criar o seu primeiro projeto.
- Se você estiver em um projeto: selecione a trilha do projeto e, em seguida, selecione Criar novo recurso.
- Se não estiver num projeto: Selecione Criar novo no canto superior direito para criar um novo projeto Foundry
Selecione o recurso Foundry e depois selecione Próximo.
Forneça um nome para seu projeto e selecione Criar. Ou consulte a próxima seção para opções avançadas.

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

Para criar um projeto do Foundry, siga estas etapas:

Inicie sessão no Microsoft Foundry. Certifica-te de que a opção do New Foundry está desligada. Estes passos referem-se à Foundry (clássica).

Inicie sessão no Microsoft Foundry. Certifica-te de que a opção New Foundry está ativada. Estes passos referem-se ao Foundry (novo).
O projeto em que você está trabalhando aparece no canto superior esquerdo.
Para criar um novo projeto, selecione o nome do projeto e, em seguida, selecione Criar novo projeto.
Dê um nome ao seu projeto e selecione Criar projeto. Ou consulte a próxima seção para opções avançadas.

Opções avançadas

Um projeto do Foundry é criado em um recurso Foundry. Este recurso é criado para você automaticamente quando você cria o projeto. Selecione um grupo de recursos existente que você deseja usar ou deixe o padrão para criar um novo grupo de recursos.

Sugestão

Especialmente para começar, recomendamos que você crie um novo grupo de recursos para seu projeto. O grupo de recursos permite que você gerencie facilmente o projeto e todos os seus recursos juntos.
Selecione um local ou use o padrão. O local é a região onde os recursos do projeto estão hospedados.
Selecione Criar. Você vê o progresso da criação de recursos. O projeto é criado quando o processo é concluído.

Para criar um projeto Foundry:

Adicione este código para criar um projeto do Foundry usando as variáveis e a conexão fornecidas nos client.

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

Autentique para a sua subscrição Azure a partir do Azure CLI com o seguinte comando:
```
az login
```
Para obter mais informações sobre autenticação, consulte Métodos de autenticação.

Crie um grupo de recursos, por exemplo no Leste dos EUA:

az group create --name {my_resource_group} --___location eastus

Criar um recurso de Foundry

az cognitiveservices account create \
--name {your-foundry-resource-name} \
--kind AIServices \
--___location eastus \
--sku s0 \
--allow-project-management

Crie um projeto:

az cognitiveservices account project create \
--name {your-foundry-resource-name} \
--project-name {your-project-name} \
--___location eastus

Criar vários 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. Essa configuração é ideal em assinaturas restritas do Azure, onde os desenvolvedores precisam de capacidade de exploração de autoatendimento dentro da configuração de um ambiente pré-configurado.

O diagrama mostra como uma equipe pode compartilhar o acesso a recursos com vários projetos em um recurso do Foundry.

Projetos Foundry, tratados como recursos filhos no Azure, podem receber os seus próprios controlos de acesso, mas partilham definições comuns, como segurança de rede, implementações e integração com ferramentas do Azure, a partir do seu recurso principal.

Embora nem todos os recursos do Foundry ofereçam suporte à organização do trabalho em projetos, o primeiro projeto "padrão" do seu 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 modelos	✅	✅
Parques de Diversões	✅	✅
Agentes	✅	✅
Avaliações	✅	✅
Rastreio	✅	✅
Conjuntos de dados	✅	✅
Indexes	✅	✅
SDK e API do Foundry	✅	✅
Compreensão de conteúdo	✅	✅
OpenAI SDK e API	✅	Respostas, Ficheiros, Conversas
OpenAI Batch, ajuste fino, finalizações armazenadas	✅	-
Ajuste fino da linguagem	✅	✅
Ajustamento fino do discurso	✅	-
Conexões	✅	✅

Para adicionar um projeto a um recurso do Foundry:
Sugestão

Como pode personalizar o painel esquerdo no portal Microsoft Foundry, pode ver itens diferentes dos mostrados nestes passos. Se não encontrar o que procura, selecione ... Mais informações na parte inferior do painel esquerdo.
1. Inicie sessão no Microsoft Foundry. Certifica-te de que a opção do New Foundry está desligada. Estes passos referem-se à Foundry (clássica).
  
  Inicie sessão no Microsoft Foundry. Certifica-te de que a opção New Foundry está ativada. Estes passos referem-se ao Foundry (novo).
2. Selecione o projeto Foundry ou o seu recurso associado.
3. No painel esquerdo, selecione Centro de gerenciamento.
4. Na seção de recursos, selecione Visão geral.
5. Selecione Novo projeto e forneça um nome.
Adicionar um segundo projeto não é atualmente suportado no Foundry (novo).
Adicione este código ao script para criar um novo projeto no 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": {}
    }
)
```
Use os seus valores existentes para {foundry_resource_name} para adicionar outro projeto ao recurso:
```
 az cognitiveservices account project create \
 --name {foundry_resource_name} \
 --project-name {my_project_name} \
 --___location {___location}
```
Se você excluir o projeto padrão do recurso do Foundry, o próximo projeto criado se tornará o projeto padrão.

Ver 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 hub que hospeda o projeto.
Grupo de recursos: o grupo de recursos que hospeda o hub que hospeda o projeto.

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

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

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

az cognitiveservices account connection show \
--name <my_project_name> \
--resource-group <my_resource_group>

Excluir projetos

Inicie sessão no Microsoft Foundry. Certifica-te de que a opção do New Foundry está desligada. Estes passos referem-se à Foundry (clássico).

Inicie sessão no Microsoft Foundry. Certifica-te de que a opção New Foundry está ativada. Estes passos referem-se ao Foundry (novo).
Abra o seu projeto.
Selecione Centro de gerenciamento.
Em Recurso, selecione Visão geral.
Selecione os projetos que não deseja mais manter.
Selecione Excluir projeto.

Para eliminar o recurso Foundry e todos os seus projetos:

No Centro de gerenciamento, selecione o nome do recurso na seção Visão geral para ir para o portal do Azure.
No portal do Azure, selecione Excluir para excluir o recurso e todos os seus projetos associados.

Inicie sessão no Microsoft Foundry. Certifica-te de que a opção do New Foundry está desligada. Estes passos referem-se à Foundry (clássico).

Inicie sessão no Microsoft Foundry. Certifica-te de que a opção New Foundry está ativada. Estes passos referem-se ao Foundry (novo).
Na navegação no canto superior direito, selecione Operar.
No painel esquerdo, selecione Admin.
Selecione o seu projeto.
No canto superior direito, selecione o ícone da lixeira para excluir o projeto.

Este código utiliza as variáveis e client connection dos pré-requisitos. Primeiro, crie a ligação ao cliente:

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

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

Execute o seguinte comando:

az cognitiveservices account project delete \
--name {foundry_resource_name} \
--project-name {my_project_name}

Comentários

Esta página foi útil?

Last updated on 2025-11-22