Erstellen eines Projekts für Microsoft Foundry

Hinweis

Dieses Dokument bezieht sich auf das Microsoft Foundry(klassische) Portal.

In diesem Artikel wird beschrieben, wie Sie ein Foundry-Projekt 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.

• Ein Foundry-Projekt wird unter einer Microsoft Foundry-Ressource verwaltet. Es ist ein Container für Zugriffsverwaltung, Datenupload und Integration und Überwachung. Auf diese Weise können Sie Ihre Arbeit zwischen Anwendungsfällen trennen, ohne zusätzliche Azure-Ressourcen erstellen zu müssen.

• Dieser Projekttyp bietet Ihnen Zugriff auf die neuesten generativen KI-Features in Foundry, einschließlich:

  • Agenten
  • Foundry SDK und API zum Erstellen von Agents und einfachem Wechseln zwischen Modellen
  • Modelle, die direkt von Azure verkauft werden – Azure OpenAI, Mistral, xAI, DeepSeek usw.
  • Partner & Community Models, die über Marketplace verkauft werden - Stability, Cohere und usw.
  • Inhaltsverständnis
  • Bewertungen
  • Optimierung
  • OpenAI SDK und API, einschließlich Batch- und gespeicherte Fertigstellungen
  • KI-Dienste

• Benötigen Sie Zugriff auf Open-Source-Modelle oder PromptFlow? Erstellen Sie stattdessen einen Hubprojekttyp .

• Weitere Informationen zu den verschiedenen Projekttypen finden Sie unter "Projekttypen ".

Wenn Ihre Organisation angepasste Azure-Konfigurationen wie alternative Namen, Sicherheitskontrollen oder Kostentags erfordert, müssen Sie möglicherweise das Azure-Portal oder die Vorlagenoptionen verwenden, um die Azure-Richtlinienanforderungen Ihrer Organisation einzuhalten.

Voraussetzungen

Verwenden Sie die folgenden Registerkarten, um die Methode auszuwählen, die Sie zum Erstellen eines Foundry-Projekts verwenden:

Microsoft Foundry-Portal

• Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie über keins verfügen, erstellen Sie ein kostenloses Azure-Konto, das ein kostenloses Testabonnement enthält.

• Sie müssen Besitzer des Abonnements sein, um die erforderliche Zugriffssteuerung zu haben, die notwendig ist, um die Foundry-Ressource zu erstellen, die das übergeordnete Element des Projekts darstellt. Wenn Sie nicht über diesen Zugriff verfügen, lassen Sie von Ihrem Administrator eine Foundry-Ressource erstellen, die Sie verwenden können. Fahren Sie dann mit Erstellen mehrerer Projekte in derselben Ressource fort, um Ihr Projekt zu erstellen.

Python SDK

• Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie über keins verfügen, erstellen Sie ein kostenloses Azure-Konto, das ein kostenloses Testabonnement enthält.
• Sie müssen Besitzer des Abonnements sein, um die entsprechende Zugriffssteuerung zu erhalten, die für die Verwendung des Projekts erforderlich ist.
• Einrichten Ihrer Entwicklungsumgebung
• Führen Sie az login oder az login --use-device-code in Ihrer Umgebung aus, bevor Sie Code ausführen.

• Führen Sie die folgenden Schritte aus, um Ihr Python-Skript zu starten:

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

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

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

  4. (Optional) Wenn Sie über mehrere Konten verfügen, fügen Sie die Mandanten-ID der Microsoft Entra-ID, die Sie verwenden möchten, in das DefaultAzureCredential ein.

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

  5. (Optional) Wenn Sie in der Azure Government - USA oder Azure betrieben von 21Vianet-Regionen arbeiten, geben Sie die Region an, für die Sie sich authentifizieren möchten. In diesem Beispiel erfolgt die Authentifizierung bei der Azure Government - US-Region:

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

Azure-Befehlszeilenschnittstelle

• Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie über keins verfügen, erstellen Sie ein kostenloses Azure-Konto, das ein kostenloses Testabonnement enthält.
• Sie müssen Besitzer des Abonnements sein, um die entsprechende Zugriffssteuerung zu erhalten, die für die Verwendung des Projekts erforderlich ist.
• Azure-Befehlszeilenschnittstelle

Erstellen eines Foundry-Projekts

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 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 noch keine Projekte haben: Führen Sie die Schritte in der Schnellstartanleitung aus: Erste Schritte mit Microsoft Foundry , um Ihr erstes 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.

     

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

     

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. Ein Foundry-Projekt wird in einer Foundry Ressource erstellt. Diese Ressource wird automatisch erstellt, wenn Sie das Projekt erstellen. Wählen Sie eine vorhandene Ressourcengruppe aus, die Sie verwenden möchten, oder übernehmen Sie die Standardeinstellung, um eine neue Ressourcengruppe zu erstellen.

   Tipp

   Insbesondere für die ersten Schritte empfehlen wir, eine neue Ressourcengruppe für Ihr Projekt zu erstellen. Mit der Ressourcengruppe können Sie das Projekt und alle zugehörigen Ressourcen problemlos verwalten.

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

3. Klicken Sie auf Erstellen. 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 diesen Code hinzu, um ein Foundry-Projekt zu erstellen. Verwenden Sie dazu die Variablen und die Verbindung client aus den Voraussetzungen.

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

Azure-Befehlszeilenschnittstelle

CLI-Befehle zum Erstellen eines Foundry-Projekts sind derzeit nicht verfügbar.

Erstellen mehrerer Projekte in derselben Ressource

Erstellen Sie mehrere Foundry-Projekte in einer vorhandenen Foundry Ressource, um die Zusammenarbeit des Teams und den gemeinsamen Ressourcenzugriff zu ermöglichen, einschließlich Sicherheit, Bereitstellungen und verbundenen Tools. Dieses Setup eignet sich ideal für eingeschränkte Azure-Abonnements, bei denen Entwickler die Möglichkeit zur eigenständigen Erkundung in einer vorkonfigurierten Umgebung benötigen.

Gießereiprojekte als untergeordnete Azure-Ressourcen erhalten möglicherweise eigene Zugriffssteuerungen, teilen aber gemeinsame Einstellungen wie Netzwerksicherheit, Bereitstellungen und Azure-Toolintegration von ihrer übergeordneten Ressource aus.

Obwohl nicht alle Foundry-Funktionen das Organisieren von Arbeiten in Projekten unterstützen, ist das erste "Standardprojekt" 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	✅	✅
Bewertungen	✅	✅
Ablaufverfolgung	✅	✅
Datensätze	✅	✅
Indizes	✅	✅
Foundry SDK und API	✅	✅
Inhaltsverständnis	✅	✅
OpenAI SDK und API	✅	-
OpenAI Batch, Feinabstimmung, Gespeicherte Fertigstellungen	✅	-
Feinabstimmung der Sprache	✅	✅
Feinabstimmung der Sprache	✅	-
Verbindungen	✅	✅

• So fügen Sie einer Foundry-Ressource ein Projekt hinzu:

  Microsoft Foundry-Portal

  Tipp

  Da Sie den linken Bereich im Microsoft Foundry-Portal anpassen können, werden möglicherweise andere Elemente als in diesen Schritten angezeigt. Wenn Sie nicht sehen, wonach Sie suchen, wählen Sie ... Mehr am unteren Rand des linken Bereichs.

  1. Wählen Sie in Foundry entweder das Foundry-Projekt oder die zugehörige Ressource aus.

  2. Wählen Sie im linken Bereich das Verwaltungscenter aus.

  3. Wählen Sie im Abschnitt "Ressource" die Option "Übersicht" aus.

  4. Wählen Sie "Neues Projekt" aus, und geben Sie einen Namen ein.

     

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

  CLI-Befehle zum Erstellen eines Foundry-Projekts sind derzeit nicht verfügbar.

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

Projekteinstellungen anzeigen

Foundry-Portal

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 den Hub hostt, der das Projekt hosten soll.
• Ressourcengruppe: Die Ressourcengruppe, die den Hub hosten, der das Projekt hosten soll.

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)

Azure-Befehlszeilenschnittstelle

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

az cognitiveservices account connection show --name <my_project_name> --resource-group <my_resource_group>

Projekte löschen

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 "Löschen " aus, um die Ressource und alle zugehörigen Projekte zu löschen.

Verwandte Inhalte

• Schnellstart: Erste Schritte mit Foundry
• Was ist Foundry?