Migrieren von hubbasierten zu Foundry-Projekten (klassisch)

Gilt nur für:klassisches Foundry Portal. Dieser Artikel ist für das neue Foundry-Portal nicht verfügbar. Erfahren Sie mehr über das neue Portal.

Was Sie tun werden: Erstellen Sie ein neues Foundry-Projekt und migrieren Sie optional Ihre Agents und Verbindungen aus hubbasierten Projekten.

Zeitschätzung: 5 bis 10 Minuten.

Voraussetzungen:

• Ein vorhandenes hubbasiertes Projekt
• Azure-Rolle: Owner-Rolle für das Abonnement oder die Ressourcengruppe, um Ressourcen und Projekte zu erstellen und dem neuen Projekt Rollen zuzuweisen.

Dieses Handbuch hilft bestehenden Kunden mit Hub-basierten Projekten bei der Migration zu den neuen Foundry-Projekten, um die neuesten Plattformfunktionen nutzen zu können.

Microsoft Foundry wechselt zu einer einheitlichen Plattform als Dienst, wobei das vorherige Ressourcenmodell ersetzt wird, das die Verwaltung mehrerer Azure-Dienste erfordert. Da KI-Workloads komplexer werden, wird das Foundry-Projekt:

• Vereinfacht die Plattformeinrichtung und Governance
• Verbessert Workflows, die sich über mehrere Modelle und Foundry-Tools erstrecken
• Stärkung der Governance-Funktionen

Weitere Informationen.

Übersicht über neue Foundry-Projekte

Gießereiprojekte vereinheitlichen und vereinfachen die Zusammensetzung von Entwicklerworkflows und die Verwaltung von Kernbausteinen von KI-Anwendungen. Zu diesen Bausteinen gehören:

• Modelle
• Agenten und deren Tools
• Beobachtbarkeit, Sicherheit und Vertrauen

Zuvor benötigten die Funktionen des Foundry-Projekts die Verwaltung mehrerer Azure-Ressourcen und SDKs für Workflows im Back-End, um diese Komponenten zu verfassen.

Zu den neuen Funktionen gehören:

• Zugriff auf die Foundry-API , die entwickelt wurde, um API-erste agentische Anwendungen zu erstellen und auszuwerten, die Agents, Auswertungen, Modelle Indizes, Daten in einer einheitlichen Erfahrung und mit einem konsistenten Vertrag über Modellanbieter hinweg verfassen.

• Microsoft Foundry SDK umschließt die Foundry-API, sodass Funktionen einfach in Code integriert werden können, unabhängig davon, ob Ihre Anwendung in Python, C#, JavaScript/TypeScript oder Java integriert ist.

• Agents, Modelle und Toolsing-Verbindungen werden zusammen in Foundry für die Berechtigungsverwaltung, Netzwerk, Kostenanalyse und Richtlinienkonfiguration verwaltet. Zuvor wurden auf bestimmte Tools und Modelle über den Hub Azure Machine Learning zugegriffen, was auch die Bereitstellung zusätzlicher Speicher- und Schlüsseltresorressourcen erfordert.

• Projects sind jetzt untergeordnete Ressourcen; ihnen werden möglicherweise eigene Administratorsteuerelemente wie Azure RBAC zugewiesen, aber standardmäßig gemeinsame Einstellungen aus ihrer übergeordneten Ressource freigeben. Dieses Prinzip zielt darauf ab, IT-Administratoren aus der täglichen Schleife zu nehmen. Sobald Sicherheit, Ressourcenkonnektivität und Governance auf Ressourcenebene eingerichtet werden, können Sie als Entwickler Ihr eigenes Projekt als Ordner erstellen, um Ihre Arbeit zu organisieren.

So wechseln Sie zum Foundry-Projekt

Erstellen Sie neue Foundry-Projekte in der Ressource "Foundry models" aus Ihrem hubbasierten Projekt. Dieser Prozess ermöglicht es den neuen Projekten, auf die ursprünglich im Hub-basierten Projekt ausgeführte Arbeit zuzugreifen.

Was wird an Foundry-Projekte übertragen?

• Modellimplementierungen
• Datendateien
• Fein abgestimmte Modelle
• Assistenten
• Vektorspeicher

Was wird nicht übertragen?

• Vorschau des Agent-Status (Nachrichten, Threads, Dateien) – Sie können Ihren Agent neu erstellen, indem Sie Code in Ihrem neuen Projekt verwenden.
• Open-Source-Modellbereitstellungen – Foundry-Projekte unterstützen diese derzeit nicht
• Hubprojektzugriff – Hub-basierte Projekte haben keinen Zugriff auf die neuen Projekte, die in der Ressource "Foundry Models" erstellt wurden.

