Een project maken voor Azure AI Foundry (Foundry-projecten)

2025-09-30

In dit artikel wordt beschreven hoe u een Foundry-project maakt in Azure AI Foundry. Met projecten kunt u uw werk organiseren, zoals agenten, beoordelingen en bestanden, terwijl u stateful apps bouwt en nieuwe ideeën verkent.

Een Azure AI Foundry-project wordt beheerd onder een Azure AI Foundry-resource. Het is een container voor toegangsbeheer, het uploaden en integreren van gegevens en het bewaken van gegevens. Hiermee kunt u uw werk gescheiden houden tussen use cases zonder dat u extra Azure-resources hoeft te maken.
Dit projecttype biedt u toegang tot de nieuwste generatieve AI-functies in AI Foundry, waaronder:
- Agenten
- Foundry SDK en API voor het bouwen van agents en het eenvoudig schakelen tussen modellen
- Modellen die rechtstreeks worden verkocht door Azure - Azure OpenAI, Mistral, xAI, DeepSeek, enzovoort.
- Partner- en communitymodellen die worden verkocht via Marketplace - Stabiliteit, Cohere, enzovoort.
- Inhoudskennis
- Evaluaties
- Fijn afstemmen
- OpenAI SDK en API inclusief. Batch- en opgeslagen voltooiingen
- AI-diensten
Hebt u toegang nodig tot Open Source-modellen of PromptFlow? Maak in plaats daarvan een hubprojecttype.
Zie Typen projecten voor meer informatie over de verschillende projecttypen.

Vereiste voorwaarden

Gebruik de volgende tabbladen om de methode te selecteren die u wilt gebruiken om een Azure AI Foundry-project te maken:

Een Azure-account met een actief abonnement. Als u nog geen azure-account hebt, maakt u een gratis Azure-account, inclusief een gratis proefabonnement.
U moet eigenaar van het abonnement zijn om over het juiste toegangsbeheer te beschikken dat nodig is om de Azure AI Foundry-resource te maken die het bovenliggende element van het project is. Als u deze toegang niet hebt, laat uw beheerder een AI Foundry-resource maken die u kunt gebruiken. Ga vervolgens verder met het maken van meerdere projecten op dezelfde resource om uw project te maken.

