Dela via


Snabbstart: Konfigurera Microsoft Foundry-resurser

I den här snabbstarten skapar du en Microsoft Foundry project och distribuerar en modell. Om du leder ett team beviljar du även access 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/Råd

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 en Foundry-project för att organisera ditt arbete. Project 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
    

    Med flaggan --allow-project-management kan projekt skapas inom den här resursen.

  3. Skapa en anpassad underdomän för resursen. Namnet på custom domain 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 project har skapats:

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

    Utdata visar projektets egenskaper, inklusive dess resurs-ID.

Referens: az cognitiveservices account

Driftsätt 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 visas "provisioningState": "Succeeded" utdata.

Referens: az cognitiveservices account deployment

Hämta information om din project-anslutning

Du behöver din projektslutpunkt för att ansluta till kod. Om du administrerar det här projektet för andra, skickar du denna slutpunkt tillsammans med driftkonfigurationsnamnet.

  1. Logga in på Microsoft Foundry med ditt Azure konto.
  2. Välj din project.
  3. Hitta projektets slutpunkt på projektets välkomstskärm.Skärmbild av välkomstskärmen för 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 access

Om du administrerar ett team tilldelar du rollen Azure AI-användare till gruppmedlemmar så att de kan använda project och distribuerade modeller. Den här rollen ger de minsta behörigheter som krävs för att skapa och testa AI-program. 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 teammedlems tillgång

Be en gruppmedlem att verifiera sina access genom att logga in på Microsoft Foundry, välj project i listan project och bekräfta att den distribuerade modellen visas under Build>Models.

Om gruppmedlemmen inte kan få åtkomst till projektet, kontrollera 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.

Rensa resurser

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

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

Nästa steg