Delen via

Werken met de Azure AI Foundry voor Visual Studio Code-extensie (preview)

Azure AI 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 Azure AI 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 Azure AI Foundry Agent Service

Met de Azure AI Foundry voor 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 Azure AI Foundry voor 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 Azure AI Foundry voor Visual Studio Code-extensie gebruikt, moet u het volgende doen:

Installatie

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

Als u de Azure AI Foundry voor 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 Azure AI Foundry voor Visual Studio Code-extensie te installeren vanuit Visual Studio Code Marketplace:

  1. Open de Azure AI Foundry voor de Visual Studio Code-extensiepagina.
  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 Azure AI Foundry voor Visual Studio Code-extensie in Visual Studio Code te installeren:

  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 Azure AI 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 Azure AI 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 azure AI Foundry te doorzoeken. In de volgende schermopname ziet u enkele acties voor Azure AI Foundry. Een schermopname van het Opdrachtenpalet van Visual Studio Code voor Azure AI 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 Azure AI Foundry en klik met de rechtermuisknop op uw project.

  5. Selecteer Openen in de Azure AI Foundry-extensie.

    Een schermopname van de optie Openen in Azure AI Foundry Extension.

De Azure AI Foundry-extensie verkennen

De Azure AI Foundry-extensie wordt geopend in een eigen weergave, met het Azure AI Foundry-pictogram dat 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 Azure AI Foundry-extensie met gemarkeerde secties.

  • Resources: deze sectie bevat de resources waar u toegang toe hebt in uw Azure AI Foundry-project. De sectie Resources is de hoofdweergave voor interactie met uw Azure AI 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 Azure AI Foundry-project.
    • Agents: deze sectie bevat uw geïmplementeerde agents in uw Azure AI Foundry-project.
    • Assets: Deze sectie bevat de assets die u hebt in uw Azure AI Foundry-project.
      • Verbindingen: Deze subsectie bevat de verbindingen die u hebt in uw Azure AI Foundry-project. Bijvoorbeeld Bing Grounding-verbindingen.
      • Vector Stores: Deze subsectie bevat de vectorarchieven die u hebt in uw Azure AI Foundry-project.
    • Threads: deze sectie bevat de threads en wordt uitgevoerd vanaf een geïmplementeerde agent in uw Azure AI 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 Azure AI Foundry-project.
    • Agent Playground: de koppeling naar de agentspeelplaats voor interactie met uw geïmplementeerde agents in uw Azure AI Foundry-project.

  • Help en feedback: deze sectie bevat koppelingen naar de Documentatie voor Azure AI Foundry, feedback, ondersteuning en de Privacyverklaring van Microsoft. Deze bevat de volgende subsecties:

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

Opmerking

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

Een project maken

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

  1. Selecteer het pluspictogram naast Resources in de sectie Resources van de weergave Azure AI 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 Azure AI Foundry-project in dat 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 azure AI Foundry-extensieweergave om het gewenste model te selecteren dat u wilt implementeren.

Het standaard azure AI Foundry-project

Wanneer u een project opent in de Azure AI 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 Azure AI Foundry-project en selecteer de optie Switch Default Project in Azure Extension .

  2. Selecteer in het bovenste midden het Azure AI 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 Azure AI Foundry voor 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 de Azure AI 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 opdracht Azure AI Foundry: Opdrachtpalet modelcatalogus openen.
  • Selecteer het pluspictogram naast Modellen in de sectie Resources van de weergave Azure AI Foundry Extension.
  • Selecteer de koppeling Modelcatalogus in de sectie Hulpprogramma's van de weergave Azure AI Foundry Extension.

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 Azure AI Foundry, rechtstreeks vanuit VS Code.

  1. Selecteer F1 om het opdrachtpalet te openen.

  2. Voer Azure AI Foundry in: Open modelcatalogus 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 Azure AI Foundry Extension.

Selecteer in de weergave Azure AI 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 Hulpprogramma's van de weergave Azure AI 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 Azure AI 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 Hulpprogramma's van de weergave Azure AI 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 Azure AI 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