Delen via

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

Microsoft Foundry biedt een geïntegreerd platform voor zakelijke AI-bewerkingen, modelbouwers en toepassingsontwikkeling. Deze basis combineert infrastructuur op productieniveau met vriendelijke interfaces, zodat organisaties AI-toepassingen met vertrouwen kunnen bouwen en gebruiken.

Met Foundry kunt u het volgende doen:

  • Implementeer de nieuwste taalmodellen van Microsoft, OpenAI, Meta, DeepSeek en meer met behulp van de robuuste modelcatalogus

  • De geïmplementeerde modellen testen in een modelspeeltuin

  • Snel aan de slag met het ontwikkelen van generatieve AI-toepassingen met behulp van een verzameling gecureerde codesjablonen in Azure

  • Agents configureren en implementeren met Foundry Agent Service

Met de Foundry for Visual Studio Code-extensie kunt u veel van deze werkstroom rechtstreeks vanuit Visual Studio Code uitvoeren. Het wordt ook geleverd met andere functies, zoals codesjablonen, speeltuinen en integratie met andere VS Code-extensies en -functies.

In dit artikel leest u hoe u snel aan de slag kunt met de functies van de Foundry for Visual Studio Code-extensie.

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. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor meer informatie.

Vereiste voorwaarden

Voordat u de Foundry voor Visual Studio Code-extensie gebruikt, moet u het volgende doen:

Installatie

Nadat u Visual Studio Code hebt geïnstalleerd, moet u de Foundry for Visual Studio Code-extensie installeren.

Als u de Foundry for Visual Studio Code-extensie wilt installeren, kunt u de Visual Studio Code Marketplace gebruiken of deze rechtstreeks vanuit Visual Studio Code installeren.

Installeren vanuit Visual Studio Code Marketplace

Voer de volgende stappen uit om de Foundry for Visual Studio Code-extensie te installeren vanuit Visual Studio Code Marketplace:

  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. De extensie moet nu zichtbaar zijn in de primaire navigatiebalk aan de linkerkant van Visual Studio Code.

Installeren vanuit Visual Studio Code

Voer de volgende stappen uit om de Foundry for Visual Studio Code-extensie te installeren in Visual Studio Code:

  1. Open Visual Studio 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. Controleer aan de hand van de statusberichten of de extensie met succes is geïnstalleerd.

Aan de slag

Ga aan de slag met de Foundry-extensie met behulp van de volgende stappen.

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 acties voor Foundry. Een schermopname van het Opdrachtenpalet van Visual Studio Code voor Foundry.

Aanmelden bij uw resources

Meld u aan bij uw Azure-abonnement om toegang te krijgen tot uw resources met de volgende stappen:

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

  2. Meld u aan door het Sign in to Azure... item te selecteren in de Azure Resources-weergave.

    Een schermopname van de optie Aanmelden bij Azure.

  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.

    Een schermopname van de optie Openen in Foundry Extension.

De Foundry-extensie verkennen

De Foundry-extensie wordt geopend in een eigen weergave, waarbij het Foundry-pictogram nu wordt weergegeven op de navigatiebalk van VS Code. De extensie heeft drie hoofdsecties: Resources, Hulpprogramma's en Help en Feedback.

