Snabbstart: Konfigurera din första Foundry-resurs

I den här snabbstarten skapar du en Microsoft Foundry-resurs och kontrollerar att du kan ansluta till den.

Resursen Microsoft Foundry är den primära Azure resurstypen för att skapa, distribuera och hantera generativa AI-modeller, program och agenter. Det ger en Azure-hanterad gräns för identitet, åtkomstkontroll, nätverk, säkerhet, fakturering och övervakning, så dina AI-arbetsbelastningar följer samma resursmodell som allt annat i Azure.

Inom den gränsen sammanför en enda yta dina agenter, modelldistributioner och utvärderingar, med Azure OpenAI- och Foundry Tools (tidigare Azure AI services) som kan nås via en slutpunkt och nyckel. Du kan gruppera relaterat arbete i projekt som håller enskilda användningsfall åtskilda samtidigt som du delar samma underliggande resurs.

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

Tre sätt att skapa en Foundry-resurs

Välj den sökväg som matchar dina styrningskrav:

Metod När du ska använda detta Så här skapar du den
Basic setup – offentliga nätverk, Microsoft-hanterad kryptering, standardlagring. Snabba prototyper, enskilda utvecklare eller klienter utan strikta säkerhetskrav. Den här snabbstarten (Azure portal, Azure CLI eller Azure PowerShell).
Med säkerhetskontroller – ditt nätverk, din krypteringsnyckel, din identitet, dina principer. IT-administratörer framtvingar en säkerhetsbaslinje för organisationen. De avancerade flikarna i Azure portalen (lagring, nätverk, identitet, kryptering) som visas i Konfigurera avancerade säkerhetsinställningar i Azure-portalen eller Bicep och Terraform snabbstarter.
Standard för agenter – säkerhetskontroller plus egna Azure Cosmos DB, AI Search och lagringskonto för agenttrådslagring. Driftsättningar av agenter i produktion med krav på datalokalisering, regelefterlevnad eller kapacitetshantering. Varianter gäller för Speech, Language, Vision och Content Understanding. Avsnittet Storage>Agent-tjänsten i guiden Skapa i Azure-portalen (visas i Konfigurera avancerade säkerhetsinställningar i Azure-portalen) eller snabbstarterna för Bicep och Terraform.

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

Konfigurera avancerade säkerhetsinställningar i Azure-portalen

Guiden Azure portalen Skapa en Foundry-resurs visar ytterligare flikar för säkerhets- och lagringskontroller. Använd de här flikarna när du skapar en resurs med säkerhetskontroller eller standardinställningar för agentmetoder som beskrevs tidigare. Varje flik motsvarar ett specifikt styrningsproblem. I följande avsnitt beskrivs vad var och en kontrollerar och när de ska användas.

Fliken Nätverk – begränsa vem som kan nå din resurs

På fliken Network under Inbound Access väljer du hur resursen kan nås utifrån Azure:

  • Alla nätverk – offentlig slutpunkt öppen för Internet. Använd endast för prototyper.
  • Valda nätverk – offentlig slutpunkt som är begränsad till specifika virtuella nätverk och IP-intervall.
  • Inaktiverad – offentlig slutpunkt inaktiverad. Nå resursen exklusivt via privata slutpunkter. Använd det här alternativet för reglerade arbetsbelastningar eller när organisationens nätverksprincip förbjuder offentliga slutpunkter.

Skärmbild av fliken Nätverk i guiden Skapa en foundry-resurs som visar alternativen Alla nätverk, Valda nätverk och Inaktiverade under Inkommande åtkomst.

Fliken Identitet – välj hur resursen autentiserar till andra tjänster

På fliken Identitet aktiverar du en systemtilldelad hanterad identitet (en identitet som är kopplad till resurslivscykeln) eller bifogar användartilldelade hanterade identiteter (återanvändbara identiteter som du kan bevilja flera resurser). Använd en hanterad identitet i stället för API-nycklar när Foundry-resursen behöver anropa Azure Storage, Azure Cosmos DB, Azure Key Vault eller någon annan Azure RBAC-skyddad tjänst. Vägledning för rolltilldelning finns i Rollbaserad åtkomstkontroll för Foundry.

Fliken Kryptering – ta med din egen nyckel för vilande kryptering

På fliken Kryptering är standardvärdet Microsoft hanterade nycklar. Välj Kryptera data med hjälp av en kundhanterad nyckel (CMK) när din organisation behöver kontroll över nyckellivscykeln, nyckelrotationens kadens eller återkallande. CMK kräver ett Azure Key Vault med funktionerna mjuk borttagning och rensningsskydd samt en hanterad identitet med rollen Key Vault Crypto Service Encryption User. Krav och rotationsvägledning finns i Kundhanterade nycklar för kryptering.

Skärmbild av fliken Kryptering i guiden Skapa en Foundry-resurs, med kryssrutan Kryptera data med en kundhanterad nyckel under Datakryptering.

Fliken Lagring – ta med egna datalager för agenttjänsten

På fliken Storage I avsnittet Credential storage and application logging kan du peka resursen på din egen Azure Key Vault och Application Insights instanser i stället för Microsoft hanterade standardvärden.

I avsnittet Agenttjänst väljer du standardkonfigurationen för agenter. Välj Välj resurser för att binda ditt eget Azure Cosmos DB konto (för trådlagring), Azure AI-sökning index (för kunskapshämtning) och Lagringskonto (för filer) till en modelldistribution. Använd det här alternativet när du behöver datahemvist, kundhanterad kryptering på agentdata eller kapacitetsisolering för arbetsbelastningar för produktionsagenter. Tal- och språktjänster har ett liknande lagringskontoalternativ (förhandsversion). Arkitekturen och kraven finns i Konfigurera inställningar för agentkapacitet.

Skärmbild av avsnittet Agenttjänst på fliken Lagring i guiden Skapa en Foundry-resurs, som visar knappen Välj resurser och kolumnerna Modelldistribution, Cosmos DB, AI-sökning och Lagringskonto, med avsnittet Tal- och språktjänst under det.

Åtkomst av din resurs

När din första resurs har skapats kan du komma åt och hantera den med hjälp av Azure-portalen, Azure CLI eller Azure PowerShell:

  • Azure portal – bläddra till resursen i Azure-portalen för att visa dess status, slutpunkt, nycklar och konfiguration.
  • Azure CLI – använd az cognitiveservices-kontokommandona för att fråga efter och uppdatera resursen i skript och automatisering.
  • Azure PowerShell – använd cmdletarna Az.CognitiveServices för att fråga efter och uppdatera resursen i skript och automatisering.

Kontrollera konfigurationen

Kontrollera att resursen har konfigurerats korrekt med hjälp av Azure-portalen, Azure CLI eller Azure PowerShell.

  1. Logga in på Azure-portalen och gå till din Foundry-resurs.
  2. På sidan Översikt kontrollerar du att Status är Tillgänglig (eller att etableringsstatusen visas som lyckat).
  3. På sidan Översikt noterar du slutpunktsvärdet . Du använder den här slutpunkten för att anropa resursen.
  4. Under Resurshanteringsnycklar>och Slutpunkt kontrollerar du att nycklar och slutpunkten visas. Den här bekräftelsen innebär att resursen är etablerad och redo att användas.

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
Foundry-projektledare Beviljar utvecklingsbehörigheter och projektledningsbehörigheter. Kan bjuda in andra användare att samarbeta i ett projekt som "Foundry User".
Foundry-användare Beviljar utvecklingsbehörigheter.
Foundry-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 "Foundry User".
Foundry-ägare Ger fullständig access till hanterade AI-projekt och konton samt skapa och utveckla med projekt.

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.

Anmärkning

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

Diagram över de inbyggda rollerna i Foundry.

För större företag med strikta rollbaserade åtkomstkrav använder du foundry-användarrollen för att bevilja behörigheter för utvecklare med minst behörighet. För mindre företag som vill att utvecklarna ska fungera själv i organisationen använder du rollen Foundry-ä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 portalen.

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 på naturligt språk.
Innehållssäkerhetsikonen Content Safety Ett Foundry-verktyg 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änder AI-baserad översättningsteknik för att översätta mer än 100 använda, riskfyllda och utrotningshotade språk och dialekter.

Nästa steg

  • Uppdaterades senast