Quickstart: Configurar recursos do Microsoft Foundry

• Instale a versão 2.67.0 ou posterior da CLI do Azure (verifique com az version).

• 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
   

2. Cria o recurso Foundry. 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
   

   A --allow-project-management bandeira permite a criação de projetos dentro deste recurso.

3. Cria um subdomínio personalizado para o recurso. O nome de domínio personalizado deve ser globalmente único. Se my-foundry-resource estiver ocupado, tente um nome mais único.

   az cognitiveservices account update \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --custom-domain my-foundry-resource
   

4. Cria o 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
   

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 mostra as propriedades do projeto, incluindo o seu ID de recurso.

Referência: az cognitiveservices account

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.

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini \
    --model-name gpt-4.1-mini \
    --model-version "2025-04-14" \
    --model-format OpenAI \
    --sku-capacity 10 \
    --sku-name Standard

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-4.1-mini

Quando a implementação está pronta, a saída mostra "provisioningState": "Succeeded".

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 gpt-4.1-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-4.1-mini). A tua equipa precisa deste nome para usar o modelo.

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" \
       --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 Fundição, selecione Operar no canto superior direito da navegação.
2. Selecione Admin no painel esquerdo.
3. Selecione o nome do seu projeto na tabela.
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

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.