Freigeben über

Schnellstart: Einrichten von Microsoft Foundry-Ressourcen

In dieser Schnellstartanleitung erstellen Sie ein Microsoft Foundry project und stellen ein Modell bereit. Wenn Sie ein Team verwalten, gewähren Sie auch Teammitgliedern access. 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:
    • 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.
  • Wenn Sie das Projekt für ein Team erstellen:
    • Access zu einer Rolle, mit der Sie Rollenzuweisungen ausführen können, z. B. Owner. Weitere Informationen zu Berechtigungen finden Sie unter Role-based access control für Microsoft Foundry.
    • Eine Liste der Benutzer-E-Mail-Adressen oder Microsoft Entra-Sicherheitsgruppen-IDs für Teammitglieder, die access benötigen.

Wählen Sie über die folgenden Registerkarten Ihre bevorzugte Methode 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

Projekt erstellen

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

  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

Bereitstellen eines Modells

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

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini \
    --model-name gpt-4.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-4.1-mini

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

Referenz: az cognitiveservices Konto-Bereitstellung

Abrufen Ihrer Projektverbindungsdetails

Sie benötigen Ihren Projektendpunkt, um eine Verbindung aus dem Code herzustellen. Wenn Sie dieses Projekt für andere 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
  4. Kopieren Sie den Endpunktwert. Sie verwenden diesen Wert in anderen Schnellstarts und Lernprogrammen.

Für Administratoren – access erteilen

Wenn Sie ein Team verwalten, weisen Sie die Azure AI-Benutzer-Rolle Teammitgliedern 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. Weitere Rollen, die Sie möglicherweise zuweisen müssen, finden Sie unter Rollenbasierte Zugriffskontrolle für Microsoft Foundry

  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 Azure AI User zu:

    az role assignment create \
    --role "Azure AI User" \
    --assignee "user@contoso.com" \
    --scope $PROJECT_ID

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

    az role assignment create \
    --role "Azure AI User" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

  3. Überprüfen Sie die Rollenzuweisung:

    az role assignment list \
    --scope $PROJECT_ID \
    --role "Azure AI User" \
    --output table

Referenz: az-Rollenzuweisung

Überprüfung des Zugriffs von Teammitgliedern

Bitten Sie ein Teammitglied, ihren Zugriff zu überprüfen, indem sie sich bei Microsoft Foundry anmelden, das Projekt aus der Projektliste auswählen und bestätigen, dass das bereitgestellte Modell unter Build>Models erscheint.

Wenn das Teammitglied keinen Zugriff auf das Projekt hat, ü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 gleichen Microsoft Entra-Mandanten befindet.

Bereinigen von Ressourcen

Wenn Sie diese project 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