Een project maken voor Microsoft Foundry

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.

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.

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.

Vereiste voorwaarden

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

• Als u het project zelf maakt:

  • 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 Rolgebaseerde toegangscontrole voor Microsoft Foundry voor meer informatie over machtigingen.

• Als u het project voor een team maakt:

  • Toegang tot een rol waarmee u roltoewijzingen, zoals Eigenaar, kunt voltooien. Zie Rolgebaseerde toegangscontrole voor Microsoft Foundry voor meer informatie over machtigingen.
  • Een lijst met e-mailadressen van gebruikers of Microsoft Entra beveiligingsgroep-id's voor teamleden die toegang nodig hebben.

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

Gieterij-portaal

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

Python SDK

• 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 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-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 toe van de Microsoft Entra ID die u wilt gebruiken in DefaultAzureCredential:

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

Azure CLI

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

Gieterij-portaal

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:

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

   

2. De project waaraan u werkt, wordt weergegeven in de linkerbovenhoek.

3. Als u een nieuwe project wilt maken, selecteert u de project naam en selecteert u vervolgens Nieuwe project.

4. Geef uw project een naam en selecteer Maak project. Of zie de volgende sectie voor geavanceerde opties.

Geavanceerde opties

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

   Aanbeveling

   Voor het opstarten, maakt u een nieuwe resourcegroep voor uw project aan. De resourcegroep maakt het eenvoudig om de project en alle bijbehorende resources samen te beheren.

2. Selecteer een locatie of gebruik de standaardwaarde. De locatie is de regio waar de project resources worden gehost.

3. Klik op Creëren. U ziet de voortgang van het aanmaken van resources. Het project wordt gemaakt wanneer het proces is voltooid.

Python SDK

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.

Azure CLI

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

2. 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 vlag --allow-project-management kunt u project maken binnen deze resource.

3. Maak een aangepast subdomein voor de resource. De custom domain naam 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
   

4. Maak de 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
   

5. Controleer of de 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 project eigenschappen weergegeven, inclusief de resource-id.

Verwijzing: az cognitiveservices account

Meerdere projecten op dezelfde resource maken

Maak meerdere Foundry-projecten op een bestaande Foundry-resource om teamsamenwerking en gedeelde toegang tot resources mogelijk te maken, inclusief beveiliging, deployments en verbonden gegevenshulpmiddelen. 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 hun eigen toegangsbeheer krijgen toegewezen, maar delen veelgebruikte instellingen zoals netwerkbeveiliging, implementaties en integratie met Azure-hulpprogramma's van de bovenliggende resource.

Hoewel nog niet alle foundry-mogelijkheden het organiseren van werk in projecten ondersteunen, is de eerste 'standaard'-project 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	Standaard project	Andere projecten
Modelinferentie	✅	✅
Speeltuinen	✅	✅
Agents	✅	✅
Evaluations	✅	✅
Tracing	✅	✅
Datasets	✅	✅
Indexen	✅	✅
Foundry SDK en API	✅	✅
Inhoudskennis	✅	✅
OpenAI SDK en API	✅	Antwoorden, bestanden, gesprekken
OpenAI Batch, Fine-tuning, Opgeslagen voltooiingen	✅	-
Fijnstemming van taal	✅	✅
Spraakfijnafstelling	✅	-
Connections	✅	✅

• Een project toevoegen aan een Foundry-resource:

  Gieterij-portaal

  1. Selecteer Bedienen in de rechterbovenhoek van de navigatie.
  2. Selecteer Beheerder in het linkerdeelvenster.
  3. Selecteer de bovenliggende resource waaraan u een project wilt toevoegen.
  4. Selecteer Project toevoegen.

  Python SDK

  Voeg deze code toe aan uw script om een nieuwe 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": {}
      }
  )
  

  Azure CLI

  Een nieuwe 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 project dat wordt gemaakt het standaardproject.

Instellingen voor project weergeven

Gieterij-portaal

Op de pagina Home project ziet u het project-eindpunt en de API-sleutel voor de project. U hebt de API-sleutel niet nodig als u Microsoft Entra ID verificatie gebruikt.

Python SDK

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

Azure CLI

Als u instellingen voor de project wilt weergeven, gebruikt u de opdracht az cognitiveservices account project show. Voorbeeld:

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

Toegang verlenen aan teamleden

Als u het project voor een team hebt gemaakt, wijst u de rol Azure AI-gebruiker toe aan teamleden, zodat ze het project en de bijbehorende resources kunnen gebruiken. Deze rol biedt de minimale machtigingen die nodig zijn voor het bouwen en testen van AI-toepassingen. Zie Toegangsbeheer op basis van Microsoft Foundry voor andere rollen die u mogelijk moet toewijzen.

Belangrijk

Als u roltoewijzingen wilt voltooien, hebt u een rol nodig, zoals Eigenaar op het project. Zie Toegangsbeheer op basis vanRole voor Microsoft Foundry voor meer informatie.

Gieterij-portaal

1. In de Foundry-portal selecteer Operate in de navigatie rechtsboven.
2. Selecteer Beheerder in het linkerdeelvenster.
3. Selecteer uw project naam in de tabel.
4. Selecteer Gebruiker toevoegen in de rechterbovenhoek.
5. Voer het e-mailadres van het teamlid in.
6. Selecteer Toevoegen.

Herhaal deze stappen voor elk teamlid of elke beveiligingsgroep.

Aanbeveling

Als u meerdere gebruikers tegelijk wilt toevoegen, gebruikt u een Microsoft Entra beveiligingsgroep in plaats van afzonderlijke e-mailadressen.

Python SDK

Gebruik de Azure CLI- of Foundry-portal om roltoewijzingen te beheren. De Python SDK biedt geen ondersteuning voor roltoewijzingsbewerkingen.

Azure CLI

1. Haal de resource-id van het project op:

   PROJECT_ID=$(az cognitiveservices account project show \
     --name my-foundry-resource \
     --resource-group my-foundry-rg \
     --project-name my-foundry-project \
     --query id -o tsv)
   

2. Wijs de rol Azure AI-gebruiker toe aan een teamlid:

   az role assignment create \
       --role "Azure AI User" \
       --assignee "user@contoso.com" \
       --scope $PROJECT_ID
   

   Een beveiligingsgroep toevoegen in plaats van een afzonderlijke gebruiker:

   az role assignment create \
       --role "Azure AI User" \
       --assignee-object-id "<security-group-object-id>" \
       --assignee-principal-type Group \
       --scope $PROJECT_ID
   

3. Controleer de roltoewijzing:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "Azure AI User" \
       --output table
   

Verwijzing: az-roltoewijzing

Toegang tot teamleden controleren

Vraag een teamlid om de toegang te controleren door u aan te melden bij Microsoft Foundry en het project te selecteren in de lijst met projecten.

Als het teamlid het project niet kan openen, controleer of de roltoewijzing is voltooid. Controleer of u het juiste e-mailadres of de juiste id van de beveiligingsgroep hebt gebruikt. Zorg ervoor dat het Azure-account van het teamlid zich in dezelfde Microsoft Entra tenant bevindt.

Projecten verwijderen

Gieterij-portaal

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

Python SDK

Deze code maakt gebruik van de variabelen en de client verbinding uit de voorgaande vereisten. 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.

Azure CLI

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

Belangrijk

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

Uw eerste verbinding maken

Verwante inhoud

• Microsoft Foundry Quickstart
• Wat is Foundry?
• Resources maken met behulp van Bicep sjabloon