Arbeiten mit der Microsoft Foundry für Visual Studio Code-Erweiterung

In diesem Artikel erfahren Sie, wie Sie die Microsoft Foundry für Visual Studio Code-Erweiterung installieren und verwenden. Erstellen Sie Projekte, stellen Sie Modelle aus dem Foundry-Modellkatalog bereit und interagieren Sie mit Modell-Playgrounds aus VS Code heraus.

Von Bedeutung

Die in diesem Artikel markierten Elemente (Vorschau) sind aktuell als öffentliche Vorschau verfügbar. Diese Vorschauversion wird ohne Vereinbarung zum Servicelevel bereitgestellt und sollte nicht für Produktionsworkloads verwendet werden. Manche Features werden möglicherweise nicht unterstützt oder sind nur eingeschränkt verwendbar. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.

Voraussetzungen

• Ein Azure-Abonnement. Erstellen Sie ein kostenloses Konto.
• Visual Studio Code installiert
• Ihr Abonnement muss unter Ihrem Kontingentlimit liegen, um ein neues Modell in diesem Artikel bereitzustellen. Wenn Sie ihr Kontingentlimit bereits erreicht haben, müssen Sie über ein bereitgestelltes Chatmodell verfügen.
• Geeignete RBAC-Berechtigungen zum Erstellen und Verwalten von Foundry-Ressourcen. Weitere Informationen finden Sie unter Rollenbasierte Zugriffssteuerung für Foundry.

Installieren der Erweiterung

Um die Foundry-Funktionen in VS Code zu verwenden, installieren Sie die Foundry für die Visual Studio Code-Erweiterung. Installieren Sie aus dem Visual Studio Code Marketplace oder direkt aus VS Code.

Installieren über den Visual Studio Code-Marketplace

Verwenden Sie den Marketplace, um die Erweiterung zu installieren, ohne vs Code zuerst zu öffnen.

1. Öffnen Sie die Erweiterungsseite "Foundry für Visual Studio Code".
2. Wählen Sie die Schaltfläche Installieren aus.
3. Befolgen Sie die Anweisungen, um die Erweiterung in Visual Studio Code zu installieren.
4. Öffnen Sie nach der Installation Visual Studio Code und überprüfen Sie anhand der Statusmeldungen, ob die Erweiterung erfolgreich installiert wurde.
5. Das Symbol "Foundry" wird in der primären Navigationsleiste auf der linken Seite von VS Code angezeigt.

Installieren aus Visual Studio Code

Alternativ können Sie direkt in der Vs Code-Erweiterungsansicht nach der Erweiterung suchen.

1. Öffnen Sie VS Code.

2. Wählen Sie im linken Bereich Erweiterungen aus.

3. Wählen Sie das Symbol Einstellungen oben rechts im Erweiterungsbereich.

4. Suchen und wählen Sie Foundry aus.

5. Wählen Sie Installieren aus.

6. Nach Abschluss der Installation bestätigt eine Statusmeldung, dass die Erweiterung installiert ist. Das Gießereisymbol wird in der linken Navigationsleiste angezeigt.

Herstellen einer Verbindung mit Ihren Azure-Ressourcen

Melden Sie sich nach der Installation der Erweiterung bei Ihrem Azure-Abonnement an, und öffnen Sie ein Foundry-Projekt, um mit den Modellen, Agents und Spielplätzen zu beginnen.

Hinweis

Verwenden Sie die Befehlspalette, um eine vollständige Liste der in der Erweiterung verfügbaren Features zu erhalten. Wählen Sie F1 aus, um die Befehlspalette zu öffnen und nach Foundry zu suchen. Der folgende Screenshot zeigt einige der verfügbaren Befehle.

Anmelden bei Ihren Ressourcen

Melden Sie sich bei Ihrem Azure-Abonnement an, damit die Erweiterung auf Ihre Foundry-Projekte und bereitgestellten Modelle zugreifen kann.

1. Wählen Sie das Azure-Symbol auf der VS Code-Navigationsleiste aus.

2. Wählen Sie in der Azure-Ressourcenansicht die Option "Bei Azure anmelden" aus.

3. Wählen Sie im Abschnitt "Ressourcen " Ihr Azure-Abonnement und Ihre Ressourcengruppe aus.

4. Wählen Sie "Foundry" aus, und klicken Sie mit der rechten Maustaste auf Ihr Projekt.

5. Wählen Sie "In Foundry Extension öffnen" aus.

   Ihre Foundry-Projektressourcen werden in der Erweiterungsansicht angezeigt, und das Foundry-Symbol wird auf der Navigationsleiste von VS Code angezeigt.

Navigieren in der Erweiterungsschnittstelle

Die Foundry-Erweiterung organisiert Ihren Arbeitsbereich in drei Hauptabschnitten.

Abschnitt	Was es enthält	Wann man es verwenden sollte
Ressourcen	Bereitgestellte Modelle, deklarative Agenten, gehostete Agenten, Verbindungen und Vektorspeicher für Ihr Foundry-Projekt.	Anzeigen und verwalten Ihrer Projektressourcen.
Werkzeuge	Modellkatalog, Modell-Spielplatz, Agent-Playgrounds (remote und lokal), Lokaler Visualisierer und Bereitstellen gehosteter Agenten.	Bereitstellen neuer Modelle, Testaufforderungen und Interaktion mit Agents.
Hilfe und Feedback	Dokumentation, GitHub-Repository, Microsoft-Datenschutzbestimmungen und Communitylinks.	Erhalten Sie Hilfe, oder geben Sie Feedback.

Erstellen eines Projekts

Erstellen Sie ein neues Foundry-Projekt direkt aus der Erweiterung, um Ihre Modelle und Ressourcen zu organisieren.

1. Wählen Sie das Plussymbol neben "Ressourcen " im Abschnitt "Ressourcen " der Erweiterungsansicht "Foundry" aus.

   Sie können entweder eine neue Ressourcengruppe erstellen oder eine vorhandene gruppe auswählen.

2. So erstellen Sie eine neue Ressourcengruppe:

   1. Wählen Sie "Neue Ressourcengruppe erstellen " aus, und drücken Sie die EINGABETASTE.

   2. Geben Sie den Namen der Azure-Ressourcengruppe in das Textfeld " Neue Ressourcengruppe eingeben " ein, und drücken Sie die EINGABETASTE.

   3. Wählen Sie die gewünschte Position aus der Liste der verfügbaren Positionen aus, und drücken Sie die Eingabetaste.

3. So verwenden Sie eine vorhandene Ressourcengruppe:

   • Wählen Sie die Ressourcengruppe aus, die Sie aus der Liste der verfügbaren Ressourcengruppen verwenden möchten, und drücken Sie die EINGABETASTE.

4. Geben Sie den Namen des Foundry-Projekts in das Textfeld " Projektnamen eingeben " ein, und drücken Sie die EINGABETASTE.

Nach der Projektbereitstellung wird ein Popup mit der Meldung Projekt erfolgreich bereitgestellt angezeigt.

Um ein Modell im neu erstellten Projekt bereitzustellen, wählen Sie im Popup die Schaltfläche " Modell bereitstellen " aus. Mit dieser Aktion wird die Modellkatalogseite geöffnet, auf der Sie das gewünschte Modell auswählen können, das bereitgestellt werden soll.

Wechseln des Standardprojekts

Wenn Sie ein Projekt in der Foundry-Erweiterung öffnen, wird dieses Projekt als Standardprojekt festgelegt. So wechseln Sie zu Ihrem Standardprojekt:

1. Klicken Sie mit der rechten Maustaste auf das Foundry-Projekt, und wählen Sie die Option "Standardprojekt wechseln" in Azure-Erweiterung aus.

2. Wählen Sie das Foundry-Projekt aus der Liste der verfügbaren Projekte aus, und drücken Sie die EINGABETASTE.

Das ausgewählte Projekt zeigt jetzt "Standard" nach dem Projektnamen an.

Tipp

Klicken Sie mit der rechten Maustaste auf ihren Projektnamen, um auf den Projektendpunkt oder den Projekt-API-Schlüssel zuzugreifen.

Arbeiten mit Modellen

Mit der Foundry-Erweiterung können Sie Modelle aus dem Foundry-Modellkatalog direkt in VS Code ermitteln, bereitstellen und mit ihnen interagieren.

Durchsuchen des Modellkatalogs

Der Modellkatalog bietet Zugriff auf Modelle von Microsoft, OpenAI, Meta, DeepSeek und anderen Anbietern. Sie können den Modellkatalog auf verschiedene Arten öffnen:

• Führen Sie den Befehl "Foundry: Modellkatalog öffnen " aus der Befehlspalette aus.
• Wählen Sie das Plussymbol neben "Modelle " im Abschnitt "Ressourcen " der Ansicht "Foundry-Erweiterung" aus.
• Wählen Sie den Link "Modellkatalog " im Abschnitt "Tools " der Erweiterungsansicht "Foundry" aus.

Öffnen des Modellkatalogs über die Befehlspalette

Verwenden Sie die Befehlspalette, um den Modellkatalog zu öffnen, ohne in der Erweiterungsansicht zu navigieren.

1. Wählen Sie F1 aus, um die Befehlspalette zu öffnen.

2. Wählen Sie Foundry: Open Model Catalog aus und drücken Sie die Eingabetaste.

3. Die Seite "Modellkatalog " wird geöffnet.

   

4. Filtern Sie den Modellkatalog nach Gehostet von, Publisher, Feature oder Modelltyp mithilfe der Dropdowns oben auf der Seite. Wählen Sie die Umschaltfläche Fine-Tuning-Unterstützung aus, um Modelle zu filtern, die Feinabstimmung unterstützen.

5. Suchen Sie mithilfe der Suchleiste oben in der Mitte der Seite nach einem bestimmten Modell.

Öffnen des Modellkatalogs im Abschnitt "Ressourcen"

Wählen Sie in der Ansicht "Foundry-Erweiterung" das Plussymbol neben "Modelle " aus, um den Modellkatalog zu öffnen.

Tipp

Sie können auch mit der rechten Maustaste auf "Modelle " klicken und " Neues KI-Modell bereitstellen " auswählen, um direkt zum Bereitstellungsablauf zu wechseln.

Öffnen des Modellkatalogs im Abschnitt "Tools"

Doppelklicken Sie im Abschnitt Extras des Ansichtsbereichs der Foundry-Erweiterung auf den Link Modellkatalog.

Bereitstellen eines Modells aus dem Modellkatalog

Nachdem Sie ein Modell im Katalog gefunden haben, stellen Sie es in Ihrem Foundry-Projekt bereit, damit Sie es in Ihren Anwendungen verwenden können.

1. Wählen Sie die Schaltfläche "Bereitstellen " neben dem ausgewählten Modellnamen aus.

2. Die Seite "Modellbereitstellung" wird geöffnet.

3. Geben Sie den Namen der Modellbereitstellung in das Textfeld " Bereitstellungsname eingeben " ein, und drücken Sie die EINGABETASTE.

4. Wählen Sie den Bereitstellungstyp in der Dropdownliste " Bereitstellungstyp " aus.

5. Wählen Sie die Modellversion im Dropdownmenü " Modellversion " aus.

6. (Optional) Passen Sie die Token pro Minute mithilfe des Schiebereglers Token pro Minute an.

7. Wählen Sie in der unteren linken Ecke die Schaltfläche " In Foundry bereitstellen " aus.

8. Wählen Sie im Bestätigungsdialogfeld "Bereitstellen" aus.

9. Nach Abschluss der Bereitstellung wird das Modell anhand des Bereitstellungsnamens im Abschnitt "Modelle " in Ihrem Projekt angezeigt.

Anzeigen und Verwalten von bereitgestellten Modellen

Erweitern Sie den Abschnitt "Modelle " in der Ansicht "Foundry-Erweiterung", um alle bereitgestellten Modelle in Ihrem Projekt anzuzeigen.

Anzeigen von Modellkarteninformationen

Wählen Sie ein bereitgestelltes Modell aus, um ein Panel mit den folgenden Details zu öffnen:

• Bereitstellungsinformationen: Name, Bereitstellungsstatus, Bereitstellungstyp, Ratelimit, Versionsinformationen, Modellname und Modellversion.
• Endpunktinformationen: Ziel-URI-Link, Authentifizierungstyp und Schlüssel.
• Nützliche Links: Codebeispiel-Repository und Lernprogrammlinks für die KI-Anwendungsentwicklung.

Einstellungen für die Modellbereitstellung aktualisieren

So aktualisieren Sie Bereitstellungsoptionen wie z. B. Zugriffsbeschränkungen:

1. Wählen Sie oben rechts auf der Modellkarte die Schaltfläche "Bearbeiten " aus.
2. Aktualisieren Sie die bearbeitbaren Felder.
3. Wählen Sie dann die Schaltfläche Speichern, um die Änderungen zu anzuwenden.

Generieren von Beispielcode für ein Modell

Generieren Sie eine Startcodedatei für Ihr bereitgestelltes Modell, um die Anwendungsentwicklung zu beschleunigen.

1. Klicken Sie mit der rechten Maustaste auf Ihr bereitgestelltes Modell, und wählen Sie "Codedatei öffnen" aus.

2. Wählen Sie Ihr bevorzugtes SDK in der Dropdownliste " Bevorzugtes SDK auswählen " aus.

3. Wählen Sie ihre bevorzugte Sprache in der Dropdownliste " Sprache auswählen " aus.

4. Wählen Sie Ihre bevorzugte Authentifizierungsmethode in der Dropdownliste " Authentifizierungsmethode auswählen " aus.

5. Eine Beispielcodedatei wird auf einer neuen Registerkarte in VS Code geöffnet.

Der folgende Screenshot zeigt ein generiertes Python-Beispiel, das einen synchronen Aufruf der Antwort-API vorgibt:

Interagieren mit Modellen im Playground

Verwenden Sie den Modell-Playground, um interaktiv mit Ihrem bereitgestellten Modell zu chatten, Einstellungen anzupassen und Systemanweisungen zu ändern.

Um den Playground zu öffnen, doppelklicken Sie im Abschnitt "Tools" der Erweiterungsansicht "Foundry" auf den Link "Modell-Playground". Alternativ klicken Sie mit der rechten Maustaste auf Ihr bereitgestelltes Modell, und wählen Sie "Im Playground öffnen" aus.

1. Die Seite "Playground " wird geöffnet.

2. Geben Sie Ihre Eingabeaufforderung ein, und überprüfen Sie die Ausgabe.

3. Wählen Sie " Code anzeigen" in der oberen rechten Ecke aus, um zu sehen, wie Sie programmgesteuert auf die Modellbereitstellung zugreifen.

4. Wählen Sie den Link "Verlauf" oben links im Playground aus, um Ihren Chatverlauf anzuzeigen.

Häufige Probleme beheben

Wenn beim Verwenden der Foundry-Erweiterung Probleme auftreten, überprüfen Sie die folgenden häufigen Probleme:

Thema	Beschluss
Die Erweiterung wird nach der Installation nicht angezeigt.	Starten Sie VS Code neu, und überprüfen Sie, ob die Erweiterung in der Erweiterungsansicht aktiviert ist.
Die Anmeldung schlägt fehl, oder Abonnements werden nicht geladen.	Überprüfen Sie, ob Ihr Azure-Konto über die richtigen Berechtigungen verfügt. Versuchen Sie, sich von der Azure-Ressourcen Ansicht ab- und dann wieder anzumelden.
Fehler bei der Bereitstellung des Modells aufgrund eines Kontingentfehlers	Überprüfen Sie Ihr Abonnementkontingent , und fordern Sie entweder eine Erhöhung oder Löschung nicht verwendeter Bereitstellungen an.

Bereinigen von Ressourcen

Die Azure-Ressourcen, die Sie in diesem Artikel erstellt haben, werden Ihrem Azure-Abonnement in Rechnung gestellt. Wenn Sie nicht erwarten, dass diese Ressourcen in Zukunft benötigt werden, löschen Sie sie, um weitere Gebühren zu vermeiden.

Löschen Ihrer Modelle

1. Aktualisieren Sie in der Navigationsleiste von VS Code die Foundry-Erweiterung. Erweitern Sie im Abschnitt "Ressourcen " den Unterabschnitt "Models ".

2. Klicken Sie mit der rechten Maustaste auf das bereitgestellte Modell, das Sie entfernen möchten, und wählen Sie "Löschen" aus.

Löschen von Azure-Ressourcen

Um die Ressourcengruppe und alle darin enthaltenen Ressourcen zu löschen:

Warnung

Durch das Dauerhafte Löschen einer Ressourcengruppe werden alle darin enthaltenen Ressourcen entfernt, einschließlich Ihres Foundry-Projekts und aller bereitgestellten Modelle. Diese Aktion kann nicht rückgängig gemacht werden.

1. Öffnen Sie das Azure-Portal.
2. Navigieren Sie zu der Ressourcengruppe, die Ihr Foundry-Projekt enthält.
3. Wählen Sie Ressourcengruppe löschen aus und bestätigen Sie den Löschvorgang.

Nächste Schritte

• Erkunden von Foundry-Modellen
• Bereitstellen von Modellen mit Foundry