Dela via

Snabbstart: Konfigurera din första AI Foundry-resurs

I den här snabbstarten skapar du en Azure AI Foundry-resurs och verifierar åtkomsten.

Lär dig hur du skapar och hanterar en Azure AI Foundry-resurs. Det är den primära Azure-resurstypen för att skapa, distribuera och hantera generativa AI-modeller och program, inklusive agenter i Azure.

En Azure-resurs krävs för att använda och hantera tjänster i Azure. Den definierar omfånget för att konfigurera åtkomst, säkerhet som nätverk, fakturering och övervakning.

Azure AI Foundry-resursen är nästa version och byter namn på tidigare "Azure AI Services". Den tillhandahåller programmiljön för att vara värd för dina agenter, modelldistributioner, utvärderingar med mera.

En Azure AI Foundry-resurs kan organisera arbetet för flera användningsfall och delas vanligtvis mellan ett team med utvecklare som arbetar med användningsfall i en liknande affärs- eller datadomän. Projekt fungerar som mappar för grupprelaterat arbete.

Diagram som visar Azure AI Foundry-resurs som innehåller flera projekt, var och en med distributioner och anslutningar.

Vill du konfigurera AI Foundry med avancerade säkerhetsinställningar? Se avancerade alternativ för att skapa AI Foundry

Vill du använda Azure AI Search-färdigheter? Läs mer i Använd Azure AI Foundry med Azure AI Search-funktioner.

Skapa din första resurs

Om du vill skapa din första resurs med grundläggande Azure-inställningar följer du stegen nedan med antingen Azure-portalen, Azure CLI eller PowerShell.

Förutsättningar

  • En giltig Azure-prenumeration – Skapa en kostnadsfritt.
  • Azure RBAC-roll för att skapa resurser. Du behöver någon av följande roller som tilldelats din Azure-prenumeration eller resursgrupp:
    • Bidragsgivare
    • Ägare
    • Anpassad roll med Microsoft.CognitiveServices/accounts/write behörighet

Skapa en ny Azure AI Foundry-resurs

Om din organisation behöver anpassade Azure-konfigurationer som alternativa namn, säkerhetskontroller eller kostnadstaggar kan du behöva använda Azure-portalen eller mallalternativ för att uppfylla organisationens Azure Policy-efterlevnad.

Azure AI Foundry-resursen visas under AI Foundry>AI Foundry i Azure-portalen. API-typen är AIServices. Leta efter logotypen som visas här:

Skärmbild av Azure AI Foundry-resursen i Azure-portalen.

Tips

Azure AI Foundry-portalen är ett sätt att skapa en ny Azure AI Foundry-resurs med grundläggande, standardinställningar.

Så här skapar du en AI Foundry-resurs i Azure-portalen:

  1. Välj den här resurslänken för AI Foundry : https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

  2. På sidan Skapa anger du följande information:

    Projektinformation beskrivning
    Abonnemang Välj en av dina tillgängliga Azure-prenumerationer.
    Resursgrupp Den Azure-resursgrupp som ska innehålla din Azure AI Foundry-resurs. Du kan skapa en ny grupp eller lägga till den i en befintlig grupp.
    Region Platsen för din Azure AI-tjänstinstans. Olika platser kan introducera fördröjning, men påverkar inte resursens tillgänglighet under körning.
    Namn Ett beskrivande namn för din Azure AI Foundry-resurs. Till exempel MyAIServicesResource.

  3. Konfigurera andra inställningar för resursen efter behov, läs och godkänn villkoren (i förekommande fall) och välj sedan Granska + skapa.

Tips

Om din prenumeration inte tillåter att du skapar en AI Foundry-resurs kan du behöva aktivera behörigheten för den Azure-resursprovidern med hjälp av Azure-portalen, PowerShell-kommandot eller ett Azure CLI-kommando. Om du inte är prenumerationsägare ber du någon med rollen ägare eller administratör att slutföra registreringen åt dig eller be om att behörigheten /register/action beviljas ditt konto.

