Začínáme s Azure OpenAI s asistenty a voláním funkcí v JavaScriptu

Tento článek ukazuje, jak nasadit a spustit Rychlý start bezserverového asistenta Azure OpenAI. Tato ukázka implementuje aplikaci asistentů pomocí JavaScriptu, pomocníků služby Azure OpenAI s voláním funkcí a Azure Functions.

Přehled architektury

Asistenti Azure OpenAI umožňují vytvářet asistenty umělé inteligence přizpůsobené vašim potřebám prostřednictvím vlastních pokynů a rozšířené pokročilými nástroji, jako je interpret kódu a vlastní funkce. V tomto článku poskytujeme podrobný návod, jak začít s rozhraním API asistentů.

Diagram znázorňující architekturu od klienta k backendové aplikaci.

Tato aplikace je postavená na dvou hlavních komponentách:

  • Jednoduchá stránka HTML se základními soubory CSS a JavaScriptu, hostovaná v Azure Static Web Apps.

  • Bezserverové API vytvořené pomocí Azure Functions a využívající OpenAI JavaScript SDK. Aplikace bez serveru odešle definici asistentů včetně volání funkce do koncového bodu OpenAI. Koncový bod odpoví voláním následné funkce a parametry potřebnými k dokončení tohoto volání.

    • Volání funkce v ukázce simuluje volání rozhraní API tím, že na základě burzovního symbolu odeslaného do funkce Azure Function vygeneruje náhodnou hodnotu akcie. Tuto simulaci můžete ve svém řešení nahradit vzdáleným rozhraním API.

    Diagram znázorňující integraci služby Azure Functions se službou Azure OpenAI, kde může Azure OpenAI vracet názvy navazujících funkcí, které má služba Azure Functions volat.

Požadavky

Prostředí vývojového kontejneru je k dispozici se všemi závislostmi požadovanými k dokončení tohoto článku. Vývojový kontejner můžete spustit v GitHub Codespaces (v prohlížeči) nebo místně pomocí editoru Visual Studio Code.

Pokud chcete použít tento článek, potřebujete následující požadavky:

  1. Předplatné Azure – Vytvořte si ho zdarma
  2. Oprávnění účtu Azure – Váš účet Azure musí mít oprávnění Microsoft.Authorization/roleAssignments/write, například User Access Administrator nebo Owner.
  3. Účet GitHubu.

Otevřené vývojové prostředí

Podle následujících pokynů nasaďte předkonfigurované vývojové prostředí obsahující všechny požadované závislosti pro dokončení tohoto článku.

GitHub Codespaces provozuje vývojový kontejner spravovaný GitHubem s Visual Studio Code pro web jako uživatelským rozhraním. Pro nejjednodušší vývojové prostředí použijte GitHub Codespaces, abyste měli předinstalované správné vývojářské nástroje a závislosti k dokončení tohoto článku.

Důležité

Všechny účty GitHubu můžou každý měsíc používat Codespaces až 60 hodin zdarma se dvěma základními instancemi. Další informace viz GitHub Codespaces – měsíční zahrnuté úložiště a hodiny jader.

  1. Spusťte proces vytvoření nového prostoru GitHub Codespace ve větvi main úložiště GitHub Azure-Samples/azure-openai-assistant-javascript.

  2. Klikněte pravým tlačítkem na následující tlačítko a vyberte Otevřít odkaz v nových oknech, abyste měli k dispozici vývojové prostředí i dokumentaci najednou.

    Otevřít v GitHub Codespaces

  3. Na stránce Create codespace (Vytvořit kódový prostor) zkontrolujte nastavení konfigurace codespace a pak vyberte Create new codespace (Vytvořit nový prostor kódu).

  4. Počkejte, až se codespace spustí. Tento proces spuštění může trvat několik minut.

  5. Přihlaste se k Azure pomocí Azure Developer CLI v terminálu v dolní části obrazovky.

    azd auth login

  6. Zkopírujte kód z terminálu a vložte ho do prohlížeče. Postupujte podle pokynů k ověření pomocí účtu Azure.

  7. Zbývající úlohy v tomto článku probíhají v kontextu tohoto vývojového kontejneru.

Nasazení a spuštění

Ukázkové úložiště obsahuje veškerý kód a konfigurační soubory, které potřebujete k nasazení aplikace funkcí do Azure. Následující kroky vás provedou procesem nasazení ukázky do Azure.

Nasazení aplikace Assistants do Azure

Důležité

Prostředky Azure vytvořené v této části znamenají okamžité náklady, zejména kvůli prostředku Azure AI Vyhledávač. Tyto prostředky mohou způsobit náklady, i když přerušíte příkaz, než je dokončen.

  1. Spuštěním následujícího příkazu Azure Developer CLI zřiďte prostředky Azure a nasaďte zdrojový kód:

    azd up

  2. Když se zobrazí výzva k zadání názvu prostředí, ponechte ho krátkým a malými písmeny. Například myenv. Používá se jako součást názvu skupiny prostředků.

  3. Po zobrazení výzvy vyberte předplatné, ve které chcete prostředky vytvořit.

  4. Když se zobrazí výzva k prvnímu výběru umístění, vyberte umístění blízko vás. Toto umístění se používá pro většinu prostředků včetně hostingu.

  5. Pokud se zobrazí výzva k zadání umístění modelu OpenAI, vyberte umístění, které je blízko vás. Pokud je stejné umístění dostupné jako vaše první umístění, vyberte ho.

  6. Počkejte, až se aplikace nasadí. Dokončení nasazení může trvat 5 až 10 minut.

  7. Po úspěšném nasazení aplikace se v terminálu zobrazí adresa URL.

  8. Vyberte tuto adresu URL označenou jako Deploying service web a otevřete aplikaci asistenta v prohlížeči.

Použití aplikace Assistant

Pomocí aplikace Assistant získejte cenu burzovního MSFTtrhu . Následující kroky vás provedou procesem používání aplikace Assistant. Asistent vám může poslat odpovědi e-mailem. Vzhledem k tomu, že funkce odesílání e-mailů není nakonfigurovaná, upravte výzvu tak, aby tuto instrukci nepoužít.

  1. V prohlížeči zkopírujte a vložte následující výzvu:

    Based on the latest financial data and current stock market trends, can you provide a detailed analysis of Microsoft's current state? Please include insights into their recent performance, market position, and future outlook. Additionally, retrieve and include the latest closing price of Microsoft's stock using its ticker symbol (MSFT).

  2. Vyberte tlačítko Run (Spustit). Výsledky by měly vypadat podobně jako následující odpověď.

    Snímek obrazovky první odpovědi aplikace asistenta.

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

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

Prostředky Azure vytvořené v tomto článku se fakturují k 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ů.

Spuštěním následujícího příkazu Azure Developer CLI odstraňte prostředky Azure a odeberte zdrojový kód:

azd down --purge

Vyčištění služby GitHub Codespaces

Odstraněním prostředí GitHub Codespaces zajistíte, že budete moci pro svůj účet využít co nejvíce bezplatných hodin na jádro, které máte k dispozici.

Důležité

Další informace o nárocích vašeho účtu GitHub najdete v tématu GitHub Codespaces – měsíčně zahrnuté úložiště a hodiny jader.

  1. Přihlaste se k řídicímu panelu GitHub Codespaces .

  2. Vyhledejte aktuálně spuštěné Codespaces pocházející z úložiště GitHubu Azure-Samples/azure-openai-assistant-javascript.

    Snímek obrazovky všech spuštěných Codespaces včetně jejich stavu a šablon.

  3. Otevřete kontextovou nabídku ... u codespace a potom vyberte možnost Odstranit.

Získání pomoci

Tento ukázkový repozitář nabízí informace k řešení potíží.

Pokud váš problém nebyl vyřešen, nahlaste ho do Issues v úložišti.

Související obsah

  • Last updated on