Dela via

Snabbstart: Konfigurera din första Foundry-resurs

I den här snabbstarten skapar du en Microsoft Foundry-resurs och kontrollerar access.

Lär dig hur du skapar och hanterar en Foundry-resurs. Det är primary Azure resurstyp 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 access, säkerhet som nätverk, fakturering och övervakning.

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

En 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 Foundry-resurs som innehåller flera projekt, var och en med distributioner och anslutningar.

Vill du konfigurera Foundry med avancerade säkerhetsinställningar? Se avancerade alternativ för skapande av gjuteri

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 portal, Azure CLI eller PowerShell.

Förutsättningar

  • En giltig Azure prenumeration – Skapa en kostnadsfri.
  • 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 Microsoft Foundry-resurs

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

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

Skärmbild av Foundry-resursen i Azure portal.

Tips

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

Om du vill skapa en Foundry-resurs i Azure portal följer du dessa instruktioner:

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

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

    Projektuppgifter beskrivning
    Abonnemang Välj en av dina tillgängliga Azure prenumerationer.
    Resursgrupp Den Azure resursgrupp som ska innehålla din Foundry-resurs. Du kan skapa en ny grupp eller lägga till den i en befintlig grupp.
    Region Platsen för din Foundry Tool-instans. Olika platser kan introducera fördröjning, men påverkar inte resursens tillgänglighet under körning.
    Namn Ett beskrivande namn för din 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 Foundry-resurs kan du du kan behöva aktivera behörigheten för den Azure resursprovidern med hjälp av kommandot Azure portal, PowerShell 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 Foundry-resurs kan du ta bort resursen eller resursgruppen. Om du tar bort resursgruppen tas även andra resurser i gruppen bort.

  1. I Azure portal expanderar du menyn till vänster för att öppna menyn med tjänster och väljer Resource-grupper 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 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 Foundry-resurs med hjälp av kommandona Azure Command-Line Interface (CLI).

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. Logga in på din lokala installation av CLI genom att köra kommandot az login:

az login

Skapa en ny resursgrupp

Innan du skapar en 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 någon 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 Foundry Tools 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 Microsoft Foundry-resurserna.
  • Tillgängligheten för vissa Foundry-verktyg 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 Azure plats skapar du en ny resursgrupp i Azure CLI med kommandot az group create. I exemplet nedan ersätter du Azure plats westus2 med någon av de Azure platser som är tillgängliga för din prenumeration.

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

Skapa en Foundry-resurs

Om du vill skapa och prenumerera på en ny 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 innehåller fler än en resurstyper för Foundry Tools. Se till att skapa en med kind av AIServices.

Du kan skapa en 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 Foundry-resurs kan du du kan behöva aktivera behörigheten för den Azure resursprovidern med hjälp av kommandot Azure portal, PowerShell 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 resursanvändningen.

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 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 om du vill skapa en Foundry-resurs med hjälp av kommandona Azure PowerShell.

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 Microsoft Foundry-resursgrupp

Innan du skapar en 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 någon 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 Foundry Tools 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 Foundry-resurserna.
  • Tillgängligheten för vissa Foundry-verktyg kan variera beroende på region. Mer information finns i Azure produkter efter region.
Get-AzLocation | Select-Object -Property Location, DisplayName

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

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

Skapa en Foundry-resurs

Om du vill skapa och prenumerera på en ny 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 innehåller fler än en resurstyper för Foundry Tools. Se till att skapa en med Type (typ) av AIServices.

Du kan skapa en 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 Foundry-resurs kan du du kan behöva aktivera behörigheten för den Azure resursprovidern med hjälp av kommandot Azure portal, PowerShell 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 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

Åtkomst av din resurs

När du har skapat din första resurs kan du access den via Foundry-portalen för UX-prototyper, Foundry SDK för utveckling eller via Azure portal 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 är ett minimalt exempel som 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

Azure Rollbaserad Access Control (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 projektledningsbehörigheter. Kan bjuda in andra användare att samarbeta i ett projekt som "Azure AI-användare".
Azure AI-användare Beviljar utvecklingsbehörigheter.
Azure AI-kontoägare Ger fullständig access för att hantera AI-projekt och konton. Kan bjuda in andra användare att samarbeta i ett projekt som "Azure AI-användare".
Azure AI-ägare Ger fullständig access till hanterade AI-projekt och konton samt skapa och utveckla med projekt.

Anmärkning

Rollen Azure AI-ägare kommer snart att vara tillgänglig att tilldela i Azure- och Foundry-portalen.

Diagram över de inbyggda rollerna i Foundry.

För större företag med strikta rollbaserade access krav rekommenderar vi att du använder Azure AI-användarrollen med minst behörighet för utvecklare. För mindre företag som vill att deras utvecklare ska fungera själv i organisationen rekommenderar vi att du använder rollen Azure AI-ägare för utvecklarbehörigheter samt behörigheter för att skapa resurser.

Endast behöriga användare, vanligtvis Azure prenumeration eller resursgruppsägare, kan tilldela en roll via [Azure portal](länk till Azure portal) eller [Foundry-portalen via administratör](Länk till Foundry-portalen). Läs mer om rollbaserad åtkomstkontroll.

Viktigt!

Azure ä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 bygga i ditt första projekt

Med konfigurerade behörigheter är du nu redo att börja skapa Foundry. Öppna Foundry-portalen eller skapa ditt första projekt. 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
Foundry-ikonen Foundry-agenttjänst Kombinera kraften i generativa AI-modeller med verktyg som gör det möjligt för agenter att access och interagera med verkliga datakällor.
Foundry-ikonen Azure modellslutsats Utför modellinferens för flaggskeppsmodeller i Foundry-modellkatalogen.
Azure OpenAI i Foundry Models-ikonen Azure OpenAI Utför en mängd olika uppgifter för naturligt språk.
Innehållssäkerhetsikonen Content Safety Ett gjutningsverktyg som identifierar oönskat innehåll.
Document Intelligence-ikonen Document Intelligence Omvandla dokument till intelligenta datadrivna lösningar.
Language-ikonen Language Skapa appar med branschledande funktioner för naturlig språkförståelse.
Speech-ikonen Speech Tal till text, text to speech, översättning och talarigenkänning.
Translator ikon Translator 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

  • Last updated on