Rensa resurser

Om du vill rensa och ta bort en AI Foundry-resurs kan du ta bort resursen eller resursgruppen. Om du tar bort resursgruppen tas även andra resurser i gruppen bort.

  1. I Azure-portalen expanderar du menyn på vänster sida för att öppna tjänstemenyn och väljer Resursgrupper för att visa listan över dina resursgrupper.
  2. Leta upp resursgruppen som innehåller den resurs som ska tas bort.
  3. Om du vill ta bort hela resursgruppen väljer du resursgruppens namn. På nästa sida väljer du Ta bort resursgrupp och bekräftar.
  4. Om du bara vill ta bort Azure AI Foundry-resursen väljer du resursgruppen för att se alla resurser i den. På nästa sida väljer du den resurs som du vill ta bort, väljer ellipsmenyn för raden och väljer Ta bort.

Använd den här snabbstarten för att skapa en AI Foundry-resurs med hjälp av CLI-kommandon (Azure Command-Line Interface).

Förutsättningar

  • En giltig Azure-prenumeration – Skapa en kostnadsfritt.
  • Azure CLI version 2.0 eller senare.
  • Azure RBAC-roll för att skapa resurser. Du behöver någon av följande roller som tilldelats din Azure-prenumeration eller resursgrupp:
    • Bidragsgivare
    • Ägare
    • Anpassad roll med Microsoft.CognitiveServices/accounts/write behörighet

Installera Azure CLI och logga in

Installera Azure CLI. För att logga in på din lokala installation av CLI, kör kommandot az login.

az login

Skapa en ny resursgrupp

Innan du skapar en AI Foundry-resurs måste du ha en Azure-resursgrupp som ska innehålla resursen. När du skapar en ny resurs kan du antingen skapa en ny resursgrupp eller använda en befintlig. Den här artikeln visar hur du skapar en ny resursgrupp.

Om du vill skapa en resurs behöver du en av de Azure-platser som är tillgängliga för din prenumeration. Du kan hämta en lista över tillgängliga platser med kommandot az account list-locations . De flesta Azure AI-tjänster kan nås från flera platser. Välj den som är närmast dig eller se vilka platser som är tillgängliga för tjänsten.

Viktigt!

  • Kom ihåg din Azure-plats, eftersom du behöver den när du anropar Azure AI Foundry-resurserna.
  • Tillgängligheten för vissa Azure AI-tjänster kan variera beroende på region. Mer information finns i Azure-produkter efter region.
az account list-locations --query "[].{Region:name}" --out table

När du har din Azure-plats skapar du en ny resursgrupp i Azure CLI med kommandot az group create . I exemplet nedan ersätter du Azure-platsen westus2 med en av de Azure-platser som är tillgängliga för din prenumeration.

az group create --name ai-services-resource-group --location westus2

Skapa en AI Foundry-resurs

Om du vill skapa och prenumerera på en ny Azure AI Foundry-resurs använder du kommandot az cognitiveservices account create . Det här kommandot lägger till en ny fakturerbar resurs i resursgruppen som du skapade tidigare. När du skapar den nya resursen måste du känna till vilken typ av tjänst du vill använda, tillsammans med prisnivån (eller SKU:n) och en Azure-plats.

Viktigt!

Azure tillhandahåller fler än en resurstyper för Azure AI-tjänster. Se till att skapa en med kind av AIServices.

Du kan skapa en AI Foundry-resurs med namnet foundry-multi-service-resource med kommandot nedan.

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --location westus2 --yes

Tips

Om din prenumeration inte tillåter att du skapar en AI Foundry-resurs kan du behöva aktivera behörigheten för den Azure-resursprovidern med hjälp av Azure-portalen, PowerShell-kommandot eller ett Azure CLI-kommando. Om du inte är prenumerationsägare ber du någon med rollen ägare eller administratör att slutföra registreringen åt dig eller be om att behörigheten /register/action beviljas ditt konto.

