Snabbstart: Konfigurera Microsoft Foundry-resurser

I den här snabbstarten skapar du ett Microsoft Foundry projekt och distribuerar en modell. Om du hanterar ett team ger du även åtkomst till gruppmedlemmar. När du har slutfört de här stegen kan du eller ditt team börja skapa AI-program med hjälp av den distribuerade modellen.

Tips

Den här snabbstarten visar hur du skapar resurser för att skapa en agent med en grundläggande konfiguration. Mer avancerade scenarier som använder dina egna resurser finns i Konfigurera din miljö för agentutveckling.

Förutsättningar

Välj önskad metod med hjälp av följande flikar:

  • Installera Azure CLI version 2.67.0 eller senare (kontrollera med az version).

  • Logga in på Azure:

    az login

Skapa ett projekt

Skapa ett Foundry-projekt för att organisera ditt arbete. Projektet innehåller modeller, agenter och andra resurser som ditt team använder.

  1. Skapa en resursgrupp eller använd en befintlig. Skapa till exempel my-foundry-rg i eastus:

    az group create --name my-foundry-rg --location eastus

  2. Skapa Foundry-resursen. Skapa till exempel my-foundry-resource i my-foundry-rg resursgruppen:

    az cognitiveservices account create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --kind AIServices \
    --sku s0 \
    --location eastus \
   --allow-project-management

    Flaggan --allow-project-management gör det möjligt att skapa projekt i den här resursen.

  3. Skapa en anpassad underdomän för resursen. Det anpassade domännamnet måste vara globalt unikt. Om my-foundry-resource tas kan du prova ett mer unikt namn.

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

  4. Skapa projektet. Skapa till exempel my-foundry-project i 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. Kontrollera att projektet har skapats:

    az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project

    Utdata visar projektegenskaperna, inklusive dess resurs-ID.

Referens: az cognitiveservices account

Distribuera en modell

Distribuera en modell som du kan använda. I det här exemplet används gpt-4.1-mini, men du kan välja valfri tillgänglig modell.

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

Kontrollera att distributionen har slutförts:

az cognitiveservices account deployment show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini

När distributionen är klar visar "provisioningState": "Succeeded" utdata.

Referens: az cognitiveservices account deployment

Hämta information om projektanslutningen

Du behöver din projektslutpunkt för att ansluta från din kod. Om du administrerar det här projektet åt andra skickar du den här slutpunkten tillsammans med distributionsnamnet.

  1. Logga in på Microsoft Foundry med ditt Azure konto.
  2. Välj ditt projekt.
  3. Leta reda på projektslutpunkten på välkomstskärmen i project.Skärmbild av välkomstskärmen Microsoft Foundry Models som visar slutpunkts-URL:en och kopieringsknappen.
  4. Kopiera slutpunktsvärdet. Du använder det här värdet i andra snabbstarter och självstudier.

För administratörer – bevilja åtkomst

Om du administrerar ett team tilldelar du rollen Azure AI-användare till gruppmedlemmar så att de kan använda projektet och distribuerade modeller. Den här rollen ger de minsta behörigheter som krävs för att skapa och testa AI-program. För andra roller som du kan behöva tilldela, se Rollbaserad åtkomstkontroll för Microsoft Foundry

  1. Hämta projektets resurs-ID:

    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. Tilldela rollen Azure AI User till en gruppmedlem:

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

    Så här lägger du till en säkerhetsgrupp i stället för en enskild användare:

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

  3. Kontrollera rolltilldelningen:

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

Referens: az role assignment

Verifiera åtkomst till gruppmedlem

Be en gruppmedlem att verifiera sin åtkomst genom att logga in på Microsoft Foundry och välja projektet i projektlistan.

Om gruppmedlemmen inte kan komma åt projektet kontrollerar du att rolltilldelningen har slutförts. Kontrollera att du har använt rätt e-postadress eller säkerhetsgrupps-ID. Kontrollera att gruppmedlemmens Azure konto finns i samma Microsoft Entra klientorganisation.

Bekräfta att den distribuerade modellen är tillgänglig genom att be teammedlemmen att välja Skapa i det övre högra navigeringsfönstret och sedan Modeller i den vänstra rutan.

Rensa resurser

När du inte längre vill ha det här projektet tar du bort resursgruppen för att ta bort alla resurser som är associerade med det.

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

Nästa steg

snabbstart för Microsoft Foundry

  • Last updated on