Início Rápido: Configurar recursos do Microsoft Foundry

• Instale o CLI do Azure versão 2.80.0 ou posterior. Verifique sua versão com az versione execute az upgrade se precisar de uma mais recente.

  A versão 2.80.0 adicionou os az cognitiveservices account project comandos que essas etapas usam. Em uma versão anterior, os comandos falham com unrecognized arguments ou 'project' is misspelled or not recognized by the system.

• Entre no Azure:

  az login
  

• Acesso ao portal Microsoft Foundry.

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

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

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

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

5. Confirme que 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

1. Entre no Microsoft Foundry. Certifique-se de que a chave New Foundry está ativada. Estas etapas referem-se à Fábrica (novo).

   

2. Criar um projeto.

   • Se esse for o primeiro uso do Foundry, você será solicitado a criar ou pesquisar um projeto para continuar. Selecione Criar um novo projeto na lista suspensa.
   • Se você já tiver um projeto carregado, selecione seu nome no canto superior esquerdo e 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 o local:

   • Grupo de recursos: crie um novo grupo de recursos ou selecione um existente. Se você criar um novo grupo de recursos, poderá gerenciar mais facilmente o project e todos os seus recursos juntos.
   • Local: selecione a região mais próxima da sua equipe.

5. Selecione Criar project.

   Aguarde até que o projeto seja criado. Quando for exibida a página de visão geral do projeto, o projeto estará pronto.

1. Liste os modelos disponíveis em sua região para que você possa 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. Implante 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, a versão ou a SKU não estarão disponíveis em sua região. Use a saída da etapa anterior para escolher uma combinação com suporte.

3. Verifique se a implantaçã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 implantação está pronta.

Referência: az cognitiveservices account deployment

1. Selecione Descobrir na navegação superior direita e, em seguida, Modelos no painel esquerdo.
2. Pesquise por gpt-5-mini.
3. Selecione Deploy>Default settings para adicioná-lo ao project.
4. Observe o nome da implantação (por exemplo, gpt-5-mini). Sua equipe precisa desse nome para usar o modelo.

Obtenha o ponto de extremidade 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 projeto, no formato https://my-foundry-resource.services.ai.azure.com/api/projects/my-foundry-project. Use esse valor em outros guias de início rápido e tutoriais.

1. Entre no Microsoft Foundry usando sua conta Azure.
2. Selecione seu projeto.
3. Encontre o ponto de extremidade do projeto na tela de boas-vindas do projeto.
4. Copie o valor do ponto de extremidade. Você usa esse valor em outros guias de início rápido e tutoriais.

1. Obtenha o identificador 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 de Usuário do Foundry a um membro da equipe:

   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.

   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 usuário 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ção:

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

Referência: atribuições de função az

1. No portal do Foundry, selecione Gerenciar na navegação superior direita.
2. Selecione Detalhes do projeto no painel esquerdo.
3. Selecione a guia Usuários.
4. Selecione Adicionar usuário no canto superior direito.
5. Insira o endereço de email do membro da equipe.
6. Selecione Adicionar.

Repita estas etapas para cada membro da equipe ou grupo de segurança.

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

A exclusão é executada em segundo plano. Para confirmar que o grupo de recursos foi removido, execute:

az group exists --name my-foundry-rg

A saída mostra false quando a exclusão é concluída.

No Azure portal, localize e selecione seu grupo de recursos. Selecione Excluir e confirme para excluir o grupo de recursos e todos os seus recursos associados.