Een project maken voor Microsoft Foundry

Opmerking

Dit document verwijst naar de Microsoft Foundry-portal (klassiek).

🔄 Schakel over naar de documentatie van Microsoft Foundry (nieuw) als u de nieuwe portal gebruikt.

Opmerking

Dit document verwijst naar de Microsoft Foundry-portal (nieuw).

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 use cases 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 sjabloonopties gebruiken om te voldoen aan de Azure Policy-vereisten van uw organisatie.

Vereiste voorwaarden

Een Azure-account met een actief abonnement. Als u nog geen azure-account hebt, maakt u een gratis Azure-account, inclusief een gratis proefabonnement.

Toegang tot een rol waarmee u een Foundry-resource kunt maken, zoals De AI-eigenaar van het Azure-account of de Azure AI-eigenaar voor het abonnement of de resourcegroep. Zie op rollen gebaseerd toegangsbeheer voor Microsoft Foundry voor meer informatie over machtigingen.

Toegang tot een rol waarmee u een Foundry-resource kunt maken, zoals De AI-eigenaar van het Azure-account of de Azure AI-eigenaar voor het abonnement of de resourcegroep. Zie op rollen gebaseerd toegangsbeheer voor Microsoft Foundry voor meer informatie over machtigingen.

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:
- Een Azure-account met een actief abonnement. Als u nog geen azure-account hebt, maakt u een gratis Azure-account, inclusief een gratis proefabonnement.
- Uw ontwikkelomgeving instellen
- Voer az login of az login --use-device-code in uw omgeving uit voordat u code uitvoert.
- Snelle validatie: Voordat u een project maakt, controleert u of uw SDK en verificatie werken 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.")
```
- Voer deze stappen uit om uw Python-script te starten:
  
  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.
  
  Gebruik pip show azure-mgmt-cognitiveservices dit om te controleren of uw versie 13.7 of hoger is.
  
  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" )
  
  (Optioneel) Als u meerdere accounts hebt, voegt u de tenant-id van de Microsoft Entra-id toe die u wilt gebruiken in de DefaultAzureCredential.
  
  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  
  (Optioneel) Als u werkt in de regio Azure Government - US of Azure beheerd door 21Vianet, specificeer dan de regio waarmee u zich wilt authentiseren. In dit voorbeeld wordt geverifieerd bij de regio Azure Government - VS:
  
  from azure.identity import AzureAuthorityHosts DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
- Voer deze stappen uit om uw Python-script te starten:
  
  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.
  
  Gebruik pip show azure-mgmt-cognitiveservices dit om te controleren of uw versie 13.7 of hoger is.
  
  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" )
  
  (Optioneel) Als u meerdere accounts hebt, voegt u de tenant-id van de Microsoft Entra-id toe die u wilt gebruiken in de DefaultAzureCredential.
  
  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
- Installeer de Azure CLI.
- Stel standaardwaarden in voor subscription.
```
  # Set your default subscription
  az account set --subscription "{subscription-name}"
```

Een Foundry-project maken

Deze stappen bieden een manier om een nieuwe Azure-resource te maken met basis-, 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).

Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).
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 Microsoft 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 Foundry-project te maken
Selecteer Foundry-resource en selecteer vervolgens Volgende.
Geef een naam op voor uw project en selecteer Maken. Of zie de volgende sectie voor geavanceerde opties.

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

Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).
Het project waaraan u werkt, wordt in de linkerbovenhoek weergegeven.
Als u een nieuw project wilt maken, selecteert u de projectnaam en selecteert u vervolgens Nieuw project maken.
Geef uw project een naam en selecteer Project maken. Of zie de volgende sectie voor geavanceerde opties.

Geavanceerde opties

U maakt een Foundry-project op een Foundry resource. In de portal wordt deze resource automatisch gemaakt wanneer u het project maakt. Selecteer een bestaande resourcegroep die u wilt gebruiken of laat de standaardwaarde staan om een nieuwe resourcegroep te maken.

Hint

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.
Klik op Creëren. U ziet de voortgang van het aanmaken 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 de variabelen en de client-connectie uit 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": {}
    }
)

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. 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 vlag kan er binnen deze resource een project worden gemaakt.

Maak een aangepast subdomein voor de resource. De aangepaste domeinnaam moet wereldwijd uniek zijn. Als my-foundry-resource bezet is, probeer een meer unieke naam.
```
az cognitiveservices account update \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --custom-domain my-foundry-resource
```

Maak het project. Maak bijvoorbeeld 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, 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.

Foundry-projecten die als onderliggende Azure-resources fungeren, kunnen hun eigen toegangsinstellingen toegewezen krijgen, maar delen algemene instellingen, zoals netwerkbeveiliging, implementaties en integratie van Azure-hulpprogramma's vanuit hun bovenliggende bron.

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	✅	Antwoorden, bestanden, gesprekken
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 Microsoft 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. Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is uitgeschakeld. Deze stappen verwijzen naar Foundry (klassiek).
  
  Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).
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.
In de Foundry-portal (nieuw) wordt alleen het standaardproject voor elke Foundry-resource weergegeven. U kunt geen meerdere projecten maken of een van de niet-standaardprojecten weergeven in de Foundry-portal (nieuw).
Hoewel deze code extra projecten aan een resource kan toevoegen, kunt u ze niet weergeven in de Foundry-portal (nieuw). Alleen het standaardproject voor een resource is beschikbaar in de Foundry(nieuwe) portal.

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": {}
    }
)
```
Hoewel deze code extra projecten aan een resource kan toevoegen, kunt u ze niet weergeven in de Foundry-portal (nieuw). Alleen het standaardproject voor een resource is beschikbaar in de Foundry(nieuwe) portal.

Een nieuw project toevoegen aan my-foundry-resource:
```
 az cognitiveservices account project create \
 --name my-foundry-resource \
 --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 de hub herbergt die het project herbergt.
Resourcegroep: de resourcegroep die de hub host die het project huisvest.

Op de startpagina van het project ziet u het projecteindpunt en de API-sleutel voor het project. U hebt de API-sleutel niet nodig als u Microsoft Entra ID-verificatie gebruikt.

# 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 connection show opdracht om instellingen voor het project weer te geven. Voorbeeld:

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

Projecten verwijderen

Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is uitgeschakeld. Deze stappen verwijzen naar Foundry (klassiek).

Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).
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 Azure Portal te gaan.
Selecteer Verwijderen in Azure Portal om de resource en alle bijbehorende projecten te verwijderen.

Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is uitgeschakeld. Deze stappen verwijzen naar Foundry (klassiek).

Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).
Selecteer In de navigatie rechtsboven de optie Werken.
Selecteer Beheerder in het linkerdeelvenster.
Selecteer uw project.
Selecteer rechtsboven het prullenbakpictogram om het project te verwijderen.

Deze code maakt gebruik van de variabelen en client connection uit de Pre-requisites. Maak eerst de clientverbinding:

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-rg \
--project-name my-foundry-project

Verwijzingen: az cognitiveservices account project delete.

Belangrijk

Met voorzichtigheid gebruiken. U kunt een project niet herstellen nadat het is verwijderd.

Feedback

Is deze pagina nuttig?

Last updated on 2026-01-22

Delen via

Een project maken voor Microsoft Foundry

Vereiste voorwaarden

Een Foundry-project maken

Geavanceerde opties

Meerdere projecten op dezelfde resource maken

Projectinstellingen weergeven

Projecten verwijderen

Verwante inhoud

Feedback

Aanvullende resources