Een schermopname van de Foundry-extensie met gemarkeerde secties.

  • Resources: Deze sectie bevat de resources waartoe u toegang heeft in uw Foundry-project. De sectie Resources is de hoofdweergave voor interactie met uw Foundry Services. Deze bevat de volgende subsecties:

    • Modellen: deze sectie bevat de modellen die u kunt gebruiken om uw AI-toepassingen te bouwen en te implementeren. In de weergave Modellen vindt u de geïmplementeerde modellen in uw Foundry-project.
    • Agents: deze sectie bevat uw geïmplementeerde agents in uw Foundry-project.
    • Assets: deze sectie bevat de assets die u in uw Foundry-project hebt.
      • Verbindingen: deze subsectie bevat de verbindingen die u in uw Foundry-project hebt. Bijvoorbeeld Bing Grounding-verbindingen.
      • Vector Stores: Deze subsectie bevat de vectorarchieven die u in uw Foundry-project hebt.
    • Threads: deze sectie bevat de threads en wordt uitgevoerd vanuit een geïmplementeerde agent in uw Foundry-project.

  • Hulpprogramma's: deze sectie bevat de hulpprogramma's die u kunt gebruiken om uw AI-toepassingen te bouwen en te implementeren. In de weergave Hulpprogramma's vindt u de hulpprogramma's die beschikbaar zijn om te implementeren en vervolgens te werken met uw geïmplementeerde modellen en agents. Deze bevat de volgende subsecties:

    • Modelcatalogus: de koppeling naar de modelcatalogus die u kunt gebruiken om modellen te detecteren en te implementeren.
    • Modelspeeltuin: de koppeling naar de modelspeeltuin voor interactie met uw geïmplementeerde modellen in uw Foundry-project.
    • Agent Playground: de koppeling naar de agentspeelplaats voor interactie met uw geïmplementeerde agents in uw Foundry-project.

  • Help en feedback: deze sectie bevat koppelingen naar de Foundry-documentatie, feedback, ondersteuning en de Privacyverklaring van Microsoft. Deze bevat de volgende subsecties:

    • Documentatie: De koppeling naar de Documentatie voor de Foundry-extensie.
    • GitHub: de koppeling naar de GitHub-opslagplaats van de Foundry-extensie.
    • Privacyverklaring van Microsoft: de koppeling naar de Privacyverklaring van Microsoft.
    • Neem deel aan de Foundry Community: Discord + Forum: De koppeling naar de Foundry community Discord-server.

Opmerking

Zie het artikel Work with Agent Service in Visual Studio Code voor meer informatie over het werken met agents en threads in de Foundry-extensie.

Een project maken

U kunt een nieuw Foundry-project maken vanuit de weergave Foundry Extension met de volgende stappen:

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

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

  2. Een nieuwe resourcegroep maken:

    1. Selecteer in het bovenste midden Nieuwe resourcegroep maken en druk op Enter.

      Schermopname van de vervolgkeuzelijst Resourcegroep kiezen met het item Nieuwe resourcegroep maken gemarkeerd.

    2. Voer in het bovenste midden de naam van de Azure-resourcegroep in die u wilt gebruiken in het tekstvak Nieuwe resourcegroep invoeren en druk op Enter.

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

  3. Een bestaande resourcegroep gebruiken:

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

  4. Voer in het bovenste midden de naam van het Foundry-project in die u wilt gebruiken in het tekstvak Projectnaam invoeren en druk op Enter.

    Schermopname van het tekstvak Projectnaam invoeren.

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

Een schermopname van het pop-upvenster Project succesvol geïmplementeerd met de knop Een model implementeren gemarkeerd.

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 opent u de pagina Modelcatalogus in de weergave Foundry Extension om het gewenste model te selecteren dat u wilt implementeren.

Het standaard Foundry-project

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

Wijzig uw standaardproject door de volgende stappen te volgen:

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

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

Het geselecteerde project zal nu na de projectnaam Standaard weergeven.

Een schermopname van het aangewezen standaardproject.

Werken met modellen

Met de Foundry for Visual Studio Code-extensie kunt u grote taalmodellen maken, gebruiken en implementeren vanuit Visual Studio Code.

Alle modellen verkennen met de modelcatalogus

De modelcatalogus in Foundry Portal is de hub voor het detecteren en gebruiken van een breed scala aan modellen voor het bouwen van generatieve AI-toepassingen.

Toegang tot de modelcatalogus op verschillende manieren:

  • De Foundry: Open Model Catalog opdracht palet opdracht.
  • Selecteer het pluspictogram naast Modellen in de sectie Resources van de weergave Foundry Extension.
  • Selecteer de Modelcatalogus link in de Tools sectie van de Foundry Extension-weergave.

