Arbeta med Microsoft Foundry Toolkit for Visual Studio Code-tillägget

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

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 Microsoft Foundry Toolkit för 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 Microsoft Foundry Toolkit för Visual Studio Code-tillägget.
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 Toolkit 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 rutan.

3. Välj ikonen Inställningar längst upp till höger i tilläggsfönstret.

4. Sök efter och välj Foundry Toolkit för VS Code.

5. Välj Installera.

6. När installationen är klar bekräftar ett statusmeddelande att tillägget är installerat. Ikonen Foundry Toolkit 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.

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 Toolkit-tillägget.

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

Navigera i tilläggsgränssnittet

Tillägget Microsoft Foundry Toolkit for Visual Studio Code organiserar din arbetsyta i tre huvudavsnitt.

Skapa ett projekt

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

1. Välj + Skapa projekt i avsnittet My Resources i tilläggsvyn för Microsoft Foundry Toolkit i Visual Studio Code.

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

2. Så här skapar du 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 project distribution visas ett popup-fönster med meddelandet Project har distribuerats.

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 Microsoft Foundry Toolkit för Visual Studio Code-tillägget anges projektet som standardprojekt. Så här växlar du standardprojektet:

1. Högerklicka på Foundry project 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 Standardläge efter projektnamnet.

Arbeta med modeller

Med Microsoft Foundry Toolkit for Visual Studio Code-tillägget kan du identifiera, distribuera och interagera med modeller från modellkatalogen Foundry 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 Foundry Toolkit: Visa modellkatalogkommandot från kommandopaletten.
• Välj ikonen plus bredvid Models i avsnittet My Resources i Microsoft Foundry Toolkit för Visual Studio Code tilläggsvy.
• Välj länken Model Catalog i avsnittet Developer Tools i Microsoft Foundry Toolkit för Visual Studio Code tilläggsvy.

Ö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. Skriv Foundry Toolkit: visa modellkatalog och tryck på Enter.

3. Sidan Modellkatalog öppnas.

   

4. Filtrera Model Catalog efter Hosted by, Publisher, Feature eller Model type med hjälp av listrutorna ö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 Microsoft Foundry Toolkit for Visual Studio Code-tilläggsvyn väljer du ikonen plus bredvid Models för att öppna modellkatalogen.

Öppna modellkatalogen från avsnittet Verktyg

I avsnittet Developer Tools i tilläggsvyn för Microsoft Foundry Toolkit for Visual Studio Code dubbelklickar du på länken Model Catalog.

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. Modelldistributionssidan ö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 tokens per minut med skjutreglaget Tokens 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 Models i Microsoft Foundry Toolkit för Visual Studio Code tilläggsvy för att se alla distribuerade modeller i projektet.

Visa modellkortsuppgifter

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 tillämpa ändringarna.

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:

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 Model Playground i avsnittet Developer Tools i Microsoft Foundry Toolkit för Visual Studio Code tilläggsvy. 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 resultatet.

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öka vanliga problem

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

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. I VS Code-navigeringsfältet uppdaterar du Microsoft Foundry Toolkit för Visual Studio Code-tillägget. I avsnittet Mina 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:

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

• Utforska Foundry-modeller
• Distribuera modeller med Foundry