Hämta aktuell kvotanvändning för din resurs

Använd kommandot az cognitiveservices account list-usage för att hämta användningen för din resurs.

az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

Rensa resurser

Om du vill rensa och ta bort en AI Foundry-resurs kan du ta bort den eller resursgruppen. Om du tar bort resursgruppen tas även andra resurser i gruppen bort.

Om du vill ta bort resursgruppen och dess associerade resurser använder du az group delete command.

az group delete --name ai-services-resource-group

Använd den här snabbstarten för att skapa en AI Foundry-resurs med hjälp av Azure PowerShell-kommandon .

Förutsättningar

  • En giltig Azure-prenumeration – Skapa en kostnadsfritt.
  • Azure PowerShell version 5.0 eller senare.
  • Azure RBAC-roll för att skapa resurser. Du behöver någon av följande roller som tilldelats din Azure-prenumeration eller resursgrupp:
    • Bidragsgivare
    • Ägare
    • Anpassad roll med Microsoft.CognitiveServices/accounts/write behörighet

Installera Azure PowerShell och logga in

Installera Azure PowerShell. Logga in genom att köra kommandot Connect-AzAccount :

Connect-AzAccount

Skapa en ny Azure AI Foundry-resursgrupp

Innan du skapar en AI Foundry-resurs måste du ha en Azure-resursgrupp som ska innehålla resursen. När du skapar en ny resurs kan du antingen skapa en ny resursgrupp eller använda en befintlig. Den här artikeln visar hur du skapar en ny resursgrupp.

Om du vill skapa en resurs behöver du en av de Azure-platser som är tillgängliga för din prenumeration. Du kan hämta en lista över tillgängliga platser med kommandot Get-AzLocation . De flesta Azure AI-tjänster kan nås från flera platser. Välj den som är närmast dig eller se vilka platser som är tillgängliga för tjänsten.

Viktigt!

  • Kom ihåg din Azure-plats, eftersom du behöver den när du anropar Azure AI Foundry-resurserna.
  • Tillgängligheten för vissa Azure AI-tjänster kan variera beroende på region. Mer information finns i Azure-produkter efter region.
Get-AzLocation | Select-Object -Property Location, DisplayName

När du har din Azure-plats skapar du en ny resursgrupp i Azure PowerShell med kommandot New-AzResourceGroup . I exemplet nedan ersätter du Azure-platsen westus2 med en av de Azure-platser som är tillgängliga för din prenumeration.

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

Skapa en AI Foundry-resurs

Om du vill skapa och prenumerera på en ny Azure AI Foundry-resurs använder du kommandot New-AzCognitiveServicesAccount . Det här kommandot lägger till en ny fakturerbar resurs i resursgruppen som du skapade tidigare. När du skapar den nya resursen måste du känna till den "typ" av tjänst som du vill använda, tillsammans med prisnivån (eller SKU:n) och en Azure-plats:

Viktigt!

Azure tillhandahåller fler än en resurstyper för Azure AI-tjänster. Se till att skapa en med Type (typ) av AIServices.

Du kan skapa en AI Foundry-resurs med namnet foundry-multi-service-resource med kommandot nedan.

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

Tips

Om din prenumeration inte tillåter att du skapar en AI Foundry-resurs kan du behöva aktivera behörigheten för den Azure-resursprovidern med hjälp av Azure-portalen, PowerShell-kommandot eller ett Azure CLI-kommando. Om du inte är prenumerationsägare ber du någon med rollen ägare eller administratör att slutföra registreringen åt dig eller be om att behörigheten /register/action beviljas ditt konto.

Hämta aktuell kvotanvändning för din resurs

Använd kommandot Get-AzCognitiveServicesAccountUsage för att hämta användningen för din resurs.

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource

Rensa resurser

Om du vill rensa och ta bort en AI Foundry-resurs kan du ta bort den eller resursgruppen. Om du tar bort resursgruppen tas även andra resurser i gruppen bort.

