Schnellstart: Einrichten von Microsoft Foundry-Ressourcen

• Installieren Sie die Azure CLI Version 2.80.0 oder höher. Überprüfen Sie Ihre Version mit az version, und führen Sie az upgrade aus, wenn Sie eine neuere Version benötigen.

  Version 2.80.0 hat die az cognitiveservices account project befehle hinzugefügt, die diese Schritte verwenden. Bei einer früheren Version schlagen die Befehle bei unrecognized arguments oder 'project' is misspelled or not recognized by the system fehl.

• Melden Sie sich bei Azure an:

  az login
  

• Zugriff auf das Microsoft Foundry-Portal.

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
   

   Überprüfen Sie, ob die Ressourcengruppe vorhanden ist:

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

   Die Ausgabe zeigt Succeeded an.

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 \
       --assign-identity \
       --allow-project-management true
   

   Verwenden Sie die folgenden Werte:

   Parameter	Purpose
   --assign-identity	Erstellt die verwaltete Identität, die das Projektmanagement erfordert. Ohne diese schlägt die Projekterstellung mit der Fehlermeldung fehl, dass für die Ressource eine verwaltete Identität aktiviert sein muss.
   --allow-project-management	Ermöglicht das Projektmanagement. Sie können diese Einstellung nach dem Erstellen der Ressource nicht mehr ändern.
   --custom-domain	Muss global eindeutig sein. Wenn my-foundry-resource belegt ist, schlägt der Befehl mit CustomDomainInUse fehl. Wählen Sie einen anderen Namen aus, und führen Sie den Befehl erneut aus.

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. Wenn der Befehl mit der Meldung fehlschlägt, dass eine verwaltete Identität aktiviert sein muss, vergewissern Sie sich, dass Sie die Ressource mit --assign-identity erstellt haben.

Referenz: az cognitiveservices account project

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

   • Wenn Dies Ihre erste Verwendung von Foundry ist, werden Sie aufgefordert, ein Projekt zu erstellen oder zu suchen, um den Vorgang fortzusetzen. Wählen Sie im Dropdownmenü "Neues Projekt erstellen " aus.
   • Wenn Sie bereits ein Projekt geladen haben, wählen Sie den Namen in der oberen linken Ecke aus, und wählen Sie dann "Neues Projekt erstellen" aus.

3. Geben Sie einen Projektnamen ein, z. B. my-foundry-project.

4. Wählen Sie "Erweiterte Optionen" aus, um die Ressourcengruppe und den Speicherort zu konfigurieren:

   • Ressourcengruppe: Erstellen Sie eine neue Ressourcengruppe, oder wählen Sie eine vorhandene Gruppe aus. Wenn Sie eine neue Ressourcengruppe erstellen, können Sie das Projekt und alle zugehörigen Ressourcen einfacher verwalten.
   • Standort: Wählen Sie die Region aus, die Ihrem Team am nächsten kommt.

5. Wählen Sie "Projekt erstellen" aus.

   Warten Sie, bis das Projekt erstellt wurde. Wenn die Projektübersichtsseite angezeigt wird, ist Ihr Projekt bereit.

1. Auflisten der in Ihrer Region verfügbaren Modelle, damit Sie den Modellnamen und die Version bestätigen können:

   az cognitiveservices model list \
       --location eastus \
       --query "[?model.name=='gpt-5-mini'].{version:model.version,skus:join(',',model.skus[].name)}" \
       --output table
   

2. Bereitstellen des Modells:

   az cognitiveservices account deployment create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --model-name gpt-5-mini \
       --model-version "2025-08-07" \
       --model-format OpenAI \
       --sku-capacity 10 \
       --sku-name GlobalStandard
   

   Wenn der Befehl mit DeploymentModelNotSupported fehlschlägt, ist das Modell, die Version oder die SKU in Ihrer Region nicht verfügbar. Verwenden Sie die Ausgabe des vorherigen Schritts, um eine unterstützte Kombination auszuwählen.

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

   Die Ausgabe zeigt Succeeded an, wenn die Bereitstellung bereit ist.

Referenz: az cognitiveservices account deployment

1. Wählen Sie " Entdecken" in der oberen rechten Navigation und dann " Modelle " im linken Bereich aus.
2. Suchen Sie nach gpt-5-mini.
3. Wählen Sie Bereitstellen>Standardeinstellungen aus, um dies zu Ihrem Projekt hinzuzufügen.
4. Notieren Sie sich den Bereitstellungsnamen (z. B. gpt-5-mini). Ihr Team benötigt diesen Namen, um das Modell zu verwenden.

Rufen Sie den Projektendpunkt ab:

az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project \
    --query 'properties.endpoints."AI Foundry API"' --output tsv

Die Ausgabe ist der Endpunkt Ihres Projekts im Format https://my-foundry-resource.services.ai.azure.com/api/projects/my-foundry-project. Verwenden Sie diesen Wert in anderen Schnellstarts und Lernprogrammen.

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.
4. Kopieren Sie den Endpunktwert. Sie verwenden diesen Wert in anderen Schnellstarts und Lernprogrammen.

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" \
       --assignee-principal-type User \
       --scope $PROJECT_ID
   

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

1. Wählen Sie im Findry-Portal in der oberen rechten Navigationsleiste "Verwalten" aus.
2. Wählen Sie Project Details im linken Bereich aus.
3. Wählen Sie die Registerkarte Benutzer aus.
4. Wählen Sie oben rechts "Benutzer hinzufügen" aus.
5. Geben Sie die E-Mail-Adresse des Teammitglieds ein.
6. Wählen Sie "Hinzufügen" aus.

Wiederholen Sie diese Schritte für jedes Teammitglied oder jede Sicherheitsgruppe.

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

Das Löschen wird im Hintergrund ausgeführt. Führen Sie Folgendes aus, um zu bestätigen, dass die Ressourcengruppe nicht mehr vorhanden ist:

az group exists --name my-foundry-rg

Die Ausgabe zeigt false an, wenn der Löschvorgang abgeschlossen ist.

Suchen Sie im portal Azure Ihre Ressourcengruppe, und wählen Sie sie aus. Wählen Sie "Löschen" aus, und bestätigen Sie, dass die Ressourcengruppe und alle zugehörigen Ressourcen gelöscht werden sollen.