Erstellen eines Projekts für Microsoft Foundry (klassisch)

• Bei Verwendung des Portals sind keine anderen Voraussetzungen erforderlich.

• Richten Sie Ihre Entwicklungsumgebung ein.

• Führen Sie az login oder az login --use-device-code in Ihrer Umgebung aus, bevor Sie Code ausführen.

• Installationspakete: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0. Wenn Sie sich in einer Notizbuchzelle befinden, verwenden Sie %pip install stattdessen.

• Verwenden Sie diese pip show azure-mgmt-cognitiveservices Option, um zu überprüfen, ob Ihre Version 13.7 oder höher ist.

• Schnelle Überprüfung: Überprüfen Sie vor dem Erstellen eines Projekts Ihr SDK und die Authentifizierung, indem Sie den Client 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.")
  

• Starten Sie Ihr Skript mit dem folgenden Code, um die client in diesem Artikel verwendete Verbindung und Variablen zu erstellen. In diesem Beispiel wird das Projekt in Ost-USA, Westen erstellt:

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

• (Optional) Wenn Sie über mehrere Konten verfügen, fügen Sie die Mandanten-ID der Microsoft Entra-ID, die Sie verwenden wollen, in DefaultAzureCredential ein.

  DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
  

• (Optional) Wenn Sie in den regionen Azure Government - US oder Azure betrieben von 21Vianet arbeiten, geben Sie die Region an, für die Sie sich authentifizieren möchten. In diesem Beispiel wird die Authentifizierung gegenüber der Azure Government-US-Region vorgenommen.

  from azure.identity import AzureAuthorityHosts
  DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
  

• Installieren Sie die Azure CLI.
• Legen Sie den Standardwert für subscription.

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

Diese Schritte bieten eine Möglichkeit, eine neue Azure-Ressource mit grundlegenden Standardeinstellungen zu erstellen.

Führen Sie die folgenden Schritte aus, um ein Foundry-Projekt zu erstellen:

1. Melden Sie sich bei Microsoft Foundry an. Stellen Sie sicher, dass der Umschalter "Neue Gießerei " deaktiviert ist. Diese Schritte beziehen sich auf Foundry (klassisch).

   

2. Was Sie als Nächstes tun, hängt davon ab, wo Sie sich befinden:

   • Wenn Sie sich noch nicht in einem Projekt befinden oder noch keine Projekte haben: Wählen Sie oben rechts " Neu erstellen " aus, um ein neues Foundry-Projekt zu erstellen.

     

   • Wenn Sie sich in einem Projekt befinden: Wählen Sie das Projekt Breadcrumb aus, und wählen Sie dann "Neue Ressource erstellen" aus.

     

3. Wählen Sie Foundry-Ressource aus, und wählen Sie dann Weiter aus.

4. Geben Sie einen Namen für Ihr Projekt ein, und wählen Sie "Erstellen" aus. Oder im nächsten Abschnitt finden Sie erweiterte Optionen.

Erweiterte Optionen

1. Sie erstellen ein Foundry-Projekt für eine Foundry Ressource. Das Portal erstellt diese Ressource automatisch, wenn Sie das Projekt erstellen. Wählen Sie eine vorhandene zu verwendende Ressourcengruppe aus, oder lassen Sie die Standardeinstellung, um eine neue Ressourcengruppe zu erstellen.

   Tipp

   Erstellen Sie insbesondere für die ersten Schritte eine neue Ressourcengruppe für Ihr Projekt. Die Ressourcengruppe erleichtert das Verwalten des Projekts und aller zugehörigen Ressourcen.

2. Wählen Sie einen Speicherort aus, oder verwenden Sie die Standardeinstellung. Der Standort ist die Region, in der die Projektressourcen gehostet werden.

3. Wählen Sie "Erstellen" aus. Der Fortschritt der Ressourcenerstellung wird angezeigt. Das Projekt wird erstellt, wenn der Prozess abgeschlossen ist.

So erstellen Sie ein Foundry-Projekt:

• Fügen Sie den folgenden Code hinzu, um ein Foundry-Projekt mithilfe der Variablen und client der Verbindung aus dem Abschnitt "Voraussetzungen" zu erstellen.

  # 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": {}
      }
  )
  

  Referenzen: CognitiveServicesManagementClient.

1. Erstellen Sie eine Ressourcengruppe, oder verwenden Sie eine vorhandene. Erstellen Sie my-foundry-rg z. B. in eastus:

   az group create --name my-foundry-rg --location eastus
   

2. Erstellen Sie die Foundry-Ressource. Erstellen Sie my-foundry-resource beispielsweise in der my-foundry-rg Ressourcengruppe:

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

   Das --allow-project-management Flag ermöglicht die Projekterstellung innerhalb dieser Ressource.

3. Erstellen Sie eine benutzerdefinierte Unterdomäne für die Ressource. Der benutzerdefinierte Domänenname muss global eindeutig sein. Wenn my-foundry-resource bereits verwendet wird, versuchen Sie, einen eindeutigeren Namen zu wählen.

   az cognitiveservices account update \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --custom-domain my-foundry-resource
   

4. Erstellen Sie das Projekt. Erstellen Sie beispielsweise my-foundry-project im 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. Überprüfen Sie, ob das Projekt erstellt wurde:

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

   Die Ausgabe zeigt die Projekteigenschaften einschließlich der Ressourcen-ID an.

Referenz: az cognitiveservices account

Auf der Startseite des Projekts finden Sie Informationen zum Projekt.

• Name: Der Name des Projekts wird in der oberen linken Ecke angezeigt.
• Abonnement: Das Abonnement, das die Ressource hostt, die das Projekt hosten soll.
• Ressourcengruppe: Die Ressourcengruppe, die die Ressource hostt, die das Projekt hosten soll.

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

Referenzen: CognitiveServicesManagementClient.

Verwenden Sie den Befehl az cognitiveservices account project show, um die Einstellungen für das Projekt anzuzeigen. Beispiel:

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

1. Melden Sie sich bei Microsoft Foundry an. Stellen Sie sicher, dass der Umschalter "Neue Gießerei " deaktiviert ist. Diese Schritte beziehen sich auf Foundry (klassisch).
2. Öffnen Sie Ihr Projekt.
3. Wählen Sie das Verwaltungscenter aus.
4. Wählen Sie unter "Ressource" die Option "Übersicht" aus.
5. Wählen Sie alle Projekte aus, die Sie nicht mehr behalten möchten.
6. Wählen Sie "Projekt löschen" aus.

So löschen Sie die Foundry-Ressource und alle zugehörigen Projekte:

1. Wählen Sie im Verwaltungscenter den Ressourcennamen aus dem Abschnitt "Übersicht" aus, um zum Azure Portal zu wechseln.
2. Wählen Sie im Azure-Portal Delete aus, um die Ressource und alle zugehörigen Projekte zu löschen.

Dieser Code verwendet die Variablen und die Verbindung client aus den Voraussetzungen. So löschen Sie ein einzelnes Projekt:

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

Referenzen: CognitiveServicesManagementClient.

Löschen Sie eine Foundry-Ressource und alle zugehörigen Projekte:

# 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()

Referenzen: CognitiveServicesManagementClient.

Führen Sie den folgenden Befehl aus:

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

Verweise: az cognitiveservices account project delete.