Om du vill ta bort resursgruppen och dess associerade resurser använder du kommandot Remove-AzResourceGroup .

Remove-AzResourceGroup -Name ai-services-resource-group

Få åtkomst till din resurs

När du har skapat din första resurs kan du komma åt den via Foundry Portal för UX-prototyper, Foundry SDK för utveckling eller via Azure-portalen för administrativ hantering.

Kontrollera konfigurationen

Du kan kontrollera att resursen har konfigurerats korrekt med hjälp av Azure AI Projects SDK för att ansluta och lista projekt. Det här minimala exemplet bekräftar autentisering och åtkomst.

# Install the SDK: pip install azure-ai-projects azure-identity
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Replace with your actual values from Azure portal
client = AIProjectClient(
    subscription_id="<your-subscription-id>",
    resource_group_name="<your-resource-group>",
    project_name="<your-project-name>",
    credential=DefaultAzureCredential()
)

# List projects to verify connection
projects = client.projects.list()
print(f"Successfully connected. Found {len(list(projects))} projects.")

Förväntade utdata: Successfully connected. Found X projects. där X är antalet projekt i resursen.

Referenser:

Bevilja eller hämta utvecklarbehörigheter

Rollbaserad åtkomstkontroll i Azure (RBAC) skiljer behörigheter mellan hanterings- och utvecklingsåtgärder. Om du vill skapa med Foundry måste ditt användarkonto tilldelas utvecklarbehörigheter ("dataåtgärder"). Du kan antingen använda en av de inbyggda RBAC-rollerna eller använda en anpassad RBAC-roll.

Inbyggda Azure RBAC-utvecklarroller för Foundry är:

Role beskrivning
Azure AI-projektledare Beviljar utvecklingsbehörigheter och projekthanteringsbehörigheter. Kan bjuda in andra användare att samarbeta i ett projekt som "Azure AI-användare".
Azure AI-användare Beviljar utvecklingsbehörigheter.

Endast behöriga användare, vanligtvis Azure-prenumerationen eller resursgruppens ägare, kan tilldela en roll via antingen [Azure-portalen] eller [AI Foundry Portal via hanteringscenter]. Läs mer om rollbaserad åtkomstkontroll.

Viktigt!

Azures ägar- och deltagarroller omfattar endast hanteringsbehörigheter och inte utvecklingsbehörigheter. Utvecklingsbehörigheter krävs för att skapa med alla funktioner i Foundry.

Börja skapa i ditt första projekt

Med konfigurerade behörigheter är du nu redo att börja skapa Foundry. Öppna eller skapa ditt första projekt i Azure AI Foundry Portal. Projekt organiserar ditt agent- och modellanpassningsarbete i Foundry, och du kan skapa flera under samma resurs.

Utforska några av de tjänster som ingår i din resurs:

Tjänst beskrivning
Azure AI Foundry-ikonen Azure AI Foundry Agent Service Kombinera kraften i generativa AI-modeller med verktyg som gör det möjligt för agenter att komma åt och interagera med verkliga datakällor.
Azure AI Foundry-ikon Modellinferens för Azure AI Utför modellinferens för flaggskeppsmodeller i Azure AI Foundry-modellkatalogen.
Azure OpenAI i ikonen för Azure AI Foundry Models Azure OpenAI Utför en mängd olika uppgifter för naturligt språk.
Ikonen Innehållssäkerhet Innehållssäkerhet En AI-tjänst som identifierar oönskat innehåll.
Ikon för dokumentinformation Dokumentinformation Omvandla dokument till intelligenta datadrivna lösningar.
Språkikon Språk Skapa appar med branschledande funktioner för förståelse av naturligt språk.
Ikon för tal Tal Tal till text, text till tal, översättning och talarigenkänning.
Translator-ikon Översättare Använd AI-baserad översättningsteknik för att översätta mer än 100 använda, riskfyllda och utrotningshotade språk och dialekter.

Nästa steg