Quickstart: Configurar recursos do Microsoft Foundry

• Instale a CLI do Azure versão 2.80.0 ou posterior. Verifica a tua versão com az version, e executa az upgrade se precisares de uma mais recente.

  A versão 2.80.0 adicionou os az cognitiveservices account project comandos que estes passos utilizam. Numa versão anterior, os comandos falham com unrecognized arguments ou 'project' is misspelled or not recognized by the system.

• Iniciar sessão no Azure:

  az login
  

• Acesso ao portal Microsoft Foundry.

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

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

3. Cria um projeto. 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
   

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

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 a indicar que uma identidade gerida deve ser ativada, confirme que criou o recurso com --assign-identity.

Referência: az cognitiveservices account project

1. Iniciar sessão no Microsoft Foundry. Certifica-te de que a opção New Foundry está ativada. Estes passos referem-se à Foundry (nova).

   

2. Cria um projeto.

   • Se esta for a sua primeira utilização do Foundry, será solicitado a criar ou procurar um projeto para continuar. Selecione Criar um novo projeto no menu suspenso.
   • Se já tiver um projeto carregado, selecione o nome no canto superior esquerdo e depois selecione Criar novo projeto.

3. Insira um nome de projeto, como my-foundry-project.

4. Selecione Opções Avançadas para configurar o grupo de recursos e a localização:

   • Grupo de recursos: Crie um novo grupo de recursos ou selecione um já existente. Se criares um novo grupo de recursos, podes gerir o projeto e todos os seus recursos de forma mais fácil em conjunto.
   • Localização: Selecione a região mais próxima da sua equipa.

5. Selecione Criar projeto.

   Aguarde que o projeto seja criado. Quando a página de visão geral do projeto aparece, o seu projeto está pronto.

1. Liste os modelos disponíveis na sua região para confirmar o nome e a versão do modelo:

   az cognitiveservices model list \
       --location eastus \
       --query "[?model.name=='gpt-5-mini'].{version:model.version,skus:join(',',model.skus[].name)}" \
       --output table
   

2. Implementar o modelo:

   az cognitiveservices account deployment create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --model-name gpt-5-mini \
       --model-version "2025-08-07" \
       --model-format OpenAI \
       --sku-capacity 10 \
       --sku-name GlobalStandard
   

   Se o comando falhar com DeploymentModelNotSupported, o modelo, versão ou SKU não estão disponíveis na sua região. Use a saída do passo anterior para escolher uma combinação suportada.

3. Verifique se a implementação foi bem-sucedida:

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

   A saída mostra Succeeded quando a implementação está pronta.

Referência: implementação da conta az cognitiveservices

1. Selecione Descobrir no canto superior direito da navegação, depois Modelos no painel esquerdo.
2. Procura por gpt-5-mini.
3. Seleciona as definições de Deploy>Default para adicioná-las ao teu projeto.
4. Note o nome da implementação (por exemplo, gpt-5-mini). A tua equipa precisa deste nome para usar o modelo.

Obtenha o endpoint do projeto:

az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project \
    --query 'properties.endpoints."AI Foundry API"' --output tsv

A saída é o endpoint do teu projeto, na forma https://my-foundry-resource.services.ai.azure.com/api/projects/my-foundry-project. Utilize este valor noutros guias de início rápido e tutoriais.

1. Inicia sessão no Microsoft Foundry usando a tua conta Azure.
2. Selecione o seu projeto.
3. Encontre o endpoint do seu projeto no ecrã de boas-vindas do projeto.
4. Copie o valor do endpoint. Usas este valor em outros tutoriais e inícios rápidos.

1. Obtenha o 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 Foundry User a um membro da equipa:

   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.

   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 utilizador 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ções:

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

Referência: az role assignment

1. No portal da Foundry, selecione Gerir no canto superior direito da navegação.
2. Selecione Project details no painel esquerdo.
3. Selecione o separador Utilizadores.
4. Selecionar Adicionar utilizador no canto superior direito.
5. Introduza o endereço de email do membro da equipa.
6. Selecionar Adicionar.

Repita estes passos para cada membro da equipa ou grupo de segurança.

az group delete --name my-foundry-rg --yes --no-wait

A eliminação é executada em segundo plano. Para confirmar que o grupo de recursos desapareceu, execute:

az group exists --name my-foundry-rg

A saída mostra false quando a eliminação termina.

No portal Azure, encontre e selecione o seu grupo de recursos. Selecione Eliminar e confirme a eliminação do grupo de recursos e de todos os seus recursos associados.