Een project maken voor Microsoft Foundry (klassiek)

Gebruik dit artikel om een Foundry-project te maken en te bevestigen dat uw omgeving gereed is voordat u begint met het bouwen van agents, evaluaties en bestanden.

Momenteel weergeven:Foundry -portalversie - (klassiek)Overschakelen naar versie voor de nieuwe Foundry-portal

In dit artikel wordt beschreven hoe u een Foundry-project maakt in Microsoft Foundry. Met projecten kunt u uw werk, zoals agents, evaluaties en bestanden, ordenen terwijl u stateful apps bouwt en nieuwe ideeën verkent.

Een Foundry-project wordt beheerd onder een Microsoft 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 gebruiksvoorbeelden zonder dat u extra Azure resources hoeft te maken.
Als u toegang nodig hebt tot opensource-modellen of PromptFlow, maakt u in plaats daarvan een hubprojecttype .
Zie Typen projecten voor meer informatie over de verschillende projecttypen.

Als uw organisatie aangepaste Azure configuraties vereist, zoals alternatieve namen, beveiligingscontroles of kostentags, moet u mogelijk de Azure-portal of templateopties gebruiken om te voldoen aan de Azure Policy vereisten van uw organisatie.

Voorwaarden

Een Azure-account met een actief abonnement. Als u nog geen account hebt, maakt u een vrij Azure-account, inclusief een gratis proefabonnement.
Toegang tot een rol waarmee u een Foundry-resource kunt maken, zoals Azure AI-eigenaar van het account of Azure AI-eigenaar voor het abonnement of de resourcegroep. Zie voor meer informatie over machtigingen Op rollen gebaseerd toegangsbeheer voor Microsoft Foundry.

Als u deze rol mist, vraagt u de abonnementsbeheerder om een Foundry-resource te maken en gaat u verder met het maken van meerdere projecten op dezelfde resource.

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

Er zijn geen andere vereisten nodig bij het gebruik van de portal.

Stel uw ontwikkelomgeving in.
Voer az login of az login --use-device-code in uw omgeving uit voordat u code uitvoert.
Installeer pakketten: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Als u zich in een notebookcel bevindt, gebruikt u %pip install in plaats daarvan.
Gebruik pip show azure-mgmt-cognitiveservices dit om te controleren of uw versie 13.7 of hoger is.

Snelle validatie: Controleer uw SDK en verificatie voordat u een project maakt door de client te testen:

from azure.identity import DefaultAzureCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient

# Test authentication by instantiating the client
credential = DefaultAzureCredential()
subscription_id = "<your-subscription-id>"  # Replace with your subscription ID
client = CognitiveServicesManagementClient(credential, subscription_id)
print("✓ Authentication successful! Ready to create a project.")

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 US.

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"
)

(Optioneel) Als u meerdere accounts hebt, voegt u de tenant-id toe van de Microsoft Entra ID die u wilt gebruiken in DefaultAzureCredential:
```
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
```

(Optioneel) Als u werkt in de Azure Government - VS of Azure beheerd door 21Vianet regio's, geeft u de regio op waarmee u zich wilt verifiëren. In dit voorbeeld authenticeert men naar de Azure Government-regio VS.
```
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
```

Installeer de Azure CLI.
Stel de standaardwaarde in voor subscription.

# Set your default subscription
az account set --subscription "{subscription-name}"

Een Foundry-project maken

Gebruik een van de volgende methoden.

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

Voer de volgende stappen uit om een Foundry-project te maken:

Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is uitgeschakeld. Deze stappen verwijzen naar Foundry (klassiek).
Wat u vervolgens doet, is afhankelijk van waar u bent:
- Als u geen project hebt of als u nog geen projecten hebt: selecteer Nieuwe maken in de rechterbovenhoek om een nieuw Foundry-project te maken
- Als u in een project bent: selecteer de breadcrumb van het project en selecteer vervolgens Nieuwe resource maken.
Selecteer Foundry-bron en klik op Volgende.
Geef een naam op voor uw project en selecteer Maken. Of zie de volgende sectie voor geavanceerde opties.

Geavanceerde opties

U maakt een Foundry-project op een Foundry resource. Het portaal maakt deze bron automatisch aan wanneer u het project aanmaakt. Selecteer een bestaande resourcegroep die u wilt gebruiken of laat de standaardwaarde staan om een nieuwe resourcegroep te maken.

Tip

Maak met name voor het aan de slag gaan een nieuwe resourcegroep voor uw project. De resourcegroep maakt het eenvoudig om het project en alle bijbehorende resources samen te beheren.
Selecteer een locatie of gebruik de standaardwaarde. De locatie is de regio waar de projectbronnen worden gehost.
Selecteer Maken. U ziet de voortgang van de creatie van resources. Het project wordt gemaakt wanneer het proces is voltooid.

Een Foundry-project maken:

Voeg de volgende code toe om een Foundry-project te maken met behulp van de variabelen en client verbinding uit de sectie 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": {}
    }
)

Verwijzingen: CognitiveServicesManagementClient.

Maak een resourcegroep of gebruik een bestaande resourcegroep. Maak bijvoorbeeld my-foundry-rg het volgende in eastus:
```
az group create --name my-foundry-rg --location eastus
```

Maak de Foundry-resource aan. Maak my-foundry-resource bijvoorbeeld in de my-foundry-rg resourcegroep:

az cognitiveservices account create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --kind AIServices \
    --sku s0 \
    --location eastus \
   --allow-project-management

Met de --allow-project-management flag kan een project worden gemaakt binnen deze resource.

Maak een aangepast subdomein voor de resource. De aangepaste domeinnaam moet wereldwijd uniek zijn. Als my-foundry-resource gebruikt wordt, probeert u een uniekere naam.
```
az cognitiveservices account update \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --custom-domain my-foundry-resource
```

Maak het project. Bijvoorbeeld, creëer my-foundry-project in de my-foundry-resource.

az cognitiveservices account project create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project \
    --location eastus

Controleer of het project is gemaakt:

az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project

In de uitvoer worden de projecteigenschappen weergegeven, inclusief de resource-id.

Referentie: az cognitiveservices account

Meerdere projecten op dezelfde resource maken

Maak meerdere Foundry-projecten op een bestaande 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 waar 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.

Foundry-projecten als onderliggende Azure-resources kunnen voorzien worden van hun eigen toegangsbeheer maar delen gemeenschappelijke instellingen, zoals netwerkbeveiliging, implementaties en Azure toolintegratie van de 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.

Kenmerk	Standaardproject	Andere projecten
Modelinferentie	✅	✅
Speeltuinen	✅	✅
Agenten	✅	✅
Evaluaties	✅	✅
Tracering	✅	✅
Datasets	✅	✅
Indexen	✅	✅
Foundry SDK en API	✅	✅
Inhoudskennis	✅	✅
OpenAI SDK en API	✅	Antwoorden, bestanden, gesprekken
OpenAI Batch, fine-tuning, opgeslagen voltooiingen	✅	-
Fijnafstemming van taal	✅	✅
Spraakafstemming	✅	-
Verbindingen	✅	✅

Een project toevoegen aan een Foundry-resource:
Tip

Omdat u het linkerdeelvenster kunt customiseren in de Microsoft Foundry-portal, 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. Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is uitgeschakeld. Deze stappen verwijzen naar Foundry (klassiek).
2. Selecteer het Foundry-project of de bijbehorende resource.
3. Selecteer beheercentrum in het linkerdeelvenster.
4. Selecteer Overzicht in de resourcesectie.
5. 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": {}
    }
)
```
Een nieuw project toevoegen aan my-foundry-resource:
```
 az cognitiveservices account project create \
 --name my-foundry-resource \
 --resource-group my-foundry-rg \
 --project-name {new_project_name} \
 --location eastus
```
Als u het standaardproject van uw Foundry-resource verwijdert, wordt het volgende gemaakte project het standaardproject.

Projectinstellingen weergeven

Op de startpagina vindt u informatie over het project.

Naam: De naam van het project wordt weergegeven in de linkerbovenhoek.
Abonnement: het abonnement dat als host fungeert voor de resource die als host fungeert voor het project.
Resourcegroep: de resourcegroep die de host is voor de resource die het project host.

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

Verwijzingen: CognitiveServicesManagementClient.

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

az cognitiveservices account project show \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

Projecten verwijderen

Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is uitgeschakeld. Deze stappen verwijzen naar Foundry (klassiek).
Open uw project.
Selecteer Beheercentrum.
Selecteer Onder Resource de optie Overzicht.
Selecteer alle projecten die u niet meer wilt behouden.
Selecteer Project verwijderen.

De Foundry-resource en alle bijbehorende projecten verwijderen:

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

Deze code maakt gebruik van de variabelen en client verbinding van de voorwaarden. Eén project verwijderen:

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Verwijzingen: CognitiveServicesManagementClient.

Een Foundry-resource en alle bijbehorende projecten verwijderen:

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

Verwijzingen: CognitiveServicesManagementClient.

Voer de volgende opdracht uit:

az cognitiveservices account project delete \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project

Verwijzingen: az cognitiveservices account project delete.

Belangrijk

Wees voorzichtig. U kunt een project niet herstellen nadat het is verwijderd.

Uw eerste verbinding maken

Feedback

Is deze pagina nuttig?

Last updated on 2026-05-01

Een project maken voor Microsoft Foundry (klassiek)

Voorwaarden

Een Foundry-project maken

Geavanceerde opties

Meerdere projecten op dezelfde resource maken

Projectinstellingen weergeven

Projecten verwijderen

Verwante inhoud

Feedback

Aanvullende resources