Een Azure-account met een actief abonnement. Als u nog geen azure-account hebt, maakt u een gratis Azure-account, inclusief een gratis proefabonnement.
U moet eigenaar van het abonnement zijn om het juiste toegangsbeheer te ontvangen dat nodig is om het project te kunnen gebruiken.
Uw ontwikkelomgeving instellen
Verifieer met az login of az login --use-device-code in uw omgeving voordat u code uitvoert.
Voer deze stappen uit om uw Python-script te starten:
1. Installeer pakketten: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1 . Als u zich in een notebookcel bevindt, gebruikt u %pip install in plaats daarvan '.
2. Gebruik pip show azure-mgmt-cognitiveservices dit om te controleren of uw versie 13.7 of hoger is.
3. Start uw script met de volgende code om de client verbinding en variabelen te maken die in dit artikel worden gebruikt. In dit voorbeeld wordt het project gemaakt in Oost VS.
```
from azure.identity import DefaultAzureCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient

subscription_id = 'your-subscription-id'
resource_group_name = 'your-resource-group-name'
foundry_resource_name = 'your-foundry-resource-name'
foundry_project_name = 'your-foundry-project-name'
location = 'eastus'

client = CognitiveServicesManagementClient(
    credential=DefaultAzureCredential(), 
    subscription_id=subscription_id,
    api_version="2025-04-01-preview"
)
```
4. (Optioneel) Als u meerdere accounts hebt, voegt u de tenant-id van de Microsoft Entra-id toe die u in het DefaultAzureCredentialaccount wilt gebruiken. Zoek uw tenant-id in Azure Portal onder Microsoft Entra ID, Externe identiteiten.
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```
5. (Optional) Als u werkt in de Azure Government - VS-regio of Azure beheerd door 21Vianet-regio, geeft u de regio op waarin u zich wilt authenticeren. U kunt de regio opgeven met DefaultAzureCredential. In het volgende voorbeeld wordt geverifieerd bij de regio Azure Government - VS:
```
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
```

Een Foundry-project maken

Deze stappen bieden een manier om een nieuwe Azure-resource te maken met standaardinstellingen.

Hint

Als uw organisatie aangepaste Azure-configuraties vereist, zoals alternatieve namen, beveiligingscontroles of kostentags, gebruikt u een van deze methoden om te voldoen aan de Azure Policy-naleving van uw organisatie:

Volg deze stappen om een Foundry-project te maken in Azure AI Foundry:

Meld u aan bij Azure AI Foundry.
Wat u vervolgens doet, is afhankelijk van waar u bent:
- Als u geen bestaande projecten hebt: volg de stappen in quickstart: Ga aan de slag met Azure AI Foundry om uw eerste project te maken.
- Als u in een project bent: selecteer de breadcrumb van het project en selecteer vervolgens Nieuwe resource maken.
- Als u zich niet in een project bevinden: selecteer Nieuwe maken in de rechterbovenhoek om een nieuw Azure AI Foundry-project te maken
Selecteer Azure AI Foundry-resource en kies vervolgens Volgende.
Geef een naam op voor uw project en selecteer Maken. Of zie de volgende sectie voor geavanceerde opties.

Geavanceerde opties

Er wordt een Foundry-project gemaakt op een AI Foundry resource. Deze resource wordt automatisch voor u gemaakt wanneer u het project maakt.

Volg deze stappen om de instellingen voor uw project aan te passen:

Selecteer geavanceerde opties in het formulier Een project maken.
Selecteer een bestaande resourcegroep die u wilt gebruiken of laat de standaardwaarde staan om een nieuwe resourcegroep te maken.

Hint

Met name voor het aan de slag gaan raden we u aan een nieuwe resourcegroep voor uw project te maken. Met de resourcegroep kunt u het project en alle bijbehorende resources eenvoudig samen beheren.
Selecteer een locatie of gebruik de standaardwaarde. De locatie is de regio waar de hub wordt gehost. De beschikbaarheid van Azure AI-services verschilt per regio. Bepaalde modellen zijn bijvoorbeeld mogelijk niet beschikbaar in bepaalde regio's.
Klik op Creëren. U ziet de voortgang van de aanmaak van resources en het project wordt aangemaakt wanneer het proces is voltooid.

Een Foundry-project maken:

Voeg deze code toe om een Foundry-project te maken, met behulp van de variabelen en client verbinding van de Vereisten.

# Create resource
resource = client.accounts.begin_create(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    account={
        "location": location,
        "kind": "AIServices",
        "sku": {"name": "S0",},
        "identity": {"type": "SystemAssigned"},
        "properties": {
            "allowProjectManagement": True,
            "customSubDomainName": foundry_resource_name
        }
    }
)

# Wait for the resource creation to complete
resource_result = resource.result()

# Create default project
project = client.projects.begin_create(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name,
    project={
        "location": location,
        "identity": {
            "type": "SystemAssigned"
        },
        "properties": {}
    }
)

Meerdere projecten op dezelfde resource maken

Maak meerdere Azure AI Foundry-projecten op een bestaande AI Foundry resource om teamsamenwerking en gedeelde resourcetoegang mogelijk te maken, waaronder beveiliging, implementaties en verbonden hulpprogramma's. Deze installatie is ideaal in beperkte Azure-abonnementen, waarbij ontwikkelaars zelfverkenningsmogelijkheid nodig hebben binnen de installatie van een vooraf geconfigureerde omgeving.

Diagram laat zien hoe een team resourcetoegang kan delen met meerdere projecten in een Foundry-resource.

Azure AI Foundry-projecten als onderliggende Azure-resources krijgen mogelijk hun eigen toegangsbeheer toegewezen, maar delen algemene instellingen, zoals netwerkbeveiliging, implementaties en Integratie van Azure-hulpprogramma's vanuit hun bovenliggende resource.

Hoewel nog niet alle Foundry-mogelijkheden het organiseren van werk in projecten ondersteunen, is het eerste standaardproject van uw resource krachtiger. U kunt deze identificeren door de tag 'standaard' in UX-ervaringen en de resource-eigenschap 'is_default' bij het gebruik van codeopties.

Eigenschap	Standaardproject	Andere projecten
Modeldeductie	✅	✅
Speeltuinen	✅	✅
Agenten	✅	✅
Evaluaties	✅	✅
Opsporen	✅	✅
Datasets	✅	✅
Indexes	✅	✅
Foundry SDK en API	✅	✅
Inhoudskennis	✅	✅
OpenAI SDK en API	✅	-
OpenAI Batch, Fine-tuning, Opgeslagen voltooiingen	✅	-
Fijnstemming van taal	✅	✅
Spraakfijnafstelling	✅	-
Verbindingen	✅	✅

Een project toevoegen aan een Foundry-resource:
Hint

Omdat u het linkerdeelvenster in de Azure AI Foundry-portal kunt aanpassen, ziet u mogelijk andere items dan in deze stappen wordt weergegeven. Als u niet ziet wat u zoekt, selecteert u ... Meer onder aan het linkerdeelvenster.
1. Selecteer in Azure AI Foundry het Azure AI Foundry-project of de bijbehorende resource.
2. Selecteer beheercentrum in het linkerdeelvenster.
3. Selecteer Overzicht in de resourcesectie.
4. Selecteer Nieuw project en geef een naam op.
Voeg deze code toe aan uw script om een nieuw project te maken voor uw bestaande resource:
```
# Create additional project
new_project_name = 'your-new-project-name'

project = client.projects.begin_create(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=new_project_name,
    project={
        "location": location,
        "identity": {
            "type": "SystemAssigned"
        },
        "properties": {}
    }
)
```
CLI-opdrachten zijn momenteel niet beschikbaar voor het maken van een Azure AI Foundry-project.
Als u het standaardproject van uw Foundry-resource verwijdert, wordt het volgende gemaakte project het standaardproject.

Projectinstellingen weergeven

Op de startpagina van het project vindt u informatie over het project.

Naam: De naam van het project wordt weergegeven in de linkerbovenhoek.
Abonnement: het abonnement dat de hub host die het project host.
Resourcegroep: de resourcegroep die de hub host waar het project wordt gehost.

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

Gebruik de az cognitiveservices account connection show opdracht om instellingen voor het project weer te geven. Voorbeeld:

az cognitiveservices account connection show --name {my_project_name} --resource-group {my_resource_group}

Projecten verwijderen

Open uw project in de Azure AI Foundry-portal.
Selecteer Beheercentrum.
Selecteer Overzicht onder de sectie Resource .
Selecteer alle projecten die u niet meer wilt behouden.
Selecteer Project verwijderen.

De AI Foundry-resource samen met alle bijbehorende projecten verwijderen:

Selecteer in het beheercentrum de resourcenaam in de sectie Overzicht om naar Azure Portal te gaan.
Selecteer verwijderen in Azure Portal om de resource en alle bijbehorende projecten te verwijderen.

Feedback

Is deze pagina nuttig?