Open de modelcatalogus vanuit het opdrachtpalet

Open de modelcatalogus vanuit het opdrachtpalet om een gecureerde selectie modellen te verkennen en implementeren die beschikbaar zijn in Foundry, rechtstreeks vanuit VS Code.

  1. Selecteer F1 om het opdrachtpalet te openen.

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

  3. De pagina Modelcatalogus wordt weergegeven.

    Schermopname van de pagina **Modelcatalogus** in VS Code.

  4. Filter de modelcatalogus op Publisher en/of Task door de vervolgkeuzelijsten linksboven op de pagina te gebruiken.

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

Open de modelcatalogus vanuit de sectie Resources

De modelcatalogus is ook beschikbaar in de sectie Resources van de weergave Foundry Extension.

Selecteer in de weergave Foundry Extension het plusteken naast Modellen om de Modelcatalogus te openen.

Schermopname van het plusteken naast modellen met de lijst met modellen uitgevouwen.

Hint

U kunt ook met de rechtermuisknop op Modellen klikken en de optie Nieuw AI-model implementeren selecteren om de modelcatalogus te openen om het implementatieproces te starten.

Open de modelcatalogus vanuit de sectie Hulpmiddelen

De modelcatalogus is ook beschikbaar in de sectie Extra van de weergave Foundry Extension. Dubbelklik op de koppeling Modelcatalogus om de modelcatalogus te openen.

Een model implementeren vanuit de modelcatalogus

Implementeer een geselecteerd model in de modelcatalogus met behulp van de volgende stappen:

  1. Selecteer de implementatie in Azure direct na de naam van het geselecteerde model.

    Schermopname van de gemarkeerde koppeling Implementeren in Azure van het geselecteerde model.

  2. De pagina Modelimplementatie wordt weergegeven.

    Schermopname van de pagina **Modelimplementatie** in VS Code.

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

    Schermopname van het tekstvak Implementatienaam invoeren.

  4. Selecteer het implementatietype dat u wilt gebruiken in de vervolgkeuzelijst Implementatietype en druk op Enter.

    Screenshot van de dropdown-menu voor implementatietype.

  5. Selecteer de modelversie die u wilt gebruiken in de vervolgkeuzelijst Modelversie en druk op Enter.

    Schermopname van de keuzelijst Model versie.

  6. (Optioneel) Selecteer de tokens per minuut die u wilt gebruiken in de schuifregelaar Tokens per minuut en druk op Enter.

  7. Selecteer in de linkerbenedenhoek de knop Implementeren in Foundry om het model te implementeren.

  8. Er wordt een bevestigingsdialoogvenster weergegeven. Selecteer de knop Implementeren om het model in uw project te implementeren.

    Schermopname van het bevestigingsdialoogvenster met de knop Implementeren gemarkeerd.

  9. Na een geslaagde implementatie wordt uw model weergegeven op implementatienaam met uw andere geïmplementeerde modellen in de sectie Modellen in uw project.

    Schermopname van het zojuist geïmplementeerde model in de sectie Modellen.

Geïmplementeerde modellen weergeven

Selecteer in de weergave Azure Resources Extension het caret-pictogram voor de sectie Modellen om de lijst met geïmplementeerde modellen weer te geven.

Schermopname van het gemarkeerde caretpictogram naast de subsectie Modellen.

In de sectie Uitgevouwen modellen wordt de lijst met geïmplementeerde modellen weergegeven.

Schermopname van de geïmplementeerde modellen in de subsectie Modellen.

Modelkaartgegevens weergeven

