Partilhar via

Quickstart: Configurar recursos do Microsoft Foundry

Neste quickstart, crias um Microsoft Foundry project e implementas um modelo. Se estiver a gerir uma equipa, também concede acesso aos membros da equipa. Depois de completar estes passos, você ou a sua equipa podem começar a construir aplicações de IA usando o modelo implementado.

Sugestão

Este quickstart mostra-te como criar recursos para construir um agente com uma configuração básica. Para cenários mais avançados que utilizam os teus próprios recursos, vê Configurar o teu ambiente para desenvolvimento de agentes.

Pré-requisitos

  • Uma conta no Azure com uma subscrição ativa. Se não tiveres uma, cria uma conta Azure free, que inclui uma subscrição de teste gratuita.
  • Se estás a criar um projeto para ti:
    • Acesso a um papel que permite criar um recurso Foundry, como Azure Account AI Owner ou Azure AI Owner na subscrição ou grupo de recursos. Para mais informações sobre permissões, consulte Role-based access control for Microsoft Foundry.
  • Se estás a criar o projeto para uma equipa:
    • Acesso a uma função que permite completar atribuições de funções, como Proprietário. Para mais informações sobre permissões, consulte Role-based access control for Microsoft Foundry.
    • Uma lista de endereços de email de utilizadores ou IDs de grupos de segurança Microsoft Entra para membros da equipa que necessitem de acesso.

Selecione o seu método preferido usando as seguintes abas:

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

  • Iniciar sessão no Azure:

    az login

Crie um project

Crie um projeto Foundry para organizar o seu trabalho. O projeto contém modelos, agentes e outros recursos que a equipa utiliza.

  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. Crie 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 flag --allow-project-management permite a criação de projetos dentro deste recurso.

  3. Cria um subdomínio personalizado para o recurso. O nome custom domain 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 projecto. 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. 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

Implementar um modelo

Implementa um modelo que possas usar. Este exemplo usa gpt-4.1-mini, mas 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 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: az cognitiveservices deployment de conta

Obtenha os detalhes de ligação do seu projeto

Precisas que o endpoint do teu projeto se conecte a partir do teu código. Se estiver a administrar este project para outros, envie-lhes este endpoint juntamente com o nome da implementação.

  1. Inicie sessão no Microsoft Foundry usando a sua conta Azure.
  2. Seleciona o teu projecto.
  3. Encontre o endpoint do seu projeto no ecrã de boas-vindas do projeto.Captura de ecrã do ecrã de boas-vindas do Microsoft Foundry Models mostrando o URL do endpoint e o botão de copiar.
  4. Copie o valor do endpoint. Usas este valor noutros tutoriais e iniciações rápidas.

Para administradores - conceder acesso

Se estiveres a administrar uma equipa, atribui o papel Azure AI User aos membros da equipa para que possam usar os modelos de projeto e implementados. Esta função fornece as permissões mínimas necessárias para construir e testar aplicações de IA. Para outras funções que possa precisar de atribuir, consulte controlo de acesso baseado em funções para Microsoft Foundry

  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. Atribuir o papel de Utilizador Azure IA a um membro da equipa:

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

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

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

Verificar o acesso dos membros da equipa

Peça a um membro da equipa para verificar o seu acesso iniciando sessão no Microsoft Foundry, selecionando o projeto da lista de projetos e confirmando que o modelo implementado aparece em Build>Models.

Se o membro da equipa não conseguir acess ao projeto, verifique se a atribuição de funções foi concluída com sucesso. Verifique se usou o endereço de email correto ou o ID do grupo de segurança. Certifique-se de que a conta Azure do membro da equipa está no mesmo tenant Microsoft Entra.

Limpeza de recursos

Quando já não quiser este project, elimine o grupo de recursos para eliminar todos os recursos associados a ele.

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

Próximo passo

Microsoft Foundry quickstart

  • Last updated on