Compartilhar via

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

Neste início rápido, você cria um Microsoft Foundry project e implanta um modelo. Se você estiver gerenciando uma equipe, também concederá acesso aos membros da equipe. Depois de concluir essas etapas, você ou sua equipe podem começar a criar aplicativos de IA usando o modelo implantado.

Dica

Este início rápido mostra como criar recursos para criar um agente com uma configuração básica. Para cenários mais avançados que usam seus próprios recursos, consulte Configurar seu ambiente para desenvolvimento de agente.

Pré-requisitos

Selecione seu método preferencial usando as seguintes guias:

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

  • Entre no Azure:

    az login

Criar um project

Crie um projeto Foundry para organizar seu trabalho. O projeto inclui modelos, agentes e outros recursos que sua equipe usa.

  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

  2. Crie o recurso da Fábrica. 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

    O sinalizador --allow-project-management permite a criação de projetos dentro desse recurso.

  3. Crie um subdomínio personalizado para o recurso. O nome custom domain deve ser globalmente exclusivo. Se my-foundry-resource for usado, tente um nome mais exclusivo.

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

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

  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

    A saída exibe as propriedades do projeto, incluindo sua ID de recurso.

Referência: conta az cognitiveservices

Implantar um modelo

Implante um modelo que você pode usar. Este exemplo usa gpt-4.1-mini, mas você pode escolher qualquer modelo disponível.

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 implantaçã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 implantação estiver pronta, a saída mostrará "provisioningState": "Succeeded".

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

Obtenha os detalhes da conexão do projeto

Você precisa do endpoint do projeto para se conectar a partir do código. Se você estiver administrando este projeto para outras pessoas, envie este endpoint junto com o nome da implantação.

  1. Entre no Microsoft Foundry usando sua conta Azure.
  2. Selecione seu projeto.
  3. Encontre o ponto de extremidade do seu projeto na tela de boas-vindas do projeto.Screenshot da tela de boas-vindas dos Modelos de Descoberta da Microsoft mostrando a URL do ponto de extremidade e o botão de cópia.
  4. Copie o valor do ponto de extremidade. Você usa esse valor em outros guias de início rápido e tutoriais.

Para administradores - conceda acesso

Se você estiver administrando uma equipe, atribua a função Usuário de IA do Azure aos membros da equipe para que eles possam usar o projeto e os modelos implantados. Essa função fornece as permissões mínimas necessárias para criar e testar aplicativos de IA. Para outras funções que talvez seja necessário atribuir, consulte controle de acesso baseado em funções da Microsoft Foundry

  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 Azure AI User a um membro da equipe.

    az role assignment create \
    --role "Azure AI User" \
    --assignee "user@contoso.com" \
    --scope $PROJECT_ID

    Para adicionar um grupo de segurança em vez de um usuário individual:

    az role assignment create \
    --role "Azure AI User" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

  3. Verifique a atribuição de função:

    az role assignment list \
    --scope $PROJECT_ID \
    --role "Azure AI User" \
    --output table

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

Verificar o acesso dos membros da equipe

Peça a um membro da equipe para verificar seu acesso entrando no Microsoft Foundry, selecionando o projeto na lista de projetos e confirmando que o modelo implantado aparece em Construir>Modelos.

Se o membro da equipe não puder acessar o projeto, verifique se a atribuição de função foi concluída com êxito. Verifique se você usou o endereço de email correto ou a ID do grupo de segurança. Verifique se a conta de Azure do membro da equipe está no mesmo locatário do Microsoft Entra.

Limpar os recursos

Quando você não quiser mais esse project, exclua o grupo de recursos para excluir todos os recursos associados a ele.

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

Próxima etapa

Início rápido do Microsoft Foundry

  • Last updated on