Als u een geïmplementeerd model selecteert, wordt er een deelvenster geopend met basisinformatie:

  • Implementatiegegevens: deze sectie bevat de informatie over het model:
    • Naam
    • Toewijzingsstatus
    • Implementatietype
    • Informatie over tarieflimiet
    • Versiegegevens
    • Modelnaam
    • Modelversie
  • Eindpuntgegevens: deze sectie bevat de doel-URI-koppeling, het verificatietype en de sleutel.
  • Nuttige koppelingen: deze sectie bevat de codevoorbeeldopslagplaats en zelfstudiekoppelingen om aan de slag te gaan met ai-toepassingsontwikkeling.

Een model bijwerken

Als u de gegevens van de modelkaart wilt bijwerken, selecteert u de knop Bewerken in de rechterbovenhoek van de modelkaart.

Schermopname van de modelkaart voor het geselecteerde model met de knop Bewerken gemarkeerd.

Werk de gewenste bewerkbare velden, zoals frequentielimiet, rechtstreeks in VS Code bij.

Schermopname van de modelkaart met bewerkbare velden en de knop Opslaan gemarkeerd.

Als u de wijzigingen wilt opslaan, selecteert u de knop Opslaan in de rechterbovenhoek van de modelkaart.

De voorbeeldcode van het model verkennen

Maak een voorbeeldcodebestand met behulp van de volgende stappen.

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

    Schermopname van het contextmenu van het model met de optie Open Code-bestand gemarkeerd.

  2. Selecteer in het bovenste midden de gewenste SDK die u wilt gebruiken in de vervolgkeuzelijst Choose preferred SDK en druk op Enter.

    Schermopname van de vervolgkeuzelijst Choose preferred SDK voor het selecteren van modelcodebestanden.

  3. Selecteer in het bovenste midden de gewenste taal die u wilt gebruiken in de vervolgkeuzelijst Taal kiezen en druk op Enter.

    Schermopname van de vervolgkeuzelijst Taal kiezen voor selectie van modelcodebestanden.

  4. Selecteer in het bovenste midden de gewenste verificatiemethode die u wilt gebruiken in de vervolgkeuzelijst Verificatiemethode kiezen en druk op Enter.

    Schermopname van de vervolgkeuzelijst voor het kiezen van een verificatiemethode bij het selecteren van een modelcodebestand.

Voorbeeldcodebestand

Dit Python-voorbeeldcodebestand dat een eenvoudige aanroep van de voltooiings-API voor chats demonstreert. De aanroep is synchroon:

Schermopname van het gegenereerde voorbeeldcodebestand.

Interactie met modellen met behulp van een modelspeeltuin

Chat interactief met het model, wijzig instellingen en systeeminstructies met behulp van de modelspeeltuin.

De modelspeeltuin is beschikbaar in de sectie Extra van de weergave Foundry Extension. Dubbelklik op de koppeling Modelspeeltuin om de modelspeeltuin te openen.

U kunt de modelspeeltuin ook openen met behulp van de volgende stappen:

  1. Klik met de rechtermuisknop op het geïmplementeerde model en selecteer de optie Openen in speeltuin .

    Schermopname van het contextmenu van het model met de optie Openen in speeltuin gemarkeerd.

  2. De pagina Speeltuin wordt weergegeven.

    Schermopname van de pagina **Playground** in VS Code.

  3. Typ uw prompt en bekijk de uitvoer.

  4. Daarnaast kunt u code weergeven in de rechterbovenhoek gebruiken om details te bekijken over hoe u programmatisch toegang krijgt tot de modelimplementatie.

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

Middelen 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 om de lijst met geïmplementeerde modellen weer te geven.

  2. Klik met de rechtermuisknop op het geïmplementeerde model om het te verwijderen en selecteer de optie Verwijderen .

    Schermopname van het contextmenu van het model met de optie Verwijderen gemarkeerd.

Uw hulpprogramma's verwijderen

Verwijder het verbonden hulpprogramma met de volgende stappen:

  1. Open de Azure-portal
  2. Selecteer de Azure-resourcegroep met het hulpprogramma.
  3. Selecteer de knop Verwijderen .

Volgende stappen

  • Last updated on