Práce s rozšířením Microsoft Foundry pro Visual Studio Code

V tomto článku se dozvíte, jak nainstalovat a používat rozšíření Microsoft Foundry pro rozšíření Visual Studio Code. Vytvářejte projekty, nasazujte modely z katalogu modelů Foundry a interagujte s testovacími prostředími v editoru VS Code.

Předpoklady

• Předplatné Azure. Kreate si ho zdarma.
• Visual Studio Code nainstalovaný.
• Aby bylo možné nasadit nový model v tomto článku, musí být vaše předplatné pod limitem kvóty. Pokud jste už dosáhli limitu kvóty, musíte mít nasazený chatovací model.
• Příslušná oprávnění RBAC k vytváření a správě prostředků Foundry Další informace viz Řízený přístup na základě rolí pro Foundry.

Instalace rozšíření

Pokud chcete používat funkce Foundry ve VS Code, nainstalujte Foundry pro rozšíření Visual Studio Code. Nainstalujte z marketplace Visual Studio Code nebo přímo z nástroje VS Code.

Instalace z marketplace Visual Studio Code

Pomocí marketplace nainstalujte rozšíření bez prvního otevření nástroje VS Code.

1. Otevřete stránku rozšíření Foundry pro Visual Studio Code.
2. Vyberte tlačítko Instalovat.
3. Podle pokynů nainstalujte rozšíření v Visual Studio Code.
4. Po instalaci otevřete Visual Studio Code a ověřte, že se rozšíření úspěšně nainstalovalo ze stavových zpráv.
5. Ikona Foundry se zobrazí na primárním navigačním panelu na levé straně nástroje VS Code.

Instalace z Visual Studio Code

Případně vyhledejte rozšíření přímo ze zobrazení rozšíření VS Code.

1. Otevřete VS Code.

2. V levém podokně vyberte Rozšíření .

3. V pravém horním rohu podokna rozšíření vyberte ikonu Nastavení .

4. Vyhledejte a vyberte Foundry.

5. Vyberte volbu Instalovat.

6. Po dokončení instalace stavová zpráva potvrdí, že je rozšíření nainstalované. Ikona Foundry se zobrazí v levém navigačním panelu.

Připojení k prostředkům Azure

Po instalaci rozšíření se přihlaste ke svému předplatnému Azure a otevřete project Foundry, abyste mohli začít pracovat s modely, agenty a hřištěmi.

Poznámka:

Úplný seznam funkcí dostupných v rozšíření najdete v paletě příkazů. Výběrem klávesy F1 otevřete paletu příkazů a vyhledejte Foundry. Následující snímek obrazovky ukazuje některé dostupné příkazy.

Přihlaste se ke svým prostředkům

Přihlaste se ke svému předplatnému Azure, aby rozšíření mohlo získat přístup k vašim projektům Foundry a nasazeným modelům.

1. Na navigačním panelu VS Code vyberte ikonu Azure.

2. Vyberte Přihlásit se k Azure... v zobrazení Azure prostředky.

3. V části Zdroje vyberte předplatné Azure a skupinu prostředků.

4. Vyberte Foundry a klikněte pravým tlačítkem na projekt.

5. Vyberte Otevřít v rozšíření Foundry.

   V zobrazení rozšíření se zobrazí prostředky projektu Foundry a na navigačním panelu VS Code se zobrazí ikona Foundry.

Navigace v rozhraní rozšíření

Rozšíření Foundry uspořádá pracovní prostor do tří hlavních částí.

Oddíl	Co obsahuje	Kdy ji použít
Prostředky	Nasazené modely, deklarativní agenty, hostované agenty, připojení a úložiště vektorů pro váš project Foundry.	Umožňuje zobrazit a spravovat prostředky project.
Nářadí	Katalog modelů, Model Playground, Agent Playgrounds (vzdálené a místní), Místní vizualizér a nasazení hostovaných agentů.	Nasaďte nové modely, testujte výzvy a interagujte s agenty.
Nápověda a zpětná vazba	Dokumentace, úložiště GitHub, prohlášení o zásadách ochrany osobních údajů společnosti Microsoft a odkazy na komunitu	Získejte nápovědu nebo poskytněte zpětnou vazbu.

Vytvořit projekt

Vytvořte nový projekt Foundry přímo z rozšíření pro uspořádání modelů a prostředků.

1. V části Zdroje v zobrazení rozšíření Foundry vyberte ikonu plus vedle položky Zdroje.

   Můžete buď vytvořit novou skupinu prostředků, nebo vybrat existující.

2. Pokud chcete vytvořit novou skupinu prostředků:

   1. Vyberte Vytvořit novou skupinu prostředků a stiskněte Enter.

   2. Do textového pole Zadejte nový název skupiny prostředků Azure a stiskněte Enter.

   3. V seznamu dostupných umístění vyberte umístění, které chcete použít, a stiskněte Enter.

3. Chcete-li použít existující skupinu prostředků:

   • Ze seznamu dostupných skupin prostředků vyberte skupinu prostředků, kterou chcete použít, a stiskněte Enter.

4. Do textového pole Enter project zadejte název project Foundry a stiskněte Enter.

Po nasazení projektu se zobrazí vyskakovací okno se zprávou Project úspěšně nasazeno.

Pokud chcete nasadit model do nově vytvořeného projektu, vyberte v místní nabídce tlačítko Nasadit model. Tato akce otevře stránku Katalog modelů , kde můžete vybrat požadovaný model, který chcete nasadit.

Přepněte výchozí projekt

Když v rozšíření Foundry otevřete project, nastaví se project jako výchozí project. Chcete-li změnit výchozí projekt:

1. Klikněte pravým tlačítkem na projekt Foundry a vyberte možnost Spínat výchozí projekt v rozšíření Azure.

2. V seznamu dostupných projektů vyberte project Foundry, které chcete použít, a stiskněte Enter.

Vybraný project teď za názvem project zobrazí Default.

Návod

Klikněte pravým tlačítkem na název projektu pro přístup ke koncovému bodu projektu nebo klíči API projektu.

Práce s modely

Rozšíření Foundry umožňuje zjišťovat, nasazovat a pracovat s modely z katalogu modelů Foundry přímo v editoru VS Code.

Procházení katalogu modelů

Katalog modelů poskytuje access modelům od Microsoftu, OpenAI, Meta, DeepSeek a dalších poskytovatelů. Katalog modelů můžete otevřít několika způsoby:

• Spusťte příkaz Foundry: Otevřít katalog modelů z palety příkazů.
• V části Zdroje v zobrazení rozšíření Foundry vyberte ikonu plus vedle položky Modely.
• V části Nástroje v zobrazení rozšíření Foundry vyberte odkaz Katalog modelů.

Otevření katalogu modelů z palety příkazů

Pomocí palety příkazů otevřete katalog modelů bez procházení zobrazení rozšíření.

1. Výběrem klávesy F1 otevřete paletu příkazů.

2. Zadejte Foundry: Open Model Catalog a stiskněte Enter.

3. Otevře se stránka Katalog modelů .

   

4. Pomocí rozevíracího seznamu na vrchu stránky můžete filtrovat katalog modelů podle kritérií jako jsou hostitel, vydavatel, vlastnost nebo typ modelu. Výběrem přepínače podpora jemného ladění můžete filtrovat modely, které tuto podporu umožňují.

5. Pomocí vyhledávacího panelu v horní části stránky vyhledejte konkrétní model.

Otevření katalogu modelů v části Zdroje

V zobrazení rozšíření Foundry vyberte ikonu plus vedle položky Modely a otevřete katalog modelů.

Návod

Můžete také kliknout pravým tlačítkem myši na Modely a vybrat Nasadit nový model AI a přejít přímo do toku nasazení.

Otevření katalogu modelů v části Nástroje

V části Nástroje v zobrazení rozšíření Foundry poklikejte na odkaz Katalog modelů .

Nasazení modelu z katalogu modelů

Jakmile v katalogu najdete model, nasaďte ho do svého project Foundry, abyste ho mohli používat ve svých aplikacích.

1. Vyberte tlačítko Nasadit vedle vybraného názvu modelu.

2. Otevře se stránka Nasazení modelu .

3. Do textového pole Zadejte název nasazení modelu a stiskněte Enter.

4. V rozevíracím seznamu Typ nasazení vyberte typ nasazení.

5. V rozevíracím seznamu Verze modelu vyberte verzi modelu .

6. (Volitelné) Pomocí posuvníku Tokeny za minutu upravte počet tokenů za minutu.

7. V levém dolním rohu vyberte tlačítko Nasadit v Foundry .

8. V potvrzovací dialogovém okně vyberte Nasadit.

9. Po dokončení nasazení se model zobrazí podle názvu nasazení v části Models v project.

Zobrazení a správa nasazených modelů

Rozbalte oddíl Models v zobrazení rozšíření Foundry a podívejte se na všechny nasazené modely ve vašem project.

Zobrazení informací o kartě modelu

Výběrem nasazeného modelu otevřete panel s následujícími podrobnostmi:

• Informace o nasazení: Název, stav zřizování, typ nasazení, limit rychlosti, informace o verzi, název modelu a verze modelu.
• Informace o koncovém bodu: Odkaz na cílový identifikátor URI, typ ověřování a klíč.
• Užitečné odkazy: Ukázkové úložiště kódu a odkazy na kurzy pro vývoj aplikací AI

Aktualizace nastavení nasazení modelu

Aktualizace nastavení nasazení, jako jsou limity rychlosti:

1. Vyberte tlačítko Upravit v pravém horním rohu karty modelu.
2. Aktualizujte upravitelná pole.
3. Pro uplatnění změn vyberte tlačítko Uložit.

Generování vzorového kódu pro model

Vygenerujte počáteční soubor kódu pro nasazený model, který urychlí vývoj aplikací.

1. Klikněte pravým tlačítkem na nasazený model a vyberte Otevřít soubor kódu.

2. Vyberte svou upřednostňovanou sadu SDK v rozevíracím seznamu Vybrat upřednostňovanou sadu SDK.

3. V rozevíracím seznamu Zvolit jazyk vyberte upřednostňovaný jazyk.

4. V rozevíracím seznamu Zvolit metodu ověřování vyberte upřednostňovanou metodu ověřování .

5. Ukázkový soubor kódu se otevře na nové kartě v editoru VS Code.

Následující snímek obrazovky ukazuje vygenerovanou ukázku Pythonu, která provádí synchronní volání rozhraní API pro odpovědi:

Interakce s modely v dětském hřišti

Pomocí modelového hřiště můžete interaktivně chatovat s nasazeným modelem, upravit nastavení a upravit systémové pokyny.

Pokud chcete otevřít dětské hřiště, poklikejte na odkaz Model Playground v části Nástroje v zobrazení rozšíření Foundry. Případně klikněte pravým tlačítkem na nasazený model a vyberte Otevřít v dětském hřišti.

1. Otevře se stránka Dětské hřiště .

2. Zadejte výzvu a zkontrolujte výstup.

3. V pravém horním rohu vyberte View code a podívejte se, jak programaticky přistupovat k nasazení modelu.

4. Výběrem odkazu Historie v levém horním rohu dětského hřiště zobrazte historii chatu.

Řešení běžných potíží

Pokud při používání rozšíření Foundry narazíte na problémy, projděte si následující běžné problémy:

Problém	Řešení
Rozšíření se po instalaci nezobrazuje	Restartujte VS Code a ověřte, že je rozšíření povolené v zobrazení Rozšíření .
Přihlášení selže nebo se nenačtou předplatná	Ověřte, že váš účet Azure má správná oprávnění. Zkuste se odhlásit a znovu se přihlásit ze zobrazení Azure Resources.
Selhání nasazení modelu kvůli chybě kvóty	Zkontrolujte kvótu předplatného a buď požádejte o navýšení nebo odstranění nepoužívaných nasazení.

Vyčistěte zdroje

Prostředky Azure, které jste vytvořili v tomto článku, se účtují na vaše předplatné Azure. Pokud v budoucnu tyto prostředky nepotřebujete, odstraňte je, abyste se vyhnuli účtování dalších poplatků.

Odstraňte své modely

1. Na navigačním panelu VS Code aktualizujte rozšíření Foundry. V části Zdroje rozbalte pododdíl Modely .

2. Klikněte pravým tlačítkem na nasazený model, který chcete odebrat, a vyberte Odstranit.

Odstraňte prostředky Azure

Chcete-li odstranit skupinu prostředků a všechny prostředky v ní, postupujte následovně:

Výstraha

Odstraněním skupiny prostředků trvale odeberete všechny prostředky, včetně vašeho projektu Foundry a jakýchkoli nasazených modelů. Tuto akci nelze vrátit zpět.

1. Otevřete Azure portal.
2. Přejděte do skupiny prostředků, která obsahuje váš projekt Foundry.
3. Vyberte Odstranit skupinu prostředků a potvrďte odstranění.

Další kroky

• Prozkoumání modelů Foundry
• Nasazení modelů pomocí Foundry