Sdílet prostřednictvím


Začínáme s projekty Azure AI Studio ve VS Code (Preview)

Důležité

Některé funkce popsané v tomto článku můžou být dostupné jenom ve verzi Preview. Tato verze Preview je poskytována bez smlouvy o úrovni služeb a nedoporučujeme ji pro produkční úlohy. Některé funkce se nemusí podporovat nebo mohou mít omezené možnosti. Další informace najdete v dodatečných podmínkách použití pro verze Preview v Microsoft Azure.

Azure AI Studio podporuje vývoj v nástroji VS Code – Desktop a Web. V každém scénáři je vaše instance VS Code vzdáleně připojená k předem připravenému vlastnímu kontejneru běžícímu na virtuálním počítači, kterému se říká také výpočetní instance.

Spuštění VS Code z Azure AI Studia

  1. Přejděte do Azure AI Studia.

  2. Otevřete projekt v Azure AI Studiu.

  3. V nabídce vlevo vyberte Kód.

  4. V části Compute vyberte existující výpočetní instanci nebo vytvořte novou.

    • Vyberte výpočetní instanci, která se má použít. Pokud je zastavený, vyberte Spustit výpočetní prostředky a počkejte, až se přepne na Spuštěno. Jakmile je výpočetní prostředí připravené k použití, uvidíte stav Připraveno .
    • Pokud nemáte výpočetní instanci, zadejte název a vyberte Vytvořit výpočetní prostředky. Počkejte, až bude výpočetní instance připravená.
  5. V případě kontejneru VS Code vyberte po povolení tlačítka nastavit kontejner . Tím se kontejner nakonfiguruje na výpočetních prostředcích za vás. Dokončení instalace kontejneru může trvat několik minut. Jakmile kontejner poprvé nastavíte, můžete hned spustit následující časy. Po zobrazení výzvy možná budete muset ověřit výpočetní prostředky. Po dokončení instalace se zobrazí připraveno.

    Upozorňující

    I když ve výpočetní instanci povolíte vypnutí nečinnosti, nedojde k vypnutí nečinnosti pro žádné výpočetní prostředky, které jsou nastavené pomocí tohoto vlastního kontejneru VS Code. Tím zajistíte, že se výpočetní prostředky neočekávaně nevypnou, když pracujete v rámci kontejneru.

  6. Otevřete projekt ve VS Code:

    • Pokud chcete pracovat v místní instanci VS Code, zvolte Spustit v editoru VS Code (Desktop). Na místním počítači se otevře nová místní instance nástroje VS Code.
    • Pokud chcete místo toho pracovat v prohlížeči, vyberte šipku rozevíracího seznamu a zvolte Spustit v editoru VS Code (web). Otevře se nová karta prohlížeče připojená k vscode.dev .

    Snímek obrazovky se stránkou Work in VS Code (Práce na stránce VS Code) připravenou ke spuštění

Struktura vlastních složek kontejneru

Naše předem připravená vývojová prostředí jsou založená na kontejneru Dockeru, který obsahuje sady Azure AI SDK, sadu SDK toku výzvy a další nástroje. Prostředí je nakonfigurované tak, aby v kontejneru vzdáleně spouštět VS Code. Kontejner se definuje podobným způsobem jako tento soubor Dockerfile a je založený na imagi vývojového kontejneru Pythonu 3.10 Od Microsoftu.

Průzkumník souborů se otevře v konkrétním adresáři projektu, který jste spustili v AI Studiu.

Kontejner se konfiguruje s hierarchií složek Azure AI (afh adresář), která je navržená tak, aby vás orientovala v aktuálním vývojovém kontextu a pomohla vám pracovat s kódem, daty a sdílenými soubory co nejefektivněji. Tento afh adresář obsahuje projekty Azure AI Studio a každý projekt má vyhrazený adresář projektu, který obsahuje code, dataa shared složky.

Tato tabulka shrnuje strukturu složek:

Složka Popis
code Slouží k práci s úložišti Git nebo soubory místního kódu.

Složka code je umístění úložiště přímo ve vaší výpočetní instanci a výkonné pro velká úložiště. Je to ideální umístění pro klonování úložišť Git nebo jinak přineste nebo vytvořte soubory kódu.
data Slouží k ukládání místních datových souborů. Doporučujeme používat data složku k ukládání a odkazování na místní data konzistentním způsobem.
shared Slouží k práci se sdílenými soubory a prostředky projektu, jako jsou například toky výzvy.

Tady například shared\Users\{user-name}\promptflow najdete toky výzvy projektu.

Důležité

Doporučuje se pracovat v tomto adresáři projektu. Soubory, složky a úložiště, které zahrnete do adresáře projektu, se zachovají na hostitelském počítači (výpočetní instance). Soubory uložené v kódu a datových složkách se zachovají i v případě, že se výpočetní instance zastaví nebo restartuje, ale při odstranění výpočetních prostředků se ztratí. Sdílené soubory se ale ukládají do účtu úložiště vašeho centra, a proto se při odstranění výpočetní instance neztratí.

Práce s toky výzvy

Můžete vytvářet, odkazovat a pracovat s toky výzvy.

Toky výzvy, které už jsou vytvořené v nástroji Azure AI Studio, najdete na adrese shared\Users\{user-name}\promptflow. Můžete také vytvořit nové toky ve své složce nebo shared ve složcecode.

Tok výzvy automaticky používá připojení Azure AI Studio, ke které má váš projekt přístup.

Můžete také pracovat s rozšířením toku výzvy v editoru VS Code, který je v tomto prostředí předinstalovaný. V rámci tohoto rozšíření můžete nastavit poskytovatele připojení pro váš projekt. Podívejte se na využití připojení z Azure AI.

Další informace najdete v tématu Možnosti toku výzvy.

Použití šablon aplikací AI

Šablony aplikací AI jsou propojeny z pravé strany karty Kód projektu. Tyto ukázky vás provedou používáním sad Azure AI SDK k těmto krokům:

  • Nastavení vývojového prostředí a připojení k existujícím prostředkům
  • Přenesení vlastního kódu aplikace
  • Spuštění vyhodnocení
  • Nasazení kódu

Pokud chcete zřídit zcela novou sadu prostředků, včetně nového centra a projektu, a nasadit tyto ukázkové aplikace, můžete použít Azure Developer CLI (AZD) ve svém místním vývojovém prostředí.

Poznámky

Pokud plánujete pracovat s více adresáři kódu a dat nebo několika úložišti, můžete ve VS Code použít funkci rozděleného kořenového průzkumníka souborů. Pokud chcete vyzkoušet tuto funkci, postupujte takto:

  1. Stisknutím kombinace kláves Ctrl+Shift+p otevřete paletu příkazů. Vyhledejte a vyberte Pracovní prostory: Přidat složku do pracovního prostoru.
  2. Vyberte složku úložiště, kterou chcete načíst. V Průzkumníku souborů byste měli vidět nový oddíl pro složku, kterou jste otevřeli. Pokud se jednalo o úložiště, můžete teď pracovat se správou zdrojového kódu ve VS Code.
  3. Pokud chcete uložit tuto konfiguraci pro budoucí vývojové relace, znovu zadejte Ctrl+Shift+p a vyberte Pracovní prostory: Uložit pracovní prostor jako. Tato akce uloží konfigurační soubor do aktuální složky.

Šablony aplikací a ukázky sady SDK v preferovaném programovacím jazyce najdete v tématu Vývoj aplikací, které používají služby Azure AI.