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

V tomto článku se dozvíte, jak nainstalovat a používat 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.

Požadavky

Instalace rozšíření

Pokud chcete v editoru VS Code používat funkce Foundry, nainstalujte rozšíření Foundry pro Visual Studio Code. Nainstalujte se z webu Visual Studio Code Marketplace 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 Nainstalovat.

  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 projekt 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. Snímek obrazovky s paletou příkazů VS Code zobrazující dostupné příkazy Foundry, jako je Open Model Catalog a Open Playground

Přihlášení k prostředkům

Přihlaste se ke svému předplatnému Azure, aby rozšíření bylo možné získat přístup k projektům Foundry a nasazených modelům.

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

  2. Vyberte Sign in to Azure... v zobrazení Azure Zdroje.

  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.

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

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

Snímek obrazovky s rozhraním rozšíření Foundry s oddíly Zdroje, Nástroje a Nápověda a Zpětná vazba

Oddíl Co obsahuje Kdy ji použít
Zdroje Nasazené modely, deklarativní agenty, hostované agenty, připojení a úložiště vektorů pro váš projekt Foundry Umožňuje zobrazit a spravovat zdroje projektu.
Nástroje 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, Microsoft prohlášení o zásadách ochrany osobních údajů a odkazy na komunitu Získejte nápovědu nebo poskytněte zpětnou vazbu.

Vytvoření projektu

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. Vytvoření nové skupiny prostředků:

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

    2. Do textového pole Enter zadejte název Azure skupiny prostředků 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. Použití existující skupiny 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 Zadejte název projektu Zadejte název projektu a stiskněte Enter.

Po project nasazení se zobrazí automaticky otevírané 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řepnutí výchozího projektu

Když otevřete projekt v rozšíření Foundry, nastaví se tento projekt jako výchozí projekt. Přepnutí výchozího projektu:

  1. Klikněte pravým tlačítkem na project Foundry a v možnosti Azure ExtensionSpínat výchozí Project vyberte .

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

Vybraný projekt se teď zobrazuje jako výchozí za názvem projektu.

Tip

Po kliknutí pravým tlačítkem myši na název projektu získáte přístup ke koncovému bodu projektu nebo klíči rozhraní 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 přístup k modelům z Microsoft, OpenAI, Meta, DeepSeek a dalších poskytovatelů. Katalog modelů můžete otevřít několika způsoby:

  • Spusťte Foundry: Otevřete příkaz 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. Enter Foundry: Otevřete katalog modelů a stiskněte Enter.

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

    Snímek obrazovky se stránkou Katalog modelů ve VS Code zobrazující karty modelu s filtry pro vydavatele a typ modelu

  4. Filtrovat katalog modelů podle HostitelemPublisher, Feature nebo Model pomocí rozevíracích seznamu v horní části stránky. Výběrem přepínače Fine-Tuning Podpora můžete filtrovat modely, které podporují jemné ladění.

  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ů.

Tip

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 projektu Foundry, abyste ho mohli použít 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 tokeny 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 Modely ve vašem projektu.

Zobrazení a správa nasazených modelů

Rozbalte oddíl Modely v zobrazení rozšíření Foundry a zobrazte všechny nasazené modely v projektu.

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. Vyberte tlačítko Uložit , aby se změny použily.

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. V rozevíracím seznamu Zvolit upřednostňovanou sadu SDK vyberte.

  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 Python, která provádí synchronní volání rozhraní API pro odpovědi:

Screenshot vygenerovaného souboru s ukázkovým kódem Python zobrazující volání synchronních odpovědí api v editoru VS Code.

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ýběrem možnosti Zobrazit kód v pravém horním rohu zjistíte, jak získat přístup k nasazení modelu prostřednictvím kódu programu.

  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 problémů

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 Rozliš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 s chybou kvóty Zkontrolujte kvótu předplatného a buď požádejte o navýšení nebo odstranění nepoužívaných nasazení.

Vyčištění prostředků

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ů.

Odstranění modelů

  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.

Odstranění prostředků Azure

Pokud chcete odstranit skupinu prostředků a všechny prostředky v rámci této skupiny prostředků, proveďte následující:

Upozornění

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

  1. Otevřete portál Azure.
  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

  • Last updated on