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:
Einrichten Ihrer Entwicklungsumgebung
Führen Sie az login oder az login --use-device-code in Ihrer Umgebung aus, bevor Sie Code ausführen.
Quick-Überprüfung: Überprüfen Sie vor dem Erstellen eines project, ob Das SDK und die Authentifizierung funktionieren, 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.")
Führen Sie die folgenden Schritte aus, um Ihr Python-Skript zu starten:
Installationspakete: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1. 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.
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 in das DefaultAzureCredential ein, die Sie verwenden möchten.
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
Installieren Sie die Azure CLI.
Legen Sie Standardwerte für subscription.
# Set your default subscription
az account set --subscription "{subscription-name}"
Erstellen eines Foundry-Projekts
Diese Schritte bieten eine Möglichkeit, eine neue Azure Ressource mit grundlegenden, standardmäßigen Einstellungen zu erstellen.
Führen Sie die folgenden Schritte aus, um ein Foundry-Projekt zu erstellen:
-
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).
Das Projekt, an dem Sie arbeiten, wird in der oberen linken Ecke angezeigt.
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.
Geben Sie Ihrem project einen Namen, und wählen Sie Create project aus. Oder im nächsten Abschnitt finden Sie erweiterte Optionen.
Erweiterte Optionen
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.
Wählen Sie einen Speicherort aus, oder verwenden Sie die Standardeinstellung. Der Standort ist die Region, in der die project Ressourcen gehostet werden.
Wählen Sie "Erstellen" aus. Der Fortschritt der Ressourcenerstellung wird angezeigt. Das Projekt wird erstellt, wenn der Prozess abgeschlossen ist.
So erstellen Sie ein Foundry-Projekt:
Fügen Sie den folgenden Code hinzu, um ein Foundry-Projekt mithilfe der Variablen und der client-Verbindung aus den 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.
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
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.
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
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
Ü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.
Gießereiprojekte als untergeordnete Azure-Ressourcen können ihre eigenen Zugriffssteuerelemente erhalten, teilen sich jedoch gemeinsame Einstellungen wie Netzwerksicherheit, Bereitstellungen und Azure-Tool-Integration von der ü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:
Das Gießereiportal (neu) zeigt nur das Standard-Projekt für jede Foundry-Ressource an. Sie können nicht mehrere Projekte erstellen oder eines der nicht standardmäßigen Projekte im Foundry(new)-Portal anzeigen.
Während dieser Code einer Ressource zusätzliche Projekte hinzufügen kann, können Sie sie nicht im Findry-Portal (neu) anzeigen. Nur das Standardprojekt für eine Ressource ist im Foundry-Portal (neu) verfügbar.
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": {}
}
)
Während dieser Code einer Ressource zusätzliche Projekte hinzufügen kann, können Sie sie nicht im Findry-Portal (neu) anzeigen. Nur das Standardprojekt für eine Ressource ist im neuen Gießereiportal verfügbar.
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
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.
# 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.
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-foundry-project \
--resource-group my-foundry-rg
Projekte löschen
- 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).
- Wählen Sie in der oberen rechten Navigationsleiste "Bedienen" aus.
- Wählen Sie im linken Bereich "Administrator" aus.
- Wählen Sie Ihr Projekt aus.
- Wählen Sie oben rechts das Papierkorbsymbol aus, um das Projekt zu löschen.
Dieser Code verwendet die Variablen und client connection aus den Voraussetzungen. Erstellen Sie zunächst die Clientverbindung:
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.
Von Bedeutung
Verwenden Sie sie mit Vorsicht. Sie können eine project nach dem Löschen nicht wiederherstellen.
Verwandte Inhalte