Werken met de Microsoft Foundry voor Visual Studio Code-extensie

In dit artikel leert u hoe u de Microsoft Foundry voor Visual Studio Code-extensie installeert en gebruikt. Maak projecten, implementeer modellen uit de Foundry-modelcatalogus en communiceer met modelspeeltuinen vanuit VS Code.

Vereiste voorwaarden

• Een Azure-abonnement. Maak er gratis een.
• Visual Studio Code geïnstalleerd.
• Uw abonnement moet onder uw quotumlimiet staan om een nieuw model in dit artikel te implementeren. Als u de quotumlimiet al hebt bereikt, moet u een geïmplementeerd chatmodel hebben.
• De juiste RBAC-machtigingen voor het maken en beheren van Foundry-resources. Zie Role-gebaseerd toegangsbeheer voor Foundry voor meer informatie.

De extensie installeren

Als u Foundry-mogelijkheden in VS Code wilt gebruiken, installeert u de Foundry voor Visual Studio Code-extensie. Installeer vanuit de Visual Studio Code Marketplace of rechtstreeks vanuit VS Code.

Installeren vanuit de Visual Studio Code Marketplace

Gebruik de marketplace om de extensie te installeren zonder VS Code eerst te openen.

1. Open de Foundry-extensiepagina voor Visual Studio Code.
2. Selecteer de knop Installeren .
3. Volg de aanwijzingen om de extensie te installeren in Visual Studio Code.
4. Open na de installatie Visual Studio Code en controleer of de extensie is geïnstalleerd vanuit de statusberichten.
5. Het pictogram Foundry wordt weergegeven in de primaire navigatiebalk aan de linkerkant van VS Code.

Installeren vanuit Visual Studio Code

U kunt ook rechtstreeks vanuit de weergave VS Code-extensies naar de extensie zoeken.

1. Open VS Code.

2. Selecteer Extensies in het linkerdeelvenster.

3. Selecteer het pictogram Instellingen in de rechterbovenhoek van het deelvenster Extensies.

4. Zoek en selecteer Foundry.

5. Selecteer Installeren.

6. Nadat de installatie is voltooid, bevestigt een statusbericht dat de extensie is geïnstalleerd. Het pictogram Foundry wordt weergegeven in de linkernavigatiebalk.

Verbinding maken met uw Azure-resources

Nadat u de extensie hebt geïnstalleerd, meldt u zich aan bij uw Azure-abonnement en opent u een Foundry-project om te beginnen met het werken met modellen, agenten en speeltuinen.

Opmerking

Gebruik het opdrachtenpalet voor een volledige lijst met functies die beschikbaar zijn in de extensie. Selecteer F1 om het opdrachtenpalet te openen en in Foundry te zoeken. In de volgende schermopname ziet u enkele van de beschikbare opdrachten.

Aanmelden bij uw resources

Meld u aan bij uw Azure-abonnement, zodat de extensie toegang kan verkrijgen tot uw Foundry-projecten en geïmplementeerde modellen.

1. Selecteer het pictogram Azure op de navigatiebalk van VS Code.

2. Selecteer Meld je aan bij Azure... in de weergave Azure-bronnen.

3. Selecteer in de sectie Resources uw Azure-abonnement en resourcegroep.

4. Selecteer Foundry en klik met de rechtermuisknop op uw project.

5. Selecteer Openen in Foundry-extensie.

   Uw Foundry-project-resources worden weergegeven in de extensieweergave en het foundry-pictogram wordt weergegeven op de navigatiebalk van VS Code.

Navigeren in de extensie-interface

De Foundry-extensie organiseert uw werkruimte in drie hoofdsecties.

Afdeling	Wat het bevat	Wanneer gebruikt u het?
Middelen	Geïmplementeerde modellen, declaratieve agents, gehoste agents, verbindingen en vectorarchieven voor uw Foundry-project.	Uw project-resources weergeven en beheren.
Gereedschappen	Modelcatalogus, Model Playground, Agent Playgrounds (extern en lokaal), Local Visualizer en Deploy Hosted Agents.	Implementeer nieuwe modellen, testprompts en communiceer met agents.
Help en Feedback	Documentatie, GitHub opslagplaats, Microsoft-privacyverklaring en communitykoppelingen.	Hulp vragen of feedback geven.

Een project maken

Maak een nieuwe Foundry-project rechtstreeks vanuit de extensie om uw modellen en resources te organiseren.

1. Selecteer het pluspictogram naast Resources in de sectie Resources van de weergave Foundry-extensie.

   U kunt een nieuwe resourcegroep maken of een bestaande resourcegroep selecteren.

2. Een nieuwe resourcegroep maken:

   1. Selecteer Nieuwe resourcegroep maken en druk op Enter.

   2. Voer de naam van de Azure resourcegroep in het tekstvak Enter new resource group in en druk op Enter.

   3. Selecteer de locatie die u wilt gebruiken in de lijst met beschikbare locaties en druk op Enter.

3. Een bestaande resourcegroep gebruiken:

   • Selecteer de resourcegroep die u wilt gebruiken in de lijst met beschikbare resourcegroepen en druk op Enter.

4. Voer de naam van de Foundry-project in het tekstvak Enter project naam in en druk op Enter.

Na project implementatie wordt er een pop-up weergegeven met het bericht Project geïmplementeerd.

Als u een model wilt implementeren in de zojuist gemaakte project, selecteert u de knop Een model implementeren in de pop-up. Met deze actie wordt de pagina Modelcatalogus geopend, waar u het gewenste model kunt selecteren dat u wilt implementeren.

De standaard-project wijzigen

Wanneer u een project opent in de Foundry-extensie, wordt die project ingesteld als uw standaard-project. Uw standaard-project wijzigen:

1. Klik met de rechtermuisknop op het Foundry-project en selecteer de Switch Default Project in Azure Extension optie.

2. Selecteer de Foundry-project die u wilt gebruiken in de lijst met beschikbare projecten en druk op Enter.

In het geselecteerde project wordt nu Default weergegeven na de naam van het project.

Aanbeveling

Klik met de rechtermuisknop op de naam van uw project om het project-eindpunt of de project API-sleutel te access.

Werken met modellen

Met de Foundry-extensie kunt u modellen uit de Foundry-modelcatalogus rechtstreeks in VS Code detecteren, implementeren en ermee werken.

Bladeren in de modelcatalogus

De modelcatalogus biedt access aan modellen van Microsoft, OpenAI, Meta, DeepSeek en andere providers. U kunt de modelcatalogus op verschillende manieren openen:

• Voer de opdracht Foundry: Open Model Catalog vanuit het opdrachtpalet.
• Selecteer het pluspictogram naast Modellen in de sectie Resources van de weergave Foundry-extensie.
• Selecteer de koppeling Modelcatalogus in het Tools-gedeelte van de Foundry-extensieweergave.

Open de modelcatalogus vanuit het opdrachtpalet

Gebruik het opdrachtpalet om de modelcatalogus te openen zonder door de extensieweergave te navigeren.

1. Selecteer F1 om het opdrachtpalet te openen.

2. Enter Foundry: Open Model Catalog en druk op Enter.

3. De pagina Modelcatalogus wordt geopend.

   

4. Filter de Modelcatalogus op Hosted by, Publisher, Feature of Modeltype met behulp van de vervolgkeuzelijsten boven aan de pagina. Selecteer de Fine-Tuning Ondersteuning wisselknop om modellen te filteren die ondersteuning bieden voor het fijn afstemmen.

5. Zoek naar een specifiek model met behulp van de zoekbalk bovenaan de pagina.

Open de modelcatalogus vanuit de sectie Resources

Selecteer in de weergave Foundry-extensie het pluspictogram naast Modellen om de modelcatalogus te openen.

Aanbeveling

U kunt ook met de rechtermuisknop op Modellen klikken en nieuw AI-model implementeren selecteren om rechtstreeks naar de implementatiestroom te gaan.

Open de modelcatalogus vanuit de sectie Hulpmiddelen

Dubbelklik in de sectie Extra van de weergave van de Foundry-extensie op de koppeling Modelcatalogus.

Een model implementeren vanuit de modelcatalogus

Nadat u een model in de catalogus hebt gevonden, implementeert u het in uw Foundry-project zodat u het in uw toepassingen kunt gebruiken.

1. Selecteer de knop Implementeren naast de naam van het geselecteerde model.

2. De pagina Modelimplementatie wordt geopend.

3. Voer de naam van de modelimplementatie in het tekstvak Implementatienaam invoeren in en druk op Enter.

4. Selecteer het implementatietype in de vervolgkeuzelijst Implementatietype .

5. Selecteer de modelversie in de vervolgkeuzelijst Modelversie .

6. (Optioneel) Pas de tokens per minuut aan met behulp van de schuifregelaar Tokens per minuut .

7. Selecteer de knop Implementeren in Foundry in de linkerbenedenhoek.

8. Selecteer Implementeren in het bevestigingsvenster.

9. Nadat de implementatie is voltooid, wordt het model weergegeven op implementatienaam onder de sectie Models in uw project.

Geïmplementeerde modellen weergeven en beheren

Vouw de sectie Models uit in de weergave Foundry-extensie om alle geïmplementeerde modellen in uw project te zien.

Modelkaartgegevens weergeven

Selecteer een geïmplementeerd model om een deelvenster te openen met de volgende details:

• Implementatiegegevens: naam, inrichtingsstatus, implementatietype, frequentielimiet, versiegegevens, modelnaam en modelversie.
• Eindpuntgegevens: doel-URI-koppeling, verificatietype en sleutel.
• Nuttige koppelingen: Codevoorbeeldopslagplaats en zelfstudiekoppelingen voor het ontwikkelen van AI-toepassingen.

Implementatie-instellingen van model bijwerken

Implementatie-instellingen, zoals frequentielimieten, bijwerken:

1. Selecteer de knop Bewerken in de rechterbovenhoek van de modelkaart.
2. Werk de bewerkbare velden bij.
3. Selecteer de knop Opslaan om de wijzigingen toe te passen.

Voorbeeldcode genereren voor een model

Genereer een starterscodebestand voor uw geïmplementeerde model om de ontwikkeling van toepassingen te versnellen.

1. Klik met de rechtermuisknop op het geïmplementeerde model en selecteer Codebestand openen.

2. Selecteer uw voorkeurs-SDK in de vervolgkeuzelijst Choose preferred SDK .

3. Selecteer uw voorkeurstaal in de vervolgkeuzelijst Taal kiezen .

4. Selecteer uw voorkeursverificatiemethode in de vervolgkeuzelijst Verificatiemethode kiezen .

5. Er wordt een voorbeeldcodebestand geopend op een nieuw tabblad in VS Code.

In de volgende schermopname ziet u een gegenereerd Python-voorbeeld dat een synchrone aanroep naar de antwoord-API maakt:

Interactie met modellen in de speeltuin

Gebruik de modelspeeltuin om interactief te chatten met uw geïmplementeerde model, instellingen aan te passen en systeeminstructies te wijzigen.

Als u de speeltuin wilt openen, dubbelklikt u op de koppeling Modelspeeltuin in de sectie Extra van de weergave Foundry-extensie. U kunt ook met de rechtermuisknop op uw geïmplementeerde model klikken en Openen in Playground selecteren.

1. De pagina Speeltuin wordt geopend.

2. Typ uw prompt en controleer de uitvoer.

3. Selecteer Code weergeven in de rechterbovenhoek om te zien hoe u programmatisch toegang krijgt tot de modelimplementatie.

4. Selecteer de koppeling Geschiedenis linksboven in de speeltuin om uw chatgeschiedenis weer te geven.

Veelvoorkomende problemen oplossen

Als u problemen ondervindt tijdens het gebruik van de Foundry-extensie, controleert u de volgende veelvoorkomende problemen:

Probleem	Resolutie / Besluit
De extensie wordt niet weergegeven na de installatie	Start VS Code opnieuw en controleer of de extensie is ingeschakeld in de weergave Extensies .
Aanmelden mislukt of abonnementen worden niet geladen	Controleer of uw Azure-account over de juiste machtigingen beschikt. Meld u af en meld u opnieuw aan vanuit de weergave Azure Resources.
Modelimplementatie mislukt met een quotumfout	Controleer uw abonnementsquotum en vraag een verhoging aan of verwijder ongebruikte implementaties.

De hulpbronnen opschonen

De Azure resources die u in dit artikel hebt gemaakt, worden gefactureerd voor uw Azure-abonnement. Als u deze resources in de toekomst niet meer nodig hebt, verwijdert u deze om te voorkomen dat er meer kosten in rekening worden gebracht.

Uw modellen verwijderen

1. Vernieuw de Foundry-extensie in de navigatiebalk van VS Code. Vouw in de sectie Resources de subsectie Modellen uit.

2. Klik met de rechtermuisknop op het geïmplementeerde model dat u wilt verwijderen en selecteer Verwijderen.

Azure resources verwijderen

Om de resourcegroep en alle resources binnenin te verwijderen, volgt u deze stappen:

Waarschuwing

Als u een resourcegroep verwijdert, worden alle resources daarin definitief verwijderd, inclusief uw Foundry-project en geïmplementeerde modellen. Deze actie kan niet ongedaan worden gemaakt.

1. Open het Azure-portaal.
2. Navigeer naar de resourcegroep die uw Foundry-project bevat.
3. Selecteer Resourcegroep verwijderen en bevestig de verwijdering.

Volgende stappen

• Foundry-modellen verkennen
• Modellen implementeren met Foundry