Ein Projekt für Microsoft Foundry erstellen

Verwenden Sie diesen Artikel, um ein Foundry-Projekt zu erstellen und zu bestätigen, dass Ihre Umgebung bereit ist, bevor Sie mit dem Erstellen von Agents, Evaluierungen und Dateien beginnen.

In diesem Artikel wird beschrieben, wie Sie eine Foundry-project in Microsoft Foundry erstellen. Mit Projekten können Sie Ihre Arbeit – z. B. Agents, Auswertungen und Dateien – organisieren, während Sie zustandsbehaftete Apps erstellen und neue Ideen erkunden.

Wenn Ihre Organisation angepasste Azure Konfigurationen wie alternative Namen, Sicherheitskontrollen oder Kostentags erfordert, müssen Sie möglicherweise die Azure portal- oder Template-Optionen verwenden, um die Azure Policy Anforderungen Ihrer Organisation zu erfüllen.

Voraussetzungen

• Ein Azure Konto mit einem aktiven Abonnement. Wenn Sie kein Konto haben, erstellen Sie ein free Azure Konto, das ein kostenloses Testabonnement enthält.

• Access zu einer Rolle, mit der Sie eine Foundry-Ressource erstellen können, z. B. Azure Account AI Owner oder Azure AI Owner für das Abonnement oder die Ressourcengruppe. Weitere Informationen zu Berechtigungen finden Sie unter Role-based access control für Microsoft Foundry.

Verwenden Sie die folgenden Registerkarten, um die Methode auszuwählen, die Sie zum Erstellen eines Foundry-project verwenden möchten:

Foundry-Portal

• Bei Verwendung des Portals sind keine anderen Voraussetzungen erforderlich.

Python SDK

• 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 pip show azure-mgmt-cognitiveservices, 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 im Osten der USA 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>")
  

Azure CLI

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

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

Erstellen eines Foundry-Projekts

Verwenden Sie eine der folgenden Methoden.

Foundry-Portal

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 die Umschaltfläche "Neue Gießerei " aktiviert ist. Diese Schritte beziehen sich auf Foundry (neu).

   

2. Das Projekt, an dem Sie arbeiten, wird in der oberen linken Ecke angezeigt.

3. Wenn Sie ein neues Projekt erstellen möchten, wählen Sie den Namen des Projekts aus, und wählen Sie dann Neues Projekt erstellen aus.

4. Geben Sie Ihrem project einen Namen, und wählen Sie Create project aus. Oder im nächsten Abschnitt finden Sie erweiterte Optionen.

Erweiterte Optionen

1. Sie erstellen ein Foundry-Projekt in einer 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 zum Einstieg 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 project Ressourcen gehostet werden.

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

Python SDK

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

  Verweise: CognitiveServicesManagementClient.

Azure CLI

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 Flag --allow-project-management ermöglicht die Projekterstellung in dieser Ressource.

3. Erstellen Sie eine benutzerdefinierte Unterdomäne für die Ressource. Der custom domain Name 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

Erstellen mehrerer Projekte in derselben Ressource

Erstellen Sie mehrere Foundry-Projekte in einer vorhandenen Foundry-Ressource, um die Teamzusammenarbeit und den freigegebenen Zugriff auf Ressourcen, einschließlich Sicherheit, Bereitstellung und verbundene Tools, zu ermöglichen. Dieses Setup eignet sich ideal für eingeschränkte Azure-Abonnements, bei denen Entwickler innerhalb der Einrichtung einer vorkonfigurierten Umgebung Selbstbedienungs-Erkundungsmöglichkeit benötigen.

Das Diagramm zeigt, wie ein Team den Zugriff auf Ressourcen für mehrere Projekte auf einer Foundry-Ressource freigeben kann.

Foundry-Projekte als untergeordnete Azure-Ressourcen erhalten möglicherweise eigene Zugriffssteuerungen, nutzen aber Einstellungen wie Netzwerksicherheit, Bereitstellungen und Azure-Toolintegration ihrer übergeordneten Ressource.

Obwohl nicht alle Foundry-Funktionen das Organisieren von Arbeiten in Projekten unterstützen, ist das erste "Standard"-Projekt Ihrer Ressource leistungsstärker. Sie können sie durch das Tag "Standard" in UX-Oberflächen und der Ressourceneigenschaft "is_default" bei Verwendung von Codeoptionen identifizieren.

Merkmal	Standardprojekt	Weitere Projekte
Modellinferenz	✅	✅
Spielplätze	✅	✅
Agenten	✅	✅
Evaluations	✅	✅
Ablaufverfolgung	✅	✅
Datensätze	✅	✅
Indizes	✅	✅
Foundry SDK und API	✅	✅
Inhaltsverständnis	✅	✅
OpenAI SDK und API	✅	Antworten, Dateien, Unterhaltungen
OpenAI Batch, Feinabstimmung, Gespeicherte Fertigstellungen	✅	-
Feinabstimmung der Sprache	✅	✅
Feinabstimmung der Sprache	✅	-
Verbindungen	✅	✅

• Fügen Sie eine Projekt einer Foundry-Ressource hinzu:

  Foundry-Portal

  1. Wählen Sie Bedienen in der oberen rechten Navigationsleiste aus.
  2. Wählen Sie " Administrator " im linken Bereich aus.
  3. Wählen Sie die übergeordnete Ressource aus, der Sie ein Projekt hinzufügen möchten.
  4. Wählen Sie "Projekt hinzufügen" aus.

  Python SDK

  Fügen Sie Ihrem Skript diesen Code hinzu, um ein neues Projekt für Ihre vorhandene Ressource zu erstellen.

  # 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

  So fügen Sie ein neues Projekt zu my-foundry-resource hinzu:

   az cognitiveservices account project create \
   --name my-foundry-resource \
   --project-name {new_project_name} \
   --location eastus
  

• Wenn Sie das Standardprojekt der Foundry-Ressource löschen, wird das nächste erstellte Projekt zum Standardprojekt.

Anzeigen Projekteinstellungen

Foundry-Portal

Auf der Projektseite Home sehen Sie den Projekt-Endpunkt und den API-Schlüssel für das Projekt. Sie benötigen den API-Schlüssel nicht, wenn Sie Microsoft Entra ID Authentifizierung verwenden.

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)

Verweise: CognitiveServicesManagementClient.

Azure CLI

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

Projekte löschen

Foundry-Portal

1. Melden Sie sich bei Microsoft Foundry an. Stellen Sie sicher, dass die Umschaltfläche "Neue Gießerei " aktiviert ist. Diese Schritte beziehen sich auf Foundry (neu).
2. Wählen Sie in der oberen rechten Navigationsleiste "Bedienen" aus.
3. Wählen Sie im linken Bereich "Administrator" aus.
4. Wählen Sie Ihr Projekt aus.
5. Wählen Sie oben rechts das Papierkorbsymbol aus, um das Projekt zu löschen.

Python SDK

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
)

Verweise: 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()

Verweise: CognitiveServicesManagementClient.

Azure CLI

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

Referenzen: az cognitiveservices account project delete.

Von Bedeutung

Verwenden Sie sie mit Vorsicht. Sie können eine project nach dem Löschen nicht wiederherstellen.

Erstellen Der ersten Verbindung

Verwandte Inhalte

• Microsoft Foundry – Schnellstart
• Was ist Foundry?
• Erstellen von Ressourcen mithilfe der Bicep-Vorlage