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

  • Ett Azure konto med en aktiv prenumeration. Om du inte har ett skapar du ett fritt Azure konto, som innehåller en kostnadsfri utvärderingsprenumeration.
  • Om du skapar projektet själv:
    • Åtkomst till en roll som gör att du kan skapa en Foundry-resurs, till exempel Foundry-kontoägare eller Foundry-ägare i prenumerationen eller resursgruppen. Mer information om behörigheter finns i Role-baserad åtkomstkontroll för Microsoft Foundry.

      Viktigt!

      Foundrys RBAC-roller har nyligen namnändrats. Foundry User, Foundry Owner, Foundry Account Owner och Foundry Project Manager hette tidigare Azure AI-användare, Azure AI-ägare, Azure AI-kontoägare och Azure AI Project Manager. Du kanske fortfarande ser de tidigare namnen på vissa platser medan namnbytet distribueras. Roll-ID:na och kärnbehörigheterna ändras inte av namnbytet.

  • Om du skapar projektet för ett team:
    • Åtkomst till en roll som gör att du kan slutföra rolltilldelningar, till exempel Ägare. Mer information om behörigheter finns i Role-baserad åtkomstkontroll för Microsoft Foundry.
    • En lista över användarens e-postadresser eller Microsoft Entra säkerhetsgrupp-ID:t för teammedlemmar som behöver åtkomst.

Om du använder Azure CLI i stället för portalen räcker rollen Deltagare eller Ägare i resursgruppen för att skapa resursen och projektet. Du behöver fortfarande en roll som kan tilldela roller, till exempel Ägare, för att ge åtkomst till gruppmedlemmar.

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

  • Installera Azure CLI version 2.80.0 eller senare. Kontrollera din version med az versionoch kör az upgrade om du behöver en nyare.

    Version 2.80.0 har lagt till de az cognitiveservices account project kommandon som de här stegen använder. I en tidigare version misslyckas kommandona med unrecognized arguments eller 'project' is misspelled or not recognized by the system.

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

Tips

Skapa projektet i regionen USA, västra 3 om du vill prova en omedelbar modell (förhandsversion).

Note

De här stegen kräver Azure CLI version 2.80.0 eller senare och rollen Deltagare eller Ägare i resursgruppen. Kör az version för att kontrollera din version och az upgrade om du behöver en nyare. Kör az login för att logga in innan du börjar. Information om regioner som stöds finns i Regionstöd.

  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

    Kontrollera att resursgruppen finns:

    az group show --name my-foundry-rg --query properties.provisioningState --output tsv

    Utdata visar Succeeded.

  2. Skapa Foundry-resursen med projekthantering aktiverat. 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 \
    --custom-domain my-foundry-resource \
    --assign-identity \
    --allow-project-management true

    Använd följande värden:

    Parameter Purpose
    --assign-identity Skapar den hanterade identitet som krävs för projekthantering. Utan den misslyckas projektskapandet med ett fel om att en hanterad identitet måste aktiveras på resursen.
    --allow-project-management Aktiverar projekthantering. Du kan inte ändra den här inställningen när du har skapat resursen.
    --custom-domain Måste vara globalt unikt. Om my-foundry-resource tas misslyckas kommandot med CustomDomainInUse. Välj ett annat namn och kör kommandot igen.

  3. Skapa ett projekt. 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

  4. Kontrollera att resursen har provisionerats:

    az cognitiveservices account show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --query properties.provisioningState --output tsv

    Utdata ska visa Succeeded. Om utdata visar ett annat tillstånd kontrollerar du dina behörigheter, regionens tillgänglighet och resurskvoter. Mer hjälp finns i Skapa en resurs med flera tjänster.

  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 \
    --query properties.provisioningState --output tsv

    Utdata ska visa Succeeded. Om kommandot misslyckas med ett meddelande om att en hanterad identitet måste vara aktiverad bekräftar du att du har skapat resursen med --assign-identity.

Referens: az cognitiveservices account project

Distribuera en modell

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

Tips

Om du vill prova en modell för omedelbar åtkomst (förhandsversion) kan du hoppa över det här steget.

  1. Visa en lista över tillgängliga modeller i din region så att du kan bekräfta modellnamnet och versionen:

    az cognitiveservices model list \
    --location eastus \
    --query "[?model.name=='gpt-5-mini'].{version:model.version,skus:join(',',model.skus[].name)}" \
    --output table

  2. Distribuera modellen:

    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

    Om kommandot misslyckas med DeploymentModelNotSupportedär modellen, versionen eller SKU:n inte tillgänglig i din region. Använd utdata från föregående steg för att välja en kombination som stöds.

  3. Kontrollera att distributionen har slutförts:

    az cognitiveservices account deployment show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-5-mini \
    --query properties.provisioningState --output tsv

    Utdata visar Succeeded när distributionen är klar.

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.

Hämta projektslutpunkten:

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

Utdata är projektets slutpunkt i formen https://my-foundry-resource.services.ai.azure.com/api/projects/my-foundry-project. Använd 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 Foundry-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. Andra roller som du kan behöva tilldela finns i Role-baserad å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 Foundry-användare till en gruppmedlem:

    Viktigt!

    Foundrys RBAC-roller har nyligen namnändrats. Foundry User, Foundry Owner, Foundry Account Owner och Foundry Project Manager hette tidigare Azure AI-användare, Azure AI-ägare, Azure AI-kontoägare och Azure AI Project Manager. Du kanske fortfarande ser de tidigare namnen på vissa platser medan namnbytet distribueras. Roll-ID:na och kärnbehörigheterna ändras inte av namnbytet.

    az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee "user@contoso.com" \
    --assignee-principal-type User \
    --scope $PROJECT_ID

Note

Eftersom Foundry RBAC-rollerna nyligen har bytt namn använder du rolldefinitions-ID (GUID) i stället för rollnamnet i koden för att undvika problem under distributionen av namnbytet:

  • Foundry-användare: 53ca6127-db72-4b80-b1b0-d745d6d5456d
  • Ägare till Foundry: c883944f-8b7b-4483-af10-35834be79c4a
  • Foundry-kontoägare: e47c6f54-e4a2-4754-9501-8e0985b135e1
  • Foundry Project Manager:eadc314b-1a2d-4efa-be10-5d325db5065e

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

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. Kontrollera rolltilldelningen:

    az role assignment list \
    --scope $PROJECT_ID \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --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

Borttagning körs i bakgrunden. Bekräfta att resursgruppen har tagits bort genom att köra:

az group exists --name my-foundry-rg

Resultatet visar false när borttagningen är slutförd.

Nästa steg

snabbstart för Microsoft Foundry

  • Last updated on