In den folgenden Abschnitten erfahren Sie, wie Sie von hubbasierten Projekten zu Foundry-Projekten wechseln:

1. Finden Sie Ihre vorhandene Foundry-Ressource
2. Erstellen Sie ein neues Foundry-Projekt für die KI-Ressource.

Nachdem Sie Ihr neues Projekt erstellt haben, können Sie Folgendes ausführen:

• (Optional) Neu erstellen von Verbindungen
• (Optional) Agenten migrieren

Lokalisieren Sie Ihre vorhandene Foundry-Ressource

Die meisten Foundry-Benutzer verfügen bereits über eine Foundry-Ressource (früher AI Services genannt), die sie zuvor zusammen mit ihrem hubbasierten Projekt für den Zugriff auf Modellbereitstellungen erstellt haben.

2. Erstellen Des neuen Projekts

Auf neue Funktionen, einschließlich agent-Dienst, kann nur über Projekte zugegriffen werden. Jedes Projekt organisiert Ihre Entwicklungsarbeit als Ordner für jeden Anwendungsfall. Sie können mehrere Projekte erstellen, um die Arbeit für Anwendungsfälle mit ähnlichen Setup- und Konnektivitätsanforderungen zu organisieren.

Sie können jetzt mit der Erstellung von Agents in der allgemeinen Verfügbarkeit und mit den neuesten Funktionen beginnen. Erste Schritte mit SDK- oder Agent-Playground.

(Optional) Neu erstellen von Verbindungen

Wenn Ihr hubbasiertes Projekt Verbindungen für den Zugriff auf Tools, Datenquellen oder Modelle verwendet hat, können Sie diese Verbindungen auf Ihrer Foundry-Ressource neu erstellen, ohne einen Hub zu verwenden.

(Optional) Code-Agenten migrieren

Um von der Vorschau des Agent-Diensts zum Agent-Dienst in der allgemeinen Verfügbarkeit von Foundry-Projekten zu wechseln, aktualisieren Sie Ihre Code-Agents, indem Sie die folgenden Änderungen vornehmen:

1. Installieren Sie die neueste Version Ihres bevorzugten SDK-Clients.

2. Aktualisieren Sie Ihren Projektclient, um die Foundry-API zu verwenden. Statt einer Verbindungszeichenfolge verwenden Sie jetzt den Foundry-Projektendpunkt. Beispiel: in Python:

   from azure.identity import DefaultAzureCredential
   from azure.ai.projects import AIProjectClient
   
   project = AIProjectClient(
     endpoint="your_project_endpoint",  # Replace with your endpoint
     credential=DefaultAzureCredential())
   

   Dieser Codeausschnitt authentifiziert sich bei Ihrem Foundry-Projekt mithilfe der Azure Identitätsbibliothek und erstellt eine Projektclientinstanz. Der endpoint ist Ihr Foundry-Projektendpunkt; die DefaultAzureCredential verwendet Ihre Azure Anmeldeinformationen für die Authentifizierung.

   Referenz: AIProjectClient, DefaultAzureCredential, SDK-Migrationshandbuch

3. Aktualisieren Sie Ihr Skript so, dass alle Klassenstrukturänderungen zwischen den Vorschau- und stabilen SDK-Paketen widerzuspiegeln sind.

Weitere Informationen finden Sie im Migrationshandbuch SDK.

(Optional) Bereinigen von Hub-basierten Projekten

Wenn Sie keinen Zugriff mehr auf Ihre hubbasierten Projekte benötigen, löschen Sie sie aus Ihrem Azure-Abonnement.

Möglicherweise möchten Sie Hubs und hubbasierte Projekte aus einigen Gründen in Ihrem Abonnement beibehalten:

• Zugriff auf ausgewählte Features, die in Foundry-Projekten noch nicht unterstützt werden. Siehe diese Supportmatrix.

• Anwendungsfälle, die sich auf das Training von benutzerdefinierten Modellen für maschinelles Lernen konzentrieren. Ein hubbasiertes Projekt basiert auf dem Azure Machine Learning Stapel und bleibt über Azure Machine Learning Studio, CLI oder SDK zugänglich.

Weitere Informationen

• Einführung von Foundry in meiner Organisation

• Beispiel-Bicep-Vorlagen

• Beispiel für Terraform-Vorlagen

• SDK-Migrationshandbuch