Een project maken voor Microsoft Foundry

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

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

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

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. Het project waaraan u werkt, wordt in de linkerbovenhoek weergegeven.

3. Als u een nieuw project wilt maken, selecteert u de projectnaam en selecteert u vervolgens Nieuw project maken.

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

Geavanceerde opties

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

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

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

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
   

   Controleer of de resourcegroep bestaat:

   az group show --name my-foundry-rg --query properties.provisioningState --output tsv
   

   De uitvoer toont Succeeded.

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

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

4. Controleer of de resource is ingericht:

   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.

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

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

1. Selecteer Beheren in de navigatie in de rechterbovenhoek in de foundry-portal.
2. Selecteer Project details in het linkerdeelvenster.
3. Selecteer het tabblad Gebruikers.
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.

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

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 Foundry User toe aan een teamlid:

   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.

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --assignee-principal-type User \
       --scope $PROJECT_ID
   

Een beveiligingsgroep toevoegen in plaats van een afzonderlijke gebruiker:

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

1. Controleer de roltoewijzing:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

Naslaginformatie: az role assignment

1. Meld u aan bij Microsoft Foundry. Zorg ervoor dat de wisselknop New Foundry is ingeschakeld. Deze stappen verwijzen naar Foundry (nieuw).
2. Selecteer Beheren in de navigatie rechtsboven.
3. Selecteer Project details in het linkerdeelvenster.
4. Selecteer rechtsboven het prullenbakpictogram om het project 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.