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 Foundry-accounteigenaar of Foundry-eigenaar voor het abonnement of de resourcegroep. Zie voor meer informatie over machtigingen Op rollen gebaseerd toegangsbeheer voor Microsoft Foundry.
Belangrijk
De rollen Foundry RBAC zijn onlangs hernoemd.
Foundry User, Foundry Owner, Foundry Account Owner en Foundry Project Manager zijn eerder benoemd Azure AI-gebruiker, Azure AI-eigenaar Azure AI-accounteigenaar en Azure AI Project Manager. Het kan zijn dat u op sommige plekken nog steeds de vorige namen ziet terwijl de naamswijziging wordt doorgevoerd. De rol-id's en basismachtigingen worden niet gewijzigd door de naamswijziging.
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.
Note
Voor deze stappen is de Azure CLI versie 2.80.0 of hoger en de rol Inzender of Eigenaar voor de resourcegroep vereist. Voer az version deze opdracht uit om uw versie te controleren en az upgrade als u een nieuwere versie nodig hebt. Voer az login uit om u aan te melden voordat u begint. Zie Regioondersteuning voor ondersteunde regio's.
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
Controleer of de resourcegroep bestaat:
az group show --name my-foundry-rg --query properties.provisioningState --output tsv
De uitvoer toont Succeeded.
Maak de Foundry-resource waarvoor projectbeheer is ingeschakeld. 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 \
--custom-domain my-foundry-resource \
--assign-identity \
--allow-project-management true
Gebruik deze waarden:
| Parameter |
Purpose |
--assign-identity |
Maakt de beheerde identiteit die vereist is voor projectbeheer. Zonder dit mislukt het aanmaken van een project met de foutmelding dat voor de resource een beheerde identiteit moet zijn ingeschakeld. |
--allow-project-management |
Hiermee schakelt u projectbeheer in. U kunt deze instelling niet wijzigen nadat u de resource hebt gemaakt. |
--custom-domain |
De naam moet wereldwijd uniek zijn. Als my-foundry-resource bezet is, mislukt de opdracht met CustomDomainInUse. Kies een andere naam en voer de opdracht opnieuw uit. |
Maak een 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 de resource is geprovisioneerd:
az cognitiveservices account show \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--query properties.provisioningState --output tsv
De uitvoer moet Succeeded weergeven. Als in de uitvoer een andere status wordt weergegeven, controleert u uw machtigingen, beschikbaarheid van regio's en resourcequota. Zie Een resource voor meerdere services maken voor meer hulp.
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 \
--query properties.provisioningState --output tsv
De uitvoer moet Succeeded weergeven. Als de opdracht mislukt met een bericht dat een beheerde identiteit moet worden ingeschakeld, controleert u of u de resource hebt gemaakt met --assign-identity.
Naslaginformatie: az cognitiveservices account project
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.
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.
-
Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is uitgeschakeld. Deze stappen verwijzen naar Foundry (klassiek).
Selecteer het Foundry-project of de bijbehorende resource.
Selecteer beheercentrum in het linkerdeelvenster.
Selecteer Overzicht in de resourcesectie.
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
Als u de verwijdering wilt controleren, voert u deze uit az cognitiveservices account project show met dezelfde resource- en projectnamen. De opdracht retourneert een resource-not-found-fout.
Verwijzingen: az cognitiveservices account project delete.
Belangrijk
Wees voorzichtig. U kunt een project niet herstellen nadat het is verwijderd.
Verwante inhoud