Ismerkedés az Azure OpenAI-val az Asszisztensekkel és függvényhívásokkal JavaScriptben

Ez a cikk bemutatja, hogyan helyezheti üzembe és futtathatja a serverless Azure OpenAI Assistant Quick Start projektet. Ez a minta egy segédalkalmazást implementál a JavaScript, az Azure OpenAI Service-asszisztensek függvényhívással és az Azure Functions használatával.

Architekturális áttekintés

Az Azure OpenAI Assistants lehetővé teszi az igényeinek megfelelő AI-asszisztensek létrehozását egyéni utasításokon keresztül, fejlett eszközökkel, például kódértelmeztetőkkel és egyéni funkciókkal kiegészítve. Ebben a cikkben részletesen bemutatjuk az Assistants API használatának első lépéseit.

Ez az alkalmazás két fő összetevőből áll:

• Egy egyszerű HTML-oldal natív CSS- és JavaScript-fájlokkal, amely a Azure Static Web Apps szolgáltatásban van üzemeltetve.

• Azure Functions-re épülő, az OpenAI JavaScript SDK-t használó kiszolgáló nélküli API. A kiszolgáló nélküli alkalmazás elküldi az asszisztensek definícióját, beleértve a függvényhívást az OpenAI-végpontnak. A végpont a követő függvény hívásával és a hívás végrehajtásához szükséges paraméterekkel válaszol.

  • A minta függvényhívása egy API-hívást szimulál úgy, hogy létrehoz egy véletlenszerű tőzsdei ticker értéket az Azure-függvénybe küldött részvényszimbólum alapján. Ez a szimuláció lecserélhető egy távoli API-ra a megoldásban.

  

Előfeltételek

Elérhető egy fejlesztői tároló, amely a cikk elvégzéséhez szükséges összes függőséget tartalmazza. A fejlesztői tárolót a GitHub Codespacesben (böngészőben) vagy helyileg is futtathatja a Visual Studio Code használatával.

A cikk használatához a következő előfeltételekre van szüksége:

Codespaces (ajánlott)

1. Egy Azure-előfizetés – Hozzon létre egyet ingyenesen
2. Azure-fiókengedélyek – Az Azure-fióknak Microsoft.Authorization/roleAssignments/write engedélyekkel kell rendelkeznie, például felhasználói hozzáférési rendszergazda vagy tulajdonos.
3. Egy GitHub-fiók.

Visual Studio Code

1. Egy Azure-előfizetés – Hozzon létre egyet ingyenesen
2. Azure-fiókengedélyek – Az Azure-fióknak Microsoft.Authorization/roleAssignments/write engedélyekkel kell rendelkeznie, például felhasználói hozzáférési rendszergazda vagy tulajdonos.
3. Azure fejlesztői parancssori felület
4. Docker Desktop – Indítsa el a Docker Desktopot, ha még nem fut
5. Git
6. Visual Studio Code
7. Fejlesztői konténer bővítmény

Nyílt fejlesztési környezet

A cikk elvégzéséhez használja az alábbi utasításokat egy előre konfigurált fejlesztési környezet üzembe helyezéséhez, amely tartalmazza az összes szükséges függőséget.

GitHub Codespaces (ajánlott)

A GitHub Codespaces egy GitHub által felügyelt fejlesztési tárolót futtat, amelynek felhasználói felülete a Visual Studio Code for the Web. A legegyszerűbb fejlesztési környezethez használja a GitHub Codespacest, hogy a megfelelő fejlesztői eszközökkel és függőségekkel rendelkezzen a cikk elvégzéséhez.

Fontos

Minden GitHub-fiók legfeljebb 60 órán át használhatja a Codespace-eket havonta két alapvető példánnyal. További információkért lásd a következőt: GitHub Codespaces havonta foglalt tárterülete és magórái.

1. Indítsa el az új GitHub Codespace létrehozásának folyamatát a main GitHub-adattár Azure-Samples/azure-openai-assistant-javascript ágán.

2. Kattintson a jobb gombbal a következő gombra, és válassza a Hivatkozás megnyitása új ablakban lehetőséget, hogy a fejlesztési környezet és a dokumentáció egyszerre legyen elérhető.

   

3. A Kódtér létrehozása lapon tekintse át a kódtér konfigurációs beállításait, majd válassza az Új kódtér létrehozása lehetőséget

4. Várja meg, amíg a Codespace elindul. Ez az indítási folyamat eltarthat néhány percig.

5. Jelentkezzen be az Azure-ba az Azure Developer CLI-vel a képernyő alján található terminálon.

   azd auth login
   

6. Másolja ki a kódot a terminálból, majd illessze be egy böngészőbe. Kövesse az utasításokat az Azure-fiókkal való hitelesítéshez.

7. A cikkben szereplő fennmaradó feladatok ennek a fejlesztési tárolónak a kontextusában történnek.

Visual Studio Code

A Visual Studio Code Dev Containers bővítményének használatához telepíteni kell a Dockert a helyi gépére. A bővítmény helyileg üzemelteti a fejlesztési tárolót a Docker-gazdagép használatával a cikk elvégzéséhez előre telepített megfelelő fejlesztői eszközökkel és függőségekkel.

1. A mintatároló forkolásához válassza ezt a Azure-Samples/azure-openai-assistant-javascript hivatkozást.

2. Klónozza az elágazás adattárát. Cserélje le a(z) <github-username> elemet a GitHub-fiókja nevére.

   git clone https://github.com/<github-username>/azure-openai-assistant-javascript
   

3. Nyissa meg a Visual Studio Code-ot az új mappában.

   cd azure-openai-assistant-javascript
   code .
   

4. Győződjön meg arról, hogy a Visual Studio Code-ban telepítve van a Dev Containers bővítmény.

5. Nyisson meg egy új terminált a szerkesztőben.

   Tipp

   A főmenüben keresse meg a Terminál menüt, majd válassza az Új terminál lehetőséget.

   

6. Jelentkezzen be az Azure-ba az Azure Developer CLI használatával.

   azd auth login
   

   Másolja ki a kódot a terminálból, majd illessze be egy böngészőbe. Kövesse az utasításokat az Azure-fiókkal való hitelesítéshez.

7. Nyissa meg a parancskatalógust, keresse meg a Dev Containers parancsokat, majd válassza a Dev Containers: Újranyitás a tárolóban lehetőséget.

   Tipp

   Előfordulhat, hogy a Visual Studio Code automatikusan megkéri, hogy nyissa meg újra a meglévő mappát egy fejlesztői tárolóban. Ez a művelet funkcionálisan egyenértékű a parancskatalógus használatával a tároló aktuális munkaterületének újbóli megnyitásához.

8. Nyissa meg újra a Terminálablakot (Ctrl + `), és hagyja nyitva.

9. A projekt hátralévő gyakorlatai ennek a fejlesztési tárolónak a kontextusában történnek.

Üzembe helyezés és futtatás

A mintaadattár tartalmazza a függvényalkalmazás Azure-ban való üzembe helyezéséhez szükséges összes kódot és konfigurációs fájlt. Az alábbi lépések végigvezetik a minta Azure-ban való üzembe helyezésének folyamatán.

Asszisztensek alkalmazás üzembe helyezése az Azure-ban

Fontos

Az ebben a szakaszban létrehozott Azure-erőforrások azonnali költségekkel járnak, elsősorban az Azure AI Keresés-erőforrásból. Ezek az erőforrások költséggel járhatnak, még akkor is, ha megszakítja a parancsot, mielőtt az befejeződne.

1. Futtassa a következő Azure Developer CLI-parancsot az Azure-erőforrások kiépítéséhez és a forráskód üzembe helyezéséhez:

   azd up
   

2. Amikor a rendszer kéri, hogy adjon meg egy környezetnevet, tartsa rövid és kisbetűsként. Például: myenv. Az erőforráscsoport nevének részeként használják.

3. Amikor a rendszer kéri, válasszon ki egy előfizetést az erőforrások létrehozásához.

4. Amikor a rendszer első alkalommal kéri egy hely kiválasztását, válasszon ki egy Önhöz közeli helyet. Ezt a helyet használják a legtöbb erőforráshoz, beleértve az üzemeltetést is.

5. Ha a rendszer az OpenAI-modell helyét kéri, válasszon egy Önhöz közeli helyet. Ha ugyanaz a hely érhető el, mint az első hely, válassza ezt.

6. Várja meg az alkalmazás üzembe helyezését. Az üzembe helyezés befejezése 5–10 percet is igénybe vehet.

7. Az alkalmazás sikeres üzembe helyezése után megjelenik egy URL-cím a terminálban.

8. Válassza ki a Deploying service web címkével ellátott URL-címet, hogy böngészőben megnyissa a segédalkalmazást.

Az asszisztens alkalmazás használata

Használja az asszisztens alkalmazást a tőzsdei árfolyam lekéréséhez MSFT. Az alábbi lépések végigvezetik a segédalkalmazás használatának folyamatán. Az asszisztens e-mailben is elküldheti a válaszokat. Mivel az e-mail-küldési funkció nincs konfigurálva, módosítsa a kérést, hogy ne használja ezt az utasítást.

1. A böngészőben másolja és illessze be a következő parancssorba:

   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. Válassza ki a Futtatás gombot. Az eredményeknek az alábbi válaszhoz hasonlóan kell kinéznie.

   

Erőforrások törlése

Azure-erőforrások tisztítása

A cikkben létrehozott Azure-erőforrásokat az Azure-előfizetésére terhelik. Ha a jövőben nem lesz szüksége ezekre az erőforrásokra, törölje őket, hogy elkerülje a további költségek felmerülését.

Futtassa a következő Azure Developer CLI-parancsot az Azure-erőforrások törléséhez és a forráskód eltávolításához:

azd down --purge

A GitHub Codespaces törlése

GitHub Codespaces

A GitHub Codespaces-környezet törlése biztosítja, hogy maximálisan kihasználható legyen a fiókhoz tartozó ingyenes óránkénti jogosultság.

Fontos

A GitHub-fiókja jogosultságairól további információt a GitHub Codespaces havonta foglalt tárterület és alapórák című cikkben talál.

1. Jelentkezzen be a GitHub Codespaces vezérlőpultjára.

2. Keresse meg a Azure-Samples/azure-openai-assistant-javascript GitHub-tárházból származó, jelenleg futó Codespaces-környezeteket.

   

3. Nyissa meg a kódtérhez tartozó helyi menüt, ..., majd válassza a Delete lehetőséget.

Visual Studio Code

Nem feltétlenül szükséges a helyi környezet megtisztítása, de leállíthatja a futó fejlesztési tárolót, és visszatérhet a Visual Studio Code futtatásához egy helyi munkaterület környezetében.

1. Nyissa meg a Parancskatalógust, keressen rá a Dev Containers parancsokra, majd válassza a Dev Containers: Mappa újbóli megnyitása helyben lehetőséget.

   

Tipp

Miután a Visual Studio Code leállította a futó fejlesztői tárolót, a tároló továbbra is leállítva állapotban van a Dockerben. Törölheti a tárolópéldányt, a tárolórendszerképet és a köteteket a Dockerből, hogy több helyet szabadítson fel a helyi gépen.

Segítség kérése

Ez a mintatároló hibaelhárítási információkat tartalmaz.

Ha a problémáját nem oldották meg, jelentse azt a tároló Issues részében.

Kapcsolódó tartalom

• Mi az Azure OpenAI Assistants API?