Schnellstart: Einrichten von Microsoft Foundry-Ressourcen

In dieser Schnellstartanleitung erstellen Sie ein Microsoft Foundry Projekt und stellen ein Modell bereit. Wenn Sie ein Team verwalten, gewähren Sie auch Den Zugriff auf Teammitglieder. Nachdem Sie diese Schritte ausgeführt haben, können Sie oder Ihr Team mit dem Erstellen von KI-Anwendungen mit dem bereitgestellten Modell beginnen.

Tipp

In dieser Schnellstartanleitung erfahren Sie, wie Sie Ressourcen erstellen, um einen Agent mit einem einfachen Setup zu erstellen. Weitere erweiterte Szenarien, die Ihre eigenen Ressourcen verwenden, finden Sie unter Einrichten Ihrer Umgebung für die Agententwicklung.

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.
  • Wenn Sie das Projekt für sich selbst erstellen:
    • Zugriff auf eine Rolle, mit der Sie eine Foundry-Ressource erstellen können, z. B. "Foundry Account Owner " oder " Foundry Owner " im Abonnement oder der Ressourcengruppe. Weitere Informationen zu Berechtigungen finden Sie unter Role-based access control for Microsoft Foundry.

      Important

      Die Foundry-RBAC-Rollen wurden kürzlich umbenannt. Foundry User, Foundry Owner, Foundry Account Owner und Foundry Project Manager wurden zuvor Azure KI-Benutzer, Azure KI-Besitzer, Azure KI-Kontobesitzer und Azure AI Project Manager benannt. Möglicherweise werden die vorherigen Namen an einigen Stellen weiterhin angezeigt, während der Umbenennungsrollout ausgeführt wird. Die Rollen-IDs und Kernberechtigungen bleiben durch die Umbenennung unverändert.

  • Wenn Sie das Projekt für ein Team erstellen:
    • Zugriff auf eine Rolle, mit der Sie Rollenzuweisungen ausführen können, z. B. Besitzer. Weitere Informationen zu Berechtigungen finden Sie unter Role-based access control for Microsoft Foundry.
    • Eine Liste der Benutzer-E-Mail-Adressen oder Microsoft Entra Sicherheitsgruppen-IDs für Teammitglieder, die Zugriff benötigen.

Wählen Sie Ihre bevorzugte Methode mithilfe der folgenden Registerkarten aus:

  • Installieren Sie die Azure CLI Version 2.67.0 oder höher (überprüfen Sie az version).

  • Melden Sie sich bei Azure an:

    az login

Erstellen eines Projekts

Erstellen Sie ein Foundry-Projekt, um Ihre Arbeit zu organisieren. Das Projekt enthält Modelle, Agents und andere Ressourcen, die Ihr Team verwendet.

Tipp

Erstellen Sie Ihr Projekt in der Region West US 3 , wenn Sie ein Sofortmodell (Vorschau) ausprobieren möchten.

Note

Für diese Schritte sind die Azure CLI sowie die Rolle "Mitwirkender" oder "Besitzer" für die Ressourcengruppe erforderlich. Führen Sie az login aus, um sich anzumelden, bevor Sie beginnen. Unterstützte Regionen finden Sie unter Regionsunterstützung.

  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 mit aktivierter Projektverwaltung. 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 \
    --custom-domain my-foundry-resource \
    --allow-project-management

    Setzen Sie das --allow-project-managementFlag, um die Projektverwaltung zu aktivieren. Sie können dieses Flag nach der Ressourcenerstellung nicht mehr ändern. Der Wert --custom-domain muss global eindeutig sein – wenn my-foundry-resource bereits vergeben ist, wählen Sie einen anderen Namen.

  3. Erstellen Sie ein Projekt. Erstellen Sie zum Beispiel 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

  4. Stellen Sie sicher, dass die Ressource bereitgestellt wird:

    az cognitiveservices account show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --query properties.provisioningState --output tsv

    Die Ausgabe sollte Succeeded anzeigen. Wenn die Ausgabe einen anderen Zustand anzeigt, überprüfen Sie Ihre Berechtigungen, die Regionsverfügbarkeit und ressourcenkontingente. Weitere Hilfe finden Sie unter Erstellen einer Multi-Service-Ressource.

  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 \
    --query properties.provisioningState --output tsv

    Die Ausgabe sollte Succeeded anzeigen.

Bereitstellen eines Modells

Stellen Sie ein Modell bereit, das Sie verwenden können. In diesem Beispiel wird gpt-5.1-mini verwendet, Sie können jedoch ein beliebiges verfügbares Modell auswählen.

Tipp

Sie können diesen Schritt ganz überspringen, wenn Sie ein Sofortmodell (Vorschau) ausprobieren möchten.

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-5.1-mini \
    --model-name gpt-5.1-mini \
    --model-version "2025-04-14" \
    --model-format OpenAI \
    --sku-capacity 10 \
    --sku-name Standard

Überprüfen Sie, ob die Bereitstellung erfolgreich war:

az cognitiveservices account deployment show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-5.1-mini

Wenn die Bereitstellung abgeschlossen ist, wird die Ausgabe angezeigt "provisioningState": "Succeeded".

Referenz: az cognitiveservices account deployment

Erhalten Sie Ihre Projektverbindungsdetails

Sie benötigen Ihren Projektendpunkt, um eine Verbindung aus dem Code herzustellen. Wenn Sie dieses Projekt für andere Personen verwalten, senden Sie ihnen diesen Endpunkt zusammen mit dem Bereitstellungsnamen.

  1. Melden Sie sich mit Ihrem Azure-Konto bei Microsoft Foundry an.
  2. Wählen Sie Ihr Projekt aus.
  3. Suchen Sie Ihren Projektendpunkt auf der Willkommensseite des Projekts.Screenshot der Microsoft Foundry Models-Willkommensseite mit der Endpunkt-URL und der Schaltfläche zum Kopieren.
  4. Kopieren Sie den Endpunktwert. Sie verwenden diesen Wert in anderen Schnellstarts und Lernprogrammen.

Für Administratoren – Zugriff gewähren

Wenn Sie ein Team verwalten, weisen Sie teammitgliedern die Rolle " Foundry User " zu, damit sie das Projekt und die bereitgestellten Modelle verwenden können. Diese Rolle stellt die mindestberechtigungen bereit, die zum Erstellen und Testen von KI-Anwendungen erforderlich sind. Informationen zu weiteren Rollen, die Sie möglicherweise zuweisen müssen, finden Sie unter Rollenbasierte Zugriffssteuerung für Microsoft Foundry.

Important

Die Foundry-RBAC-Rollen wurden kürzlich umbenannt. Foundry User, Foundry Owner, Foundry Account Owner und Foundry Project Manager wurden zuvor Azure KI-Benutzer, Azure KI-Besitzer, Azure KI-Kontobesitzer und Azure AI Project Manager benannt. Möglicherweise werden die vorherigen Namen an einigen Stellen weiterhin angezeigt, während der Umbenennungsrollout ausgeführt wird. Die Rollen-IDs und Kernberechtigungen bleiben durch die Umbenennung unverändert.

  1. Rufen Sie die Ressourcen-ID des Projekts ab:

    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. Weisen Sie einem Teammitglied die Rolle " Foundry User " zu:

    Important

    Die Foundry-RBAC-Rollen wurden kürzlich umbenannt. Foundry User, Foundry Owner, Foundry Account Owner und Foundry Project Manager wurden zuvor Azure KI-Benutzer, Azure KI-Besitzer, Azure KI-Kontobesitzer und Azure AI Project Manager benannt. Möglicherweise werden die vorherigen Namen an einigen Stellen weiterhin angezeigt, während der Umbenennungsrollout ausgeführt wird. Die Rollen-IDs und Kernberechtigungen bleiben durch die Umbenennung unverändert.

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

Note

Da die Rollen "Foundry RBAC" kürzlich umbenannt wurden, verwenden Sie die Rollendefinitions-ID (GUID) anstelle des Rollennamens in Ihrem Code, um Probleme während des Umbenennungsrollouts zu vermeiden:

  • Foundry-Benutzer: 53ca6127-db72-4b80-b1b0-d745d6d5456d
  • Eigentümer der Gießerei: c883944f-8b7b-4483-af10-35834be79c4a
  • Besitzer des Foundry-Kontos: e47c6f54-e4a2-4754-9501-8e0985b135e1
  • Foundry Project Manager: eadc314b-1a2d-4efa-be10-5d325db5065e

So fügen Sie eine Sicherheitsgruppe anstelle eines einzelnen Benutzers hinzu:

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. Überprüfen Sie die Rollenzuweisung:

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

Referenz: az role assignment

Überprüfen des Zugriffs von Teammitgliedern

Bitten Sie ein Teammitglied, ihren Zugriff zu überprüfen, indem Sie sich bei Microsoft Foundry anmelden und das Projekt aus der Projektliste auswählen.

Wenn das Teammitglied nicht auf das Projekt zugreifen kann, überprüfen Sie, ob die Rollenzuweisung erfolgreich abgeschlossen wurde. Überprüfen Sie, ob Sie die richtige E-Mail-Adresse oder Sicherheitsgruppen-ID verwendet haben. Stellen Sie sicher, dass sich das Azure Konto des Teammitglieds im selben Microsoft Entra Mandanten befindet.

Um zu bestätigen, dass das bereitgestellte Modell verfügbar ist, bitten Sie das Teammitglied, " Erstellen " in der oberen rechten Navigation und dann " Modelle " im linken Bereich auszuwählen.

Bereinigen von Ressourcen

Wenn Sie dieses Projekt nicht mehr benötigen, löschen Sie die Ressourcengruppe, um alle zugeordneten Ressourcen zu löschen.

az group delete --name my-foundry-rg --yes --no-wait

Nächster Schritt

Microsoft Foundry Schnellstart

  • Last updated on