Az Azure Logic Apps meghívása függvényként az Azure OpenAI Assistants használatával
Feljegyzés
Ez a funkció jelenleg csak az Azure OpenAI Studióban érhető el.
Az Azure Logic Apps egy integrációs platform az Azure-ban, amely lehetővé teszi alkalmazások és automatizálási munkafolyamatok létrehozását alacsony kódszámú eszközökkel, amelyek lehetővé teszik a fejlesztők termelékenységét és gyorsabb piacra kerülését. A vizualizációtervező használatával és több száz előre összeállított összekötő közül kiválasztva gyorsan létrehozhat egy munkafolyamatot, amely integrálja és kezeli az alkalmazásokat, adatokat, szolgáltatásokat és rendszereket.
Az Azure Logic Apps teljes mértékben a Microsoft Azure felügyelete alá tartozik, így nem kell aggódnia a szolgáltatásokkal létrehozott megoldások üzemeltetése, skálázása, kezelése, monitorozása és karbantartása miatt. Ha ezeket a képességeket kiszolgáló nélküli alkalmazások és megoldások létrehozására használja, csak az üzleti logikára és funkciókra összpontosíthat. Ezek a szolgáltatások automatikusan skálázódnak az igényeinek megfelelően, felgyorsítják az automatizálási munkafolyamatokat, és segítenek robusztus felhőalkalmazások létrehozásában, alig-alig kód nélkül.
Függvényhívás az Azure Logic Appsben az Asszisztensek játszótéren keresztül
Az intelligens alkalmazások létrehozásának felgyorsítása és egyszerűsítése érdekében mostantól lehetővé tesszük a Logic Apps-munkafolyamatok meghívását az Azure OpenAI asszisztensek függvényhívásával.
Az Asszisztensek játszótér felsorolja és felsorolja az előfizetés összes olyan munkafolyamatát, amely jogosult a függvényhívásra. A munkafolyamatok követelményei a következők:
- Használatalapú Logic Apps: Jelenleg csak a használatalapú munkafolyamatokat támogatjuk.
- Kérelem-eseményindító: A függvényhíváshoz REST-alapú API szükséges. A kérelem-eseményindítóval rendelkező Logic Apps REST-végpontot biztosít. Ezért csak a kérelem-eseményindítóval rendelkező munkafolyamatok támogatottak a függvényhívásokhoz.
- Séma: A függvényhíváshoz használni kívánt munkafolyamatoknak JSON-sémával kell rendelkezniük, amely leírja a bemeneteket és a várt kimeneteket. A Logic Apps használatával egyszerűsítheti és biztosíthatja a sémát az eseményindítóban, amelyet a rendszer automatikusan importál függvénydefinícióként.
Ha már rendelkezik a fenti követelménynek megfelelő munkafolyamatokkal, használhatja azokat az Azure OpenAI Studióban, és felhasználói kérésekkel hívhatja meg azokat. Ha nem rendelkezik meglévő munkafolyamatokkal, az ebben a cikkben ismertetett lépéseket követve hozhatja létre azokat. Két elsődleges lépés létezik:
- Logikai alkalmazás létrehozása az Azure Portalon.
- Importálja a Logic Apps-munkafolyamatokat függvényként az Asszisztensek játszótéren.
Logic Apps-munkafolyamatok létrehozása függvényhíváshoz
Az alábbiakban egy új Logic Apps-munkafolyamatot hozhat létre a függvényhíváshoz.
Az Azure Portal keresőmezőjében adja meg a logikai alkalmazásokat, és válassza a Logikai alkalmazások lehetőséget.
A Logic Apps lap eszköztárán válassza a Hozzáadás lehetőséget.
A Logikai alkalmazás létrehozása lapon először válassza ki a logikai alkalmazás erőforrásának csomagtípusát. Így csak az adott csomagtípus beállításai jelennek meg.
A Terv szakaszban a Terv típusnál válassza a Felhasználás lehetőséget, hogy csak a használatlogika alkalmazás erőforrás-beállításait tekintse meg.
Adja meg a következő információkat a logikaialkalmazás-erőforrásról: előfizetés, erőforráscsoport, logikai alkalmazás neve és régiója.
Ha elkészült, válassza a Véleményezés + Létrehozás lehetőséget.
A megjelenő érvényesítési lapon erősítse meg az összes megadott információt, és válassza a Létrehozás lehetőséget.
Miután az Azure sikeresen üzembe helyezi a logikaialkalmazás-erőforrást, válassza az Ugrás az erőforrásra lehetőséget. A logikai alkalmazás erőforrásának megkereséséhez és kiválasztásához írja be a nevet az Azure keresőmezőbe.
Nyissa meg a Logic Apps-munkafolyamatot a tervezőben. Válassza a Fejlesztői eszközök + Logikai alkalmazás tervezője lehetőséget. Ez megnyitja az üres munkafolyamatot a tervezőben. Vagy az Üres logikai alkalmazás lehetőséget választja a sablonokból
Most már készen áll egy újabb lépés hozzáadására a munkafolyamatban. A munkafolyamatok mindig egyetlen eseményindítóval kezdődnek, amely meghatározza a teljesítendő feltételt, mielőtt bármilyen további műveletet futtat a munkafolyamatban.
A munkafolyamatnak rendelkeznie kell egy kérelem-eseményindítóval a REST-végpont létrehozásához, és egy válaszműveletre, amely a munkafolyamat meghívásakor visszaadja a választ az Azure OpenAI Studiónak.
Eseményindító hozzáadása (kérés)
Válassza az Eseményindító hozzáadása lehetőséget, majd keresse meg a kérelem eseményindítót. Válassza ki a HTTP-kérés fogadása műveletet.
Adja meg a kérelem JSON-sémáját. Ha nem rendelkezik a sémával, használja a séma létrehozásának lehetőségét.
Íme egy példa a kérelemsémára. A munkafolyamat leírását a megjegyzésmezőbe is felveheti. Ezt az Azure OpenAI Studio importálja a függvény leírásaként.
Mentse a munkafolyamatot. Ez létrehozza a munkafolyamat REST-végpontja.
Az üzleti használati esettől függően mostantól hozzáadhat egy vagy több lépést/műveletet ebben a munkafolyamatban. Az MSN időjárás-összekötő használatával például lekérheti az aktuális hely időjárás-előrejelzését.
A mai napra vonatkozó előrejelzési műveletben a munkafolyamatnak átadott helytulajdonságot használjuk bemenetként.
Konfigurálja a választ. A munkafolyamatnak vissza kell adnia a választ az Azure OpenAI Studiónak. Ez válaszművelet használatával történik.
A válaszműveletben kiválaszthatja a kimenetet az előző lépések bármelyikéből. JSON-sémát is megadhat, ha a kimenetet egy adott formátumban szeretné visszaadni.
A munkafolyamat készen áll. Az Azure OpenAI Studióban a Függvény hozzáadása funkcióval importálhatja ezt a függvényt az Asszisztensek játszótéren.
Logic Apps-munkafolyamatok importálása függvényként
A Logic Apps-munkafolyamatok funkcióként való importálásának lépései az Azure OpenAI Studióban található Assistants-játszótéren:
Az Azure OpenAI Studióban válassza az Asszisztensek lehetőséget. Válasszon ki egy meglévő asszisztenst, vagy hozzon létre egy újat. Miután konfigurálta az asszisztenst egy névvel és utasítással, készen áll egy függvény hozzáadására. Válassza a +Függvény hozzáadása lehetőséget.
A Függvény hozzáadása lehetőség két lapfület tartalmazó képernyőt nyit meg. Lépjen a Logic Apps lapjára a munkafolyamatok megkeresési eseményindítóval való tallózásához. Válassza ki a munkafolyamatot a listából, és válassza a Mentés lehetőséget.
Feljegyzés
Ez a lista csak a használati termékváltozat munkafolyamatait jeleníti meg, valamint egy kérelem-eseményindítót.
Sikeresen importálta a munkafolyamatot, és készen áll a meghívásra. A függvény specifikációja a logic apps munkafolyamat-swaggere alapján jön létre, és tartalmazza a sémát és a leírást a kérelem-eseményindító műveletben konfiguráltak alapján.
A munkafolyamatot most az Azure OpenAI Assistants hívja meg a felhasználói kérés alapján. Az alábbiakban egy példa látható, ahol a rendszer automatikusan meghívja a munkafolyamatot a felhasználói kérések alapján az időjárás lekéréséhez.
A meghívást a naplók és a munkafolyamat-futtatási előzmények megtekintésével ellenőrizheti.
GYIK
Mik azok a logikai Alkalmazás-összekötő?
Az Azure Logic Apps több száz üzletági (LOB) alkalmazáshoz és adatbázishoz tartalmaz összekötőket, többek között az SAP, a Salesforce, az Oracle, az SQL stb. Az SaaS-alkalmazásokhoz vagy a virtuális hálózatokon üzemeltetett házon belüli alkalmazásokhoz is csatlakozhat. Ezek a dobozon kívüli összekötők olyan műveleteket biztosítanak, hogy több formátumban küldjenek és fogadjanak adatokat. Ezeket a képességeket az Azure OpenAI-asszisztensekkel kihasználva gyorsan elérhetővé kell tenni az Adatokat az Azure OpenAI által működtetett Intelligent Insightshoz.
Mi történik, ha egy Logic Apps-alkalmazást importál az Azure OpenAI Studióba, és meghívja?
A Logic Apps swagger-fájlja függvénydefiníciók feltöltésére szolgál. Az Azure Logic App egy OpenAPI 2.0-definíciót (swagger) tesz közzé olyan munkafolyamatokhoz, amelyekhez a munkafolyamat széljegyzetei alapján egy kérelem-eseményindító tartozik. A felhasználók a munkafolyamatuk frissítésével módosíthatják a swagger tartalmát. Az Azure OpenAI Studio ezzel hozza létre az asszisztens által igényelt függvénydefiníciókat.
Hogyan működik az Azure OpenAI Studio és a Logic Apps közötti hitelesítés?
A Logic Apps két elsődleges hitelesítéstípust támogat a kérelem-eseményindítók meghívásához.
Közös hozzáférésű jogosultságkód (SAS) alapú hitelesítés.
A felhasználók az SAS-t tartalmazó visszahívási URL-címet a lista visszahívási URL API-jának használatával szerezhetik be. A Logic Apps emellett több kulcs használatát is támogatja, és szükség szerint elforgatja őket. A Logic Apps emellett támogatja az SAS-URL-címek létrehozását egy megadott érvényességi időtartammal. További információkért tekintse meg a Logic Apps dokumentációját.
Microsoft Entra ID-alapú OAuth-alapú hitelesítési szabályzat.
A Logic Apps a Microsoft Entra ID OAuth használatával is támogatja a hitelesítési triggerek meghívását, ahol megadhatja az OAuth-jogkivonatok érvényesítéséhez használandó hitelesítési szabályzatokat. További információkért tekintse meg a Logic Apps dokumentációját.
Ha az Azure OpenAI Assistants megköveteli egy logikai alkalmazás meghívását a függvényhívás részeként, az Azure OpenAI Studio lekéri a visszahívási URL-címet a SAS-vel a munkafolyamat meghívásához.