Dela via

Arbeta med Microsoft Foundry for Visual Studio Code-tillägget (klassisk)

Anmärkning

Det här dokumentet refererar till Microsoft Foundry-portalen (klassisk).

Visa dokumentationen för Microsoft Foundry (ny) för att lära dig mer om den nya portalen.

I den här artikeln lär du dig hur du installerar och använder Microsoft Foundry för Visual Studio Code-tillägget. Skapa projekt, distribuera modeller från Foundry-modellkatalogen och interagera med modelllekplatser inifrån VS Code.

Viktigt!

Objekt markerade (förhandsversion) i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Supplemental Terms of Use for Microsoft Azure Previews.

Förutsättningar

  • En Azure-abonnemang. Skapa en kostnadsfritt.
  • Visual Studio Code installerat.
  • Din prenumeration måste ligga under din kvotgräns för att distribuera en ny modell i den här artikeln. Om du redan har nått din kvotgräns måste du ha en distribuerad chattmodell.
  • Lämpliga RBAC-behörigheter för att skapa och hantera Foundry-resurser. Mer information finns i Rollbaserad åtkomstkontroll för Foundry.

Installera tillägget

Om du vill använda Foundry-funktioner i VS Code installerar du Foundry for Visual Studio Code-tillägget. Installera från Visual Studio Code Marketplace eller direkt från VS Code.

Installera från Visual Studio Code Marketplace

Använd Marketplace för att installera tillägget utan att öppna VS Code först.

  1. Öppna sidan för Visual Studio Code-tillägget Foundry.
  2. Välj knappen Installera.
  3. Följ anvisningarna för att installera tillägget i Visual Studio Code.
  4. Efter installationen öppnar du Visual Studio Code och kontrollerar att tillägget har installerats från statusmeddelandena.
  5. Ikonen Foundry visas i det primära navigeringsfältet till vänster i VS Code.

Installera inifrån Visual Studio Code

Alternativt kan du söka efter tillägget direkt från VS Code-tilläggsvyn.

  1. Öppna VS Code.

  2. Välj tillägg i den vänstra panelen.

  3. Välj ikonen Inställningar högst upp till höger i fönstret med tillägg.

  4. Sök efter och välj Foundry.

  5. Välj Installera.

  6. När installationen är klar bekräftar ett statusmeddelande att tillägget är installerat. Ikonen Foundry visas i det vänstra navigeringsfältet.

Ansluta till dina Azure resurser

När du har installerat tillägget loggar du in på din Azure-prenumeration och öppnar ett Foundry-projekt för att börja arbeta med modeller, agenter och lekplatser.

Anmärkning

Om du vill ha en fullständig lista över funktioner som är tillgängliga i tillägget använder du kommandopaletten. Välj F1 för att öppna kommandopaletten och söka efter Foundry. Följande skärmbild visar några av de tillgängliga kommandona. Skärmbild av VS Code-kommandopaletten som visar tillgängliga Foundry-kommandon som Open Model Catalog och Open Playground.

Logga in på dina resurser

Logga in på din Azure-prenumeration så att tillägget kan komma åt dina Foundry-projekt och distribuerade modeller.

  1. Välj ikonen Azure i VS Code-navigeringsfältet.

  2. Välj Sign in to Azure... i vyn Azure Resources.

  3. Under avsnittet Resources väljer du din Azure-prenumeration och resursgrupp.

  4. Välj Foundry och högerklicka på projektet.

  5. Välj Öppna i Foundry-tillägget.

    Dina Foundry-projektresurser visas i tilläggsvyn och ikonen Foundry visas i VS Code-navigeringsfältet.

Foundry-tillägget organiserar din arbetsyta i tre huvudavsnitt.

Skärmbild av foundry-tilläggsgränssnittet som visar avsnitten Resurser, Verktyg och Hjälp och Feedback.

Avsnitt Vad den innehåller När du ska använda detta
Resurser Distribuerade modeller, deklarativa agenter, värdbaserade agenter, anslutningar och vektorlager för ditt Foundry-projekt. Visa och hantera dina projektresurser.
Arbetsredskap Modellkatalog, Modelllekplats, Agentlekplatser (fjärranslutna och lokala), Lokal visualiserare och Distribuera värdbaserade agenter. Distribuera nya modeller, testa prompter och interagera med agenter.
Hjälp och feedback Dokumentation, GitHub lagringsplats, Microsofts sekretesspolicy och communitylänkar. Få hjälp eller ge feedback.

Anmärkning

Mer information om hur du arbetar med agenter i Foundry-tillägget finns i Work with Agent Service in Visual Studio Code.

Skapa ett projekt

Skapa ett nytt Foundry-projekt direkt från tillägget för att organisera dina modeller och resurser.

  1. Välj plusikonen bredvid Resurser i avsnittet Resurser i vyn Foundry-tillägg.

    Du kan antingen skapa en ny resursgrupp eller välja en befintlig.

  2. Om du vill skapa en ny resursgrupp:

    1. Välj Skapa ny resursgrupp och tryck på Retur.

    2. Ange namnet på Azure resursgrupp i textrutan Enter new resource group och tryck på Retur.

    3. Välj den plats som du vill använda i listan över tillgängliga platser och tryck på Enter.

  3. Så här använder du en befintlig resursgrupp:

    • Välj den resursgrupp som du vill använda i listan över tillgängliga resursgrupper och tryck på Retur.

  4. Ange namnet på Foundry-projektet i textrutan Ange projektnamn och tryck på Retur.

Efter projektdistributionen visas ett popup-fönster med meddelandet Projekt distribuerades framgångsrikt.

Om du vill distribuera en modell till det nyligen skapade projektet väljer du knappen Distribuera en modell i popup-fönstret. Den här åtgärden öppnar sidan Modellkatalog där du kan välja önskad modell som ska distribueras.

Växla standardprojektet

När du öppnar ett projekt i Foundry-tillägget anges det projektet som standardprojekt. Så här växlar du standardprojektet:

  1. Högerklicka på Foundry-projektet och välj alternativet Switch Default Project i Azure Extension.

  2. Välj det Foundry-projekt som du vill använda i listan över tillgängliga projekt och tryck på Retur.

Det markerade projektet visar nu Standardvärde efter projektnamnet.

Tips/Råd

Högerklicka på projektnamnet för att få åtkomst till projektslutpunkten eller projekt-API-nyckeln.

Arbeta med modeller

Med Foundry-tillägget kan du identifiera, distribuera och interagera med modeller från Foundry-modellkatalogen direkt i VS Code.

Bläddra i modellkatalogen

Modellkatalogen ger åtkomst till modeller från Microsoft, OpenAI, Meta, DeepSeek och andra leverantörer. Du kan öppna modellkatalogen på flera sätt:

  • Kör kommandot Foundry: Open Model Catalog från kommandopaletten.
  • Välj plusikonen bredvid Modeller i avsnittet Resurser i vyn Foundry-tillägg.
  • Välj länken Modellkatalog i avsnittet Verktyg i vyn Foundry-tillägg.

Öppna modellkatalogen från kommandopaletten

Använd kommandopaletten för att öppna modellkatalogen utan att navigera i tilläggsvyn.

  1. Välj F1 för att öppna kommandopaletten.

  2. Ange Foundry: Open Model Catalog och tryck på Retur.

  3. Sidan Modellkatalog öppnas.

    Skärmbild av sidan Modellkatalog i VS Code som visar modellkort med filter för utgivare och modelltyp.

  4. Filtrera modellkatalogen efter värd, utgivare, funktion eller modelltyp med hjälp av rullgardinsmenyerna överst på sidan. Välj växlingsknappen Fine-Tuning Support för att filtrera modeller som stöder finjustering.

  5. Sök efter en specifik modell med hjälp av sökfältet längst upp på sidans mitt.

Öppna modellkatalogen från avsnittet Resurser

I vyn Foundry-tillägg väljer du plusikonen bredvid Modeller för att öppna modellkatalogen.

Tips/Råd

Du kan också högerklicka på Modeller och välja Distribuera ny AI-modell för att gå direkt till distributionsflödet.

Öppna modellkatalogen från avsnittet Verktyg

Dubbelklicka på länken Modellkatalog i avsnittet Verktyg i vyn Foundry-tillägg.

Distribuera en modell från modellkatalogen

När du har hittat en modell i katalogen distribuerar du den till ditt Foundry-projekt så att du kan använda den i dina program.

  1. Välj knappen Distribuera bredvid det valda modellnamnet.

  2. Sidan Modellimplementering öppnas.

  3. Ange namnet på modelldistributionen i textrutan Ange distributionsnamn och tryck på Retur.

  4. Välj distributionstyp i listrutan Distributionstyp .

  5. Välj modellversionen i listrutan Modellversion .

  6. (Valfritt) Justera det antal toker per minut med skjutreglaget Toker per minut.

  7. Välj knappen Distribuera i Foundry i det nedre vänstra hörnet.

  8. I bekräftelsedialogrutan väljer du Distribuera.

  9. När distributionen är klar visas modellen efter distributionsnamn under avsnittet Modeller i projektet.

Visa och hantera distribuerade modeller

Expandera avsnittet Modeller i vyn Foundry-tillägg för att se alla distribuerade modeller i projektet.

Visa information om modellkort

Välj en distribuerad modell för att öppna en panel med följande information:

  • Distributionsinformation: Namn, etableringstillstånd, distributionstyp, hastighetsgräns, versionsinformation, modellnamn och modellversion.
  • Slutpunktsinformation: Mål-URI-länk, autentiseringstyp och nyckel.
  • Användbara länkar: Kodexempellagringsplats och självstudielänkar för AI-programutveckling.

Uppdatera modelldistributionsinställningar

Så här uppdaterar du distributionsinställningar, till exempel hastighetsbegränsningar:

  1. Välj knappen Redigera längst upp till höger på modellkortet.
  2. Uppdatera de redigerbara fälten.
  3. Välj knappen Spara för att spara dina ändringar.

Generera exempelkod för en modell

Generera en startkodfil för din distribuerade modell för att påskynda programutvecklingen.

  1. Högerklicka på din distribuerade modell och välj Öppna kodfil.

  2. Välj önskad SDK i listrutan Välj önskad SDK .

  3. Välj önskat språk i listrutan Välj språk .

  4. Välj önskad autentiseringsmetod i listrutan Välj autentiseringsmetod .

  5. En exempelkodfil öppnas på en ny flik i VS Code.

Följande skärmbild visar ett genererat Python exempel som gör ett synkront anrop till svars-API:et:

Skärmbild av en genererad Python exempelkodfil som visar ett API-anrop för synkrona svar i VS Code.

Interagera med modeller på lekplatsen

Använd modelllekplatsen för att chatta interaktivt med din distribuerade modell, justera inställningar och ändra systeminstruktioner.

Öppna lekplatsen genom att dubbelklicka på länken Modelllekplats i avsnittet Verktyg i vyn Foundry-tillägg. Du kan också högerklicka på din distribuerade modell och välja Öppna på lekplatsen.

  1. Sidan Playground öppnas.

  2. Skriv din uppmaning och granska utdata.

  3. Välj Visa kod i det övre högra hörnet för att se hur du kommer åt modelldistributionen programmatiskt.

  4. Välj länken Historik längst upp till vänster på lekplatsen för att visa din chatthistorik.

Felsökning av vanliga problem

Om du stöter på problem när du använder Foundry-tillägget kontrollerar du följande vanliga problem:

Problematik Lösning / Beslut
Tillägget visas inte efter installationen Starta om VS Code och kontrollera att tillägget är aktiverat i vyn Tillägg .
Inloggningen misslyckas eller så läses inte prenumerationer in Kontrollera att ditt Azure-konto har rätt behörigheter. Prova att logga ut och logga in igen från vyn Azure Resources.
Distributionen av modellen misslyckas på grund av ett kvotfel Kontrollera din prenumerationskvot och begär antingen en ökning eller ta bort oanvända distributioner.

Rensa resurser

De Azure resurser som du skapade i den här artikeln debiteras till din Azure-prenumeration. Om du inte förväntar dig att behöva dessa resurser i framtiden tar du bort dem för att undvika att debiteras mer.

Ta bort dina modeller

  1. Uppdatera Foundry-tillägget i VS Code-navigeringsfältet. I avsnittet Resurser expanderar du underavsnittet Modeller .

  2. Högerklicka på den distribuerade modell som du vill ta bort och välj Ta bort.

Ta bort Azure resurser

Om du vill ta bort resursgruppen och alla resurser i den:

Varning

Om du tar bort en resursgrupp tas alla resurser i den bort permanent, inklusive ditt Foundry-projekt och eventuella distribuerade modeller. Det går inte att ångra den här åtgärden.

  1. Öppna Azure-portalen.
  2. Gå till resursgruppen som innehåller ditt Foundry-projekt.
  3. Välj Ta bort resursgrupp och bekräfta borttagningen.

Nästa steg

  • Last updated on