Werken met de Extensie Microsoft Foundry voor Visual Studio Code (klassiek)

Opmerking

Dit document verwijst naar de Microsoft Foundry-portal (klassiek).

🔍 Bekijk de documentatie van Microsoft Foundry (nieuw) voor meer informatie over de nieuwe portal.

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

Belangrijk

Items die in dit artikel zijn gemarkeerd (preview) zijn momenteel beschikbaar als openbare preview. Deze preview wordt aangeboden zonder een service level agreement en we raden deze niet aan voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Voor meer informatie, zie Aanvullende Gebruiksvoorwaarden voor Microsoft Azure Previews.

Vereiste voorwaarden

• Een Azure-abonnement. Maak gratis een account.
• 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 op rollen gebaseerd toegangsbeheer voor Foundry voor meer informatie.

De extensie installeren

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

Installeren vanuit Visual Studio Code Marketplace

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

1. Open de pagina van de Foundry-extensie voor Visual Studio Code.
2. Selecteer de knop Installeren .
3. Volg de aanwijzingen om de extensie te installeren in Visual Studio Code.
4. Open Visual Studio Code na de installatie 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 modellen, agents 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 heeft tot uw Foundry-projecten en geïmplementeerde modellen.

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

2. Selecteer Aanmelden bij Azure... in de weergave Azure-resources .

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-projectbronnen 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 projectbronnen 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.

Opmerking

Zie Werken met Agent Service in Visual Studio Code voor meer informatie over het werken met agents in de Foundry-extensie.

Een project maken

Maak rechtstreeks vanuit de extensie een nieuw Foundry-project 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 Nieuwe resourcegroep invoeren 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 het Foundry-project in het tekstvak Projectnaam invoeren in en druk op Enter.

Na de projectimplementatie wordt er een pop-up weergegeven met het bericht dat Project is geïmplementeerd.

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

Het standaardproject wijzigen

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

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

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

In het geselecteerde project wordt nu Standaard weergegeven na de projectnaam.

Aanbeveling

Klik met de rechtermuisknop op de naam van uw project om toegang te krijgen tot het projecteindpunt of de project-API-sleutel.

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 toegang tot 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 Gehost op, Publisher, Functie 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 Modellen in uw project.

Geïmplementeerde modellen weergeven en beheren

Vouw de sectie Modellen uit in de weergave Foundry-extensie om alle geïmplementeerde modellen in uw project weer te geven.

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 hebt 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 alle 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

• Werken met agentservice in Visual Studio Code
• Foundry-modellen verkennen
• Modellen implementeren met Foundry