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

Microsoft Foundry poskytuje jednotnou platformu pro podnikové operace AI, tvůrce modelů a vývoj aplikací. Tato nadace kombinuje infrastrukturu na úrovni produkce s přátelskými rozhraními a zajišťuje, aby organizace mohly vytvářet a provozovat aplikace AI s jistotou.

S Foundry můžete:

• Nasazení nejnovějších jazykových modelů od Microsoftu, OpenAI, Meta, DeepSeek a dalších produktů s využitím robustního katalogu modelů

• Testování nasazených modelů v modelovém hřišti

• Rychlý začátek vývoje aplikací generující umělé inteligence s využitím kolekce kurátorovaných šablon kódu Azure

• Konfigurace a nasazení agentů pomocí služby Foundry Agent Service

S rozšířením Foundry pro Visual Studio Code můžete provádět většinu tohoto pracovního postupu přímo z editoru Visual Studio Code. Obsahuje také další funkce, jako jsou šablony kódu, dětské hřiště a integrace s dalšími rozšířeními a funkcemi VS Code.

V tomto článku se dozvíte, jak rychle začít používat funkce rozšíření Foundry pro Visual Studio Code.

Důležité

Položky označené (Preview) v tomto článku jsou aktuálně ve verzi Public Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce nemusí být podporované nebo můžou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview Microsoft Azure.

Požadavky

Před použitím rozšíření Foundry pro Visual Studio Code musíte:

• Stažení, instalace a konfigurace Visual Studio Code. Další informace: Stažení editoru Visual Studio Code

• Aby bylo možné nasadit nový model v tomto rychlém startu, musí být vaše předplatné pod limitem kvóty. Jinak už potřebujete mít nasazený model chatu.

• Nastavte příslušná oprávnění RBAC k vytváření a správě prostředků Foundry pomocí rozšíření Visual Studio Code. Další informace naleznete v tématu Řízení přístupu na základě role pro Foundry.

Instalace

Po instalaci nástroje Visual Studio Code je potřeba nainstalovat rozšíření Foundry pro Visual Studio Code.

Pokud chcete nainstalovat rozšíření Foundry pro Visual Studio Code, můžete buď použít Visual Studio Code Marketplace, nebo ho nainstalovat přímo z editoru Visual Studio Code.

Instalace z Marketplace editoru Visual Studio Code

Chcete-li nainstalovat rozšíření Foundry for Visual Studio Code z webu Visual Studio Code Marketplace, postupujte takto:

1. Otevřete stránku rozšíření Foundry pro Visual Studio Code.
2. Vyberte tlačítko Instalovat.
3. Podle pokynů nainstalujte rozšíření v editoru 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. Rozšíření by se teď mělo zobrazit na primárním navigačním panelu na levé straně editoru Visual Studio Code.

Instalace z editoru Visual Studio Code

Chcete-li nainstalovat rozšíření Foundry pro Visual Studio Code v editoru Visual Studio Code, postupujte takto:

1. Otevřete Visual Studio 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. Podle stavových zpráv ověřte, zda bylo rozšíření úspěšně nainstalováno.

Začínáme

Začněte s rozšířením Foundry pomocí následujícího postupu.

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é akce pro Foundry.

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

Přihlaste se ke svému předplatnému Azure a získejte přístup k prostředkům pomocí následujícího postupu:

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

2. Přihlaste se výběrem položky Sign in to Azure... v zobrazení Prostředků Azure.

   

3. V části Prostředky vyberte své 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.

   

Prozkoumejte rozšíření Foundry

Rozšíření Foundry se otevře ve vlastním zobrazení s ikonou Foundry, která se nyní zobrazuje na navigační liště VS Code. Toto rozšíření má tři hlavní části: Prostředky, Nástroje a Nápověda a Zpětná vazba.

• Zdroje: Tato část obsahuje zdroje, ke kterým máte přístup v projektu Foundry. Sekce Zdroje je hlavním zobrazením pro interakci se službami Foundry Services. Obsahuje následující pododdíly:

  • Modely: Tato část obsahuje modely, které můžete použít k sestavení a nasazení aplikací AI. Zobrazení Modely je místo, kde najdete nasazené modely v projektu Foundry.
  • Agenti: Tato část obsahuje nasazené agenty v projektu Foundry.
  • Prostředky: Tato část obsahuje prostředky, které máte v projektu Foundry.
    • Připojení: Tato pododdíl obsahuje připojení, která máte v projektu Foundry. Například připojení Bing Grounding.
    • Vector Stores: Tento pododdíl obsahuje vektorová úložiště, která máte v projektu Foundry.
  • Vlákna: Tato část obsahuje vlákna a spouští se z nasazeného agenta v projektu Foundry.

• Nástroje: Tato část obsahuje nástroje, které můžete použít k sestavení a nasazení aplikací AI. V zobrazení Nástroje najdete nástroje, které jsou k dispozici k nasazení, a pak můžete pracovat s nasazenými modely a agenty. Obsahuje následující pododdíly:

  • Katalog modelů: Odkaz na katalog modelů, který můžete použít ke zjišťování a nasazování modelů.
  • Model Playground: Odkaz na modelové hřiště pro interakci s nasazenými modely v projektu Foundry.
  • Agent Playground: Odkaz na dětské hřiště agenta pro interakci s nasazenými agenty v projektu Foundry.

• Nápověda a zpětná vazba: Tato část obsahuje odkazy na dokumentaci Foundry, zpětnou vazbu, podporu a prohlášení společnosti Microsoft o zásadách ochrany osobních údajů. Obsahuje následující pododdíly:

  • Dokumentace: Odkaz na dokumentaci k rozšíření Foundry.
  • GitHub: Odkaz na úložiště GitHub s rozšířením Foundry.
  • Prohlášení společnosti Microsoft o zásadách ochrany osobních údajů: Odkaz na prohlášení společnosti Microsoft o zásadách ochrany osobních údajů.
  • Připojte se do Komunity Foundry: Discord + Fórum: Odkaz na server Foundry community Discord.

Poznámka:

Další informace o práci s agenty a vlákny v rozšíření Foundry najdete v článku Práce se službou Agent v editoru Visual Studio Code .

Vytvoření projektu

Nový projekt Foundry můžete vytvořit v zobrazení rozšíření Foundry pomocí následujících kroků:

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. V horní části vyberte Vytvořit novou skupinu prostředků a stiskněte Enter.

      

   2. V horním rohu zadejte název skupiny prostředků Azure, který se má použít v textovém poli Zadejte novou skupinu prostředků a stiskněte Enter.

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

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

   • V horní části vyberte skupinu prostředků, kterou chcete použít, ze seznamu dostupných skupin prostředků a stiskněte Enter.

4. Do horního středu zadejte název projektu Foundry, který se má použít v textovém poli Zadejte název projektu a stiskněte Enter.

   

Po nasazení projektu se zobrazí automaticky otevírané okno se zprávou , že se projekt úspěšně nasadil.

Pro nasazení modelu do nově vytvořeného projektu vyberte v zobrazeném okně tlačítko Nasadit model. Tato akce otevře stránku Katalog modelů v zobrazení Rozšíření Foundry a vybere požadovaný model, který se má nasadit.

Výchozí projekt Foundry

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

Pomocí následujícího postupu přepněte výchozí projekt:

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

2. V horní části vyberte Projekt Foundry, který chcete použít, ze seznamu dostupných projektů a stiskněte Enter.

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

Práce s modely

Rozšíření Foundry pro Visual Studio Code umožňuje vytvářet, pracovat s nimi a nasazovat velké jazykové modely v editoru Visual Studio Code.

Prozkoumání všech modelů pomocí katalogu modelů

Katalog modelů na portálu Foundry je centrum pro zjišťování a používání široké škály modelů pro vytváření aplikací generující AI.

Přístup k katalogu modelů z několika různých způsobů:

• Příkazová paleta příkazu Foundry: Open Model Catalog.
• 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ů

Získejte přístup k katalogu modelů z palety příkazů a prozkoumejte a nasaďte kurátorovaný výběr modelů dostupných v Foundry přímo z VS Code.

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

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

3. Zobrazí se stránka Katalog modelů .

   

4. Vyfiltrujte katalog modelů podle Publisher nebo Task pomocí rozevíracích seznamu v levém horním rohu stránky.

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

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

Katalog modelů je také k dispozici v části Zdroje v zobrazení Rozšíření Foundry.

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 možnost Nasadit nový model AI a otevřít katalog modelů a zahájit proces nasazení.

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

Katalog modelů je také k dispozici v části Nástroje v zobrazení Rozšíření Foundry. Poklikáním na odkaz Katalog modelů otevřete katalog modelů.

Nasazení modelu z katalogu modelů

Nasaďte vybraný model v katalogu modelů pomocí následujících kroků:

1. Vyberte Nasadit v Azure okamžitě za vybraným názvem modelu.

   

2. Zobrazí se stránka nasazení modelu .

   

3. Zadejte název nasazení modelu, který se má použít v textovém poli Zadejte název nasazení a stiskněte Enter.

   

4. V rozevíracím seznamu Typ nasazení vyberte typ nasazení a stiskněte Enter.

   

5. Vyberte verzi modelu, která se má použít v rozevíracím seznamu Verze modelu , a stiskněte Enter.

   

6. (Volitelné) Vyberte tokeny za minutu, které chcete použít v posuvníku Tokeny za minutu , a stiskněte Enter.

7. V levém dolním rohu vyberte tlačítko Nasadit v Foundry a nasaďte model.

8. Zobrazí se potvrzovací dialogové okno. Klikněte na tlačítko Nasadit a nasaďte model do projektu.

   

9. Po úspěšném nasazení bude váš model uvedený podle názvu nasazení s ostatními nasazenými modely v části Modely v projektu.

   

Zobrazení nasazených modelů

V zobrazení Rozšíření prostředků Azure vyberte ikonu stříšky před částí Modely a zobrazte seznam nasazených modelů.

V rozbalené části Modely se zobrazí seznam nasazených modelů.

Zobrazení informací o kartě modelu

Výběrem nasazeného modelu se otevře panel s některými základními informacemi:

• Informace o nasazení: Tato část obsahuje informace o modelu:
  • Název
  • Stav zřizování
  • Typ nasazení
  • Informace o limitu rychlosti
  • Informace o verzi
  • Název modelu
  • Verze modelu
• Informace o koncovém bodu: Tato část obsahuje odkaz na cílový identifikátor URI, typ ověřování a klíč.
• Užitečné odkazy: Tato část obsahuje ukázkové úložiště kódu a odkazy na kurzy, které vám pomůžou začít s vývojem aplikací AI.

Aktualizace modelu

Pokud chcete aktualizovat informace o kartě modelu, vyberte tlačítko Upravit v pravém horním rohu karty modelu.

Aktualizujte požadovaná upravitelná pole, jako je omezení rychlosti přímo v editoru VS Code.

Pokud chcete změny uložit, vyberte tlačítko Uložit v pravém horním rohu karty modelu.

Prozkoumání vzorového kódu modelu

Pomocí následujícího postupu vytvořte ukázkový soubor kódu.

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

   

2. V horní části vyberte upřednostňovanou sadu SDK, která se má použít v rozevíracím seznamu Zvolit upřednostňovanou sadu SDK , a stiskněte Enter.

   

3. V horním rohu vyberte upřednostňovaný jazyk, který chcete použít v rozevíracím seznamu Zvolit jazyk , a stiskněte Enter.

   

4. V horní části vyberte upřednostňovanou metodu ověřování, která se má použít v rozevíracím seznamu Zvolit metodu ověřování , a stiskněte Enter.

   

Ukázkový soubor kódu

Tento ukázkový soubor kódu Pythonu, který ukazuje základní volání rozhraní API pro dokončování chatu. Volání je synchronní:

Interakce s modely pomocí modelového hřiště

Chatujte interaktivně s modelem, změňte nastavení a systémové pokyny pomocí modelového hřiště.

Model Playground je k dispozici v sekci Nástroje v zobrazení Rozšíření Foundry. Poklikáním na odkaz Model Playground otevřete Model Playground.

Pomocí následujících kroků můžete také otevřít modelové hřiště:

1. Klikněte pravým tlačítkem na nasazený model a vyberte možnost Otevřít v dětském hřišti .

   

2. Zobrazí se stránka Dětské hřiště .

   

3. Zadejte výzvu a zobrazte výstupy.

4. Kromě toho můžete pomocí kódu Zobrazení v pravém horním rohu zobrazit podrobnosti o tom, jak získat přístup k nasazení modelu prostřednictvím kódu programu.

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

Úklid zdrojů

Prostředky Azure, které jste vytvořili v tomto článku, se účtují vašemu předplatnému 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 a zobrazte seznam nasazených modelů.

2. Kliknutím pravým tlačítkem myši na nasazený model odstraňte a vyberte možnost Odstranit .

   

Smažte své nástroje

Pomocí následujících kroků odstraňte připojený nástroj:

1. Otevřete Azure Portal.
2. Vyberte skupinu prostředků Azure obsahující nástroj.
3. Vyberte tlačítko Odstranit .

Další kroky

• Přečtěte si o práci se službou agenta pomocí tohoto rozšíření editoru Visual Studio Code.