Quickstart: Uw eerste AI Foundry-resource maken

Meer informatie over het maken en beheren van een AI Foundry-resource. Het is het primaire resourcetype voor het ontwerpen, implementeren en beheren van generatieve AI-toepassingen en -agents. Het biedt toegang tot agentservice, modellen die worden gehost met behulp van een serverloos hostingmodel, evaluaties en Azure OpenAI-service. Dit is het aanbevolen resourcetype voor de meeste toepassingen die zijn gebouwd in Azure AI Foundry.

Azure AI Foundry is de volgende versie en wijzigt de naam van voormalige 'Azure AI Services'. Alle eerdere mogelijkheden worden ondersteund, waaronder Azure AI Services-modellen voor Speech, Vision, Taalmogelijkheden. Nieuwe mogelijkheden zijn AI Foundry-API waarmee u toegang krijgt tot agentservice en evaluaties, projecten als mappen om uw werk te organiseren en verbindingen om te integreren met andere Azure-services.

Wilt u AI Foundry gebruiken met geavanceerde beveiligingsinstellingen? Geavanceerde opties voor het maken van AI Foundry bekijken

Wilt u Azure AI Search-vaardigheden gebruiken? Bekijk de klassieke Azure AI-resource voor meerdere services.

Vereiste voorwaarden

• Een geldig Azure-abonnement - Maak een gratis abonnement.

Een nieuwe Azure AI Foundry-resource maken

Azure AI Foundry Portal biedt een manier om een nieuwe Azure-resource te maken met basisinstellingen, standaardinstellingen. Als uw organisatie aangepaste Azure-configuraties vereist, zoals alternatieve namen, beveiligingscontroles of kostentags, moet u in plaats daarvan Azure Portal of sjabloonopties gebruiken om te voldoen aan de naleving van Azure Policy van uw organisatie.

De Azure AI Foundry-resource voor meerdere services wordt vermeld onder AI Foundry> in de portal. Het soort API is AIServices. Zoek het logo zoals hier wordt weergegeven:

Belangrijk

Azure biedt meer dan één resourcetypen met de naam Azure AI-services. Zorg ervoor dat u het logo selecteert dat wordt vermeld onder AI Foundry>, zoals eerder is weergegeven.

Volg deze instructies om een AI Foundry-resource te maken:

Aanbeveling

Als u een Foundry-project of op een hub gebaseerde projectresource wilt maken, kunt u ook de Azure Foundry-portal gebruiken om de resource te maken. Zie de volgende artikelen voor meer informatie:

• Een Azure AI Foundry-project maken.
• Een op Azure AI Hub gebaseerd project maken.

1. Selecteer deze koppeling om een AI Foundry-resource te maken: https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

2. Geef op de pagina maken de volgende informatie op:

   Projectgegevens	Beschrijving
   Abonnement	Selecteer een van uw beschikbare Azure-abonnementen.
   Resourcegroep	De Azure-resourcegroep die uw Azure AI Foundry-resource bevat. U kunt een nieuwe groep maken of toevoegen aan een bestaande groep.
   Regio	De locatie van uw Azure AI-service-exemplaar. Verschillende locaties kunnen latentie veroorzaken, maar hebben geen invloed op de runtime-beschikbaarheid van uw resource.
   Naam	Een beschrijvende naam voor uw Azure AI Foundry-resource. Bijvoorbeeld MyAIServicesResource.

3. Configureer indien nodig andere instellingen voor uw resource, lees en accepteer de voorwaarden (indien van toepassing) en selecteer Vervolgens Beoordelen en maken.

Aanbeveling

Als u met uw abonnement geen AI Foundry-resource kunt maken, moet u mogelijk de bevoegdheid van die Azure-resourceprovider inschakelen met behulp van de Azure-portal, de PowerShell-opdracht of een Azure CLI-opdracht. Als u niet de eigenaar van het abonnement bent, vraagt u iemand met de rol van eigenaar of beheerder om de registratie voor u te voltooien of vraagt u om de bevoegdheden /register/action toe te kennen aan uw account.

De hulpbronnen opschonen

Als u een AI Foundry-resource wilt opschonen en verwijderen, kunt u de resource of resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle andere resources in de groep verwijderd.

1. Vouw in Azure Portal het menu aan de linkerkant uit om het menu met services te openen en kies Resourcegroepen om de lijst met resourcegroepen weer te geven.
2. Zoek de resourcegroep die de resource bevat die moet worden verwijderd.
3. Als u de hele resourcegroep wilt verwijderen, selecteert u de naam van de resourcegroep. Selecteer resourcegroep verwijderen op de volgende pagina en bevestig dit.
4. Als u alleen de Azure AI Foundry-resource wilt verwijderen, selecteert u de resourcegroep om alle resources hierin weer te geven. Selecteer op de volgende pagina de resource die u wilt verwijderen, selecteer het beletseltekenmenu voor die rij en selecteer Verwijderen.

Gebruik deze quickstart om een AI Foundry-resource te maken met behulp van CLI-opdrachten (Azure Command-Line Interface ).

Vereiste voorwaarden

• Een geldig Azure-abonnement: maak er gratis een .
• De Azure CLI

De Azure CLI installeren en u aanmelden

Installeer de Azure CLI. Voer de opdracht az login uit om u aan te melden bij uw lokale installatie van de CLI:

az login

Een nieuwe resourcegroep maken

Voordat u een AI Foundry-resource maakt, moet u een Azure-resourcegroep hebben die de resource moet bevatten. Wanneer u een nieuwe resource maakt, kunt u een nieuwe resourcegroep maken of een bestaande resourcegroep gebruiken. In dit artikel wordt beschreven hoe u een nieuwe resourcegroep maakt.

Als u een resource wilt maken, hebt u een van de Azure-locaties nodig die beschikbaar zijn voor uw abonnement. U kunt een lijst met beschikbare locaties ophalen met de opdracht az account list-locations . De meeste Azure AI-services zijn toegankelijk vanaf verschillende locaties. Kies de locatie die het dichtst bij u in de buurt is of kijk welke locaties beschikbaar zijn voor de service.

Belangrijk

• Onthoud uw Azure-locatie, omdat u deze nodig hebt bij het aanroepen van de Azure AI Foundry-resources.
• De beschikbaarheid van sommige Azure AI-services kan per regio verschillen. Zie Azure-producten per regio voor meer informatie.

az account list-locations --query "[].{Region:name}" --out table

Nadat u uw Azure-locatie hebt, maakt u een nieuwe resourcegroep in de Azure CLI met behulp van de opdracht az group create . Vervang in het onderstaande voorbeeld de Azure-locatie westus2 door een van de Azure-locaties die beschikbaar zijn voor uw abonnement.

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

Een AI Foundry-resource maken

Als u een nieuwe Azure AI Foundry-resource wilt maken en abonneren, gebruikt u de opdracht az cognitiveservices account create . Met deze opdracht wordt een nieuwe factureerbare resource toegevoegd aan de resourcegroep die u eerder hebt gemaakt. Wanneer u uw nieuwe resource maakt, moet u weten welk type service u wilt gebruiken, samen met de prijscategorie (of SKU) en een Azure-locatie.

Belangrijk

Azure biedt meer dan één resourcetypen voor Azure AI-services. Zorg ervoor dat u er een maakt met de kind van AIServices.

U kunt een AI Foundry-resource maken met de onderstaande foundry-multi-service-resource opdracht.

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

Aanbeveling

Als u met uw abonnement geen AI Foundry-resource kunt maken, moet u mogelijk de bevoegdheid van die Azure-resourceprovider inschakelen met behulp van de Azure-portal, de PowerShell-opdracht of een Azure CLI-opdracht. Als u niet de eigenaar van het abonnement bent, vraagt u iemand met de rol van eigenaar of beheerder om de registratie voor u te voltooien of vraagt u om de bevoegdheden /register/action toe te kennen aan uw account.

Huidig quotumgebruik voor uw resource ophalen

Gebruik de opdracht az cognitiveservices account list-usage om het gebruik voor uw resource op te halen.

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

De hulpbronnen opschonen

Als u een AI Foundry-resource wilt opschonen en verwijderen, kunt u deze of de resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle andere resources in de groep verwijderd.

Als u de resourcegroep en de bijbehorende resources wilt verwijderen, gebruikt u de az group delete command.

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

Gebruik deze quickstart om een AI Foundry-resource te maken met behulp van Azure PowerShell-opdrachten .

Vereiste voorwaarden

• Een geldig Azure-abonnement: maak er gratis een .
• Azure PowerShell.

Azure PowerShell installeren en u aanmelden

Installeer Azure PowerShell. Voer de opdracht Connect-AzAccount uit om u aan te melden:

Connect-AzAccount

Een nieuwe Azure AI Foundry-resourcegroep maken

Voordat u een AI Foundry-resource maakt, moet u een Azure-resourcegroep hebben die de resource moet bevatten. Wanneer u een nieuwe resource maakt, kunt u een nieuwe resourcegroep maken of een bestaande resourcegroep gebruiken. In dit artikel wordt beschreven hoe u een nieuwe resourcegroep maakt.

Als u een resource wilt maken, hebt u een van de Azure-locaties nodig die beschikbaar zijn voor uw abonnement. U kunt een lijst met beschikbare locaties ophalen met de opdracht Get-AzLocation . De meeste Azure AI-services zijn toegankelijk vanaf verschillende locaties. Kies de locatie die het dichtst bij u in de buurt is of kijk welke locaties beschikbaar zijn voor de service.

Belangrijk

• Onthoud uw Azure-locatie, omdat u deze nodig hebt bij het aanroepen van de Azure AI Foundry-resources.
• De beschikbaarheid van sommige Azure AI-services kan per regio verschillen. Zie Azure-producten per regio voor meer informatie.

Get-AzLocation | Select-Object -Property Location, DisplayName

Nadat u uw Azure-locatie hebt, maakt u een nieuwe resourcegroep in Azure PowerShell met behulp van de opdracht New-AzResourceGroup . Vervang in het onderstaande voorbeeld de Azure-locatie westus2 door een van de Azure-locaties die beschikbaar zijn voor uw abonnement.

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

Een AI Foundry-resource maken

Als u een nieuwe Azure AI Foundry-resource wilt maken en abonneren, gebruikt u de opdracht New-AzCognitiveServicesAccount . Met deze opdracht wordt een nieuwe factureerbare resource toegevoegd aan de resourcegroep die u eerder hebt gemaakt. Wanneer u uw nieuwe resource maakt, moet u weten wat voor soort service u wilt gebruiken, samen met de prijscategorie (of SKU) en een Azure-locatie:

Belangrijk

Azure biedt meer dan één resourcetypen voor Azure AI-services. Zorg ervoor dat u er een maakt met het Type (soort) van AIServices.

U kunt een AI Foundry-resource maken met de onderstaande foundry-multi-service-resource opdracht.

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

Aanbeveling

Als u met uw abonnement geen AI Foundry-resource kunt maken, moet u mogelijk de bevoegdheid van die Azure-resourceprovider inschakelen met behulp van de Azure-portal, de PowerShell-opdracht of een Azure CLI-opdracht. Als u niet de eigenaar van het abonnement bent, vraagt u iemand met de rol van eigenaar of beheerder om de registratie voor u te voltooien of vraagt u om de bevoegdheden /register/action toe te kennen aan uw account.

Huidig quotumgebruik voor uw resource ophalen

Gebruik de opdracht Get-AzCognitiveServicesAccountUsage om het gebruik voor uw resource op te halen.

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

De hulpbronnen opschonen

Als u een AI Foundry-resource wilt opschonen en verwijderen, kunt u deze of de resourcegroep verwijderen. Als u de resourcegroep verwijdert, worden ook alle andere resources in de groep verwijderd.

Gebruik de opdracht Remove-AzResourceGroup om de resourcegroep en de bijbehorende resources te verwijderen.

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

Standaardproject

In AI Foundry bieden projecten toegang tot ontwikkelaars-API's en fungeren ze als mappen om uw werk te organiseren. Er wordt een standaardproject voor u gemaakt wanneer u uw resource maakt in Azure Portal of Azure AI Foundry Portal. Het standaardproject heeft een bijzondere rol: het biedt achterwaartse compatibiliteit met ontwikkelaars-API's die worden ondersteund op het niveau van de bovenliggende bron. Dit zijn doorgaans AI Services en Azure OpenAI-API's voor modelaanpassing. Nieuwere API's, waaronder agents en evaluaties, zijn toegankelijk vanuit elk project. Zie Typen projecten voor meer informatie.

Uw AI Foundry-resource is mogelijk of niet gekoppeld aan een AI Foundry-project:

• Als uw AI Foundry-resources zijn gemaakt met behulp van Azure CLI, PowerShell, Bicep-sjabloon, Terraform of SDK's. In die gevallen is de AI Foundry-resource standaard niet gekoppeld aan een project. U kunt later een project maken als subresource.
• Als uw AI Foundry-resource is gemaakt als een verbinding. Wanneer u bijvoorbeeld probeert een model te implementeren dat niet beschikbaar is in de regio van uw huidige AI Foundry-resource.
• Een project kan worden gemaakt in de Azure AI Foundry-portal en automatisch gekoppeld als afhankelijk van een nieuwe AI Foundry-resource.
• Er is mogelijk een AI Foundry-resource gemaakt in de AI Foundry-portal, maar als afhankelijke resource van een Azure AI Foundry-hub. In dit geval wordt de resource automatisch gekoppeld aan het project dat u in de hub maakt.

Ondersteunde services met een AI Foundry-resource

Met de AI Foundry-resource hebt u toegang tot de volgende Azure AI-services met één set referenties. Sommige services zijn beschikbaar via de AI Foundry-resource en resource voor één service.

Aanbeveling

We raden u aan waar mogelijk de AI Foundry-resource (waarbij het API-soort is AIServices) te gebruiken voor toegang tot meerdere Azure AI-services met één set referenties. Voor services die niet beschikbaar zijn via de AI Foundry-resource (zoals Face en Custom Vision), kunt u ook een resource met één service maken.

Dienst	Beschrijving	Soort (via API)
Azure AI Foundry Agent Service	Combineer de kracht van generatieve AI-modellen met hulpprogramma's waarmee agents toegang hebben tot en interactie hebben met echte gegevensbronnen.	AIServices
Azure AI-modelinferentie	Voert modeldeductie uit voor vlaggenschipmodellen in de Azure AI Foundry-modelcatalogus.	AIServices
Azure OpenAI	Voer een groot aantal natuurlijke taaltaken uit.	AIServices OpenAI
Inhoudsveiligheid	Een AI-service die ongewenste inhoud detecteert.	AIServices ContentSafety
Custom Vision	Afbeeldingsherkenning voor uw bedrijf aanpassen.	CustomVision.Prediction (Alleen voorspelling) CustomVision.Training (Alleen training)
Documentintelligentie	Documenten omzetten in intelligente gegevensgestuurde oplossingen.	AIServices FormRecognizer
Gezicht	Detecteer en identificeer mensen en emoties in afbeeldingen.	Face
Taal	Bouw apps met toonaangevende mogelijkheden voor natuurlijke taalbegrip.	AIServices TextAnalytics
Spraak	Spraak naar tekst, tekst naar spraak, vertaling en sprekerherkenning.	AIServices Speech
Translator	Gebruik door AI gemaakte vertaaltechnologie om meer dan 100 in gebruik zijnde, risicovolle en bedreigde talen en dialecten te vertalen.	AIServices TextTranslation
Visioen	Analyseer inhoud in afbeeldingen en video's.	AIServices (Training en voorspelling) ComputerVision

Azure AI-multiservicesresource voor vaardigheden in Azure AI Search

Azure AI Search-vaardigheden bieden geen ondersteuning voor de AI Foundry-resource, zoals eerder in dit artikel is beschreven. U moet een ander soort multiserviceresource maken voor Azure AI Search-vaardigheden.

De resource voor meerdere services die u met Azure AI Search-vaardigheden kunt gebruiken, wordt vermeld onder AI Foundry>Classic AI-services>Azure AI-services-account voor meerdere services (klassiek) in de portal. Zoek het logo zoals hier wordt weergegeven:

Volg deze instructies om een resource met meerdere services voor Azure AI Search te maken:

1. Klik op deze koppeling om een klassieke Azure AI-services multi-service account resource te maken: https://portal.azure.com/#create/Microsoft.CognitiveServicesAllInOne

2. Geef op de pagina maken de volgende informatie op:

   Projectgegevens	Beschrijving
   Abonnement	Selecteer een van uw beschikbare Azure-abonnementen.
   Resourcegroep	De Azure-resourcegroep die uw Azure AI-services-resource voor meerdere services bevat. U kunt een nieuwe groep maken of toevoegen aan een bestaande groep.
   Regio	De locatie van uw exemplaar van een Azure AI-services-account voor meerdere services. Verschillende locaties kunnen latentie veroorzaken, maar hebben geen invloed op de runtime-beschikbaarheid van uw resource.
   Naam	Een beschrijvende naam voor uw Resource voor meerdere serviceaccounts van Azure AI-services. Bijvoorbeeld MyCognitiveServicesResource.
   Prijscategorie	De kosten van uw Azure AI-services-account voor meerdere services zijn afhankelijk van de opties die u kiest en uw gebruik. Zie de api-prijsinformatie voor meer informatie.

3. Configureer indien nodig andere instellingen voor uw resource, lees en accepteer de voorwaarden (indien van toepassing) en selecteer Vervolgens Beoordelen en maken.

Aanbeveling

Als u met uw abonnement geen AI Foundry-resource kunt maken, moet u mogelijk de bevoegdheid van die Azure-resourceprovider inschakelen met behulp van de Azure-portal, de PowerShell-opdracht of een Azure CLI-opdracht. Als u niet de eigenaar van het abonnement bent, vraagt u iemand met de rol van eigenaar of beheerder om de registratie voor u te voltooien of vraagt u om de bevoegdheden /register/action toe te kennen aan uw account.

Prijsstelling

Prijscategorieën (en het bedrag dat u in rekening wordt gebracht) zijn gebaseerd op het aantal transacties dat u verzendt met behulp van uw verificatiegegevens. Voor elke prijsklasse wordt het volgende gespecificeerd:

• Maximum aantal toegestane transacties per seconde (TPS).
• Servicefuncties die zijn ingeschakeld binnen de prijscategorie.
• Kosten voor een vooraf gedefinieerd aantal transacties. Als u boven dit nummer gaat, worden er extra kosten in rekening gebracht, zoals opgegeven in de prijsgegevens voor uw service.

Verwante inhoud

• Ga naar de azure AI Services Hub-pagina.
• Probeer AI-services in de Azure AI Foundry-portal.