A Botpress műveleteinek megértése
A Botpress műveletei szerveroldali funkciók, amelyeket a bot a beszélgetési folyamatok során hajt végre. Lehetőségük van megváltoztatni a beszélgetés állapotát, testreszabott üzeneteket küldeni, tetszőleges kódot futtatni (például az API-k meghívását vagy az adatok tárolását), és így tovább. A műveletek lényegében szokásos JavaScript-függvények, ami azt jelenti, hogy szinte bármit végrehajthatnak a platform korlátain belül.
Amikor a Dialogue Manager (DM) meghív egy műveletet, számos argumentumot kap, amelyek kontextust biztosítanak a funkcióhoz. Ezek az argumentumok a felhasználói attribútumokat, a munkamenet-változókat, az ideiglenes változókat, a bot-szintű változókat, a beszélgetés legfrissebb felhasználói eseményét, a Visual Flow Builder átadott argumentumait és a néhány környezeti változót tartalmazó sandbox virtuális gépet tartalmazzák.
Új műveletek regisztrálása
Az egyéni robotműveletek hozzáadásához létre kell hoznia egy JavaScript-fájlt (.js), és el kell helyeznie azt a adatok/globális/akciók mappát a Botpress projekten belül. Sajnos nincs mód új műveletek programozott hozzáadására futás közben. A kódban található JavaDoc megjegyzések használatával értelmes információkat adhat a műveletekről, például a nevükről, leírásukról, argumentumaikról és alapértelmezett értékeiről. A műveletet a folyamatszerkesztőben is elrejtheti, ha hozzáadja a @hidden true jelzőt a JavaDoc megjegyzéshez.
Egyéni műveletek létrehozása a Botpressben
Íme néhány lépés, amelyeket követve létrehozhat egyéni műveletet a Botpressben:
1. lépés: Hozd létre a robotodat, és adj hozzá egy csomópontot
A kezdéshez hozzon létre egy új botot a Botpressben. A robot létrehozása után adjon hozzá egy új csomópontot a beszélgetési folyamathoz.
2. lépés: Adjon hozzá megfelelő üzeneteket a csomóponthoz
Az újonnan létrehozott csomópontban adja hozzá a szükséges üzeneteket, hogy megkönnyítse a tartalomcserét a felhasználókkal. Hozzáadhat például egy szöveges üzenetet, amely üdvözli a felhasználót, és megkérdezi a nevét.
3. lépés: Nyissa meg a végrehajtási kódot az oldalsávról
Keresse meg a Botpress Flow Builder oldalsávját, és nyissa meg a „Kódszerkesztőt”. Itt hozhatja létre és kezelheti egyéni műveleteit.
4. lépés: Kattintson a „Művelet hozzáadása” gombra
A „Kód végrehajtása” részben kattintson a „Művelet hozzáadása” gombra. Ez a művelet megnyitja az „Új action_legacy létrehozása” ablakot.
5. lépés: Adja meg a fájl nevét, és kattintson a Küldés gombra
Az „Új action_legacy létrehozása” ablakban adjon értelmes nevet az egyéni műveletfájlnak; például customAction.js. Miután megadta a nevet, kattintson a „Küldés” gombra. Ezzel létrejön a „customAction.js” fájl.
6. lépés: Írja be egyéni kódját
Nyissa meg az újonnan létrehozott „customAction.js” fájlt. A fájlban megjelenik az új művelethez generált alapkód. Adjon értelmes leírást egyéni műveletéhez a megfelelő megjegyzések használatával.
Most írja be az egyéni kódot a függvénybe. Ez a kód határozza meg az egyéni művelet viselkedését. A JavaScript használatával különféle feladatokat hajthat végre, például API-hívásokat kezdeményezhet, elérheti az adatbázisokat vagy összetett logikát kezelhet.
7. lépés: Módosítsa a csomópontot az egyéni művelet használatához
Menjen vissza a Botpress Flow Builderhez, és módosítsa azt a csomópontot, ahol az egyéni műveletet ki szeretné váltani. Adjon hozzá egy „Execute Code” kártyát a csomóponthoz.
8. lépés: Válassza ki az egyéni művelet nevét, és adja meg a művelet paramétereit
A „Kód végrehajtása” kártyán megjelenik egy legördülő lista, amely tartalmazza az összes egyéni művelet nevét. Válassza ki az egyéni művelet nevét a listából. Ha az egyéni művelethez bármilyen paraméter szükséges, megadhatja azokat a „Kód végrehajtása” kártya „Paraméterek” részében.
9. lépés: Hajtsa végre a robotját a művelethez
Végül adjon hozzá egy másik kártyát a csomóponthoz, hogy a bot végrehajtsa az egyéni műveletet. Használhatja az eseményben mentett változókat (amelyek az „Execute Code” kártyán vannak megadva), hogy hozzáférjenek az egyéni művelet eredményeihez, és beépítsék azokat a bot válaszába.
Példa egyéni műveletre
Tegyük fel, hogy azt szeretné, hogy a chatbotja egy adott hely aktuális időjárási adatait adja meg. Létrehozhat egyéni műveletet, amely meghív egy időjárási API-t, és visszaadja az időjárási adatokat.
const axios = igényelnek ( 'axiók' );const getWeather = async ( felhasználó , session, args) => {
const hely = args.location || 'New York' ;
const apiKey = 'your_weather_api_key' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;
próbáld ki {
const válasz = vár axios.get(apiUrl);
const weatherData = válasz.adatok;
return `A jelenlegi időjárás a következő helyen: ${location}: ${weatherData.current.condition.text}, ${weatherData.current.temp_c}°C hőmérséklettel.`;
} fogás (hiba) {
Visszatérés – Sajnálom, nem tudtam \' t lekérni az aktuális időjárási információkat. Kérlek, próbáld újra később.' ;
}
};
vissza getWeather( felhasználó , session, args);
Ez a művelet bizonyos argumentumokat vesz igénybe, beleértve a felhasználót, a munkamenetet és az argumentumokat, amelyek kontextust és adatokat biztosítanak a művelethez. Ebben a példában a „getWeather” egyéni művelet a helyet veszi argumentumként, vagy alapértelmezettként „New York”-ra állítja be, ha nincs megadva. A művelet az Axios segítségével meghívja az Időjárás API-t, lekéri az időjárási adatokat, és visszaküld egy üzenetet, amely tartalmazza az időjárási állapotot és a hőmérsékletet.
Az egyéni műveletek előnyei
A Botpress egyéni műveletei számos előnnyel járnak, amelyek javítják chatbotja képességeit és funkcionalitását:
- Kibővítik a chatbot funkcióit a beépített képességeken túl.
- Személyre szabott interakciókat hoznak létre a jobb felhasználói élmény érdekében.
- Valós idejű adatokat kérnek le az API-któl a dinamikus válaszokhoz.
- Integrálódnak háttérrendszerekkel és adatbázisokkal.
- Egyedi kóddal kezelik a bonyolult forgatókönyveket.
- A műveleteket újra felhasználják a chatbotokon és folyamokon keresztül.
- Megvalósítják az egyéni hibakezelést és naplózást.
- Optimalizálják az erőforrás-igényes feladatokat.
- A méretezéshez a külső szolgáltatásokat használják fel.
- Hozzáférnek és megosztják az előre elkészített egyéni műveleteket.
Következtetés
A Botpress egyéni műveletei kiterjesztik a chatbot képességeit, személyre szabják az interakciókat és integrálják a külső API-kat. A fejlesztők létrehozzák a szerveroldali JavaScript-függvényeket, és meghívják őket a Botpress Flow Builderből. Ezek a műveletek a kód újrafelhasználhatóságát, jobb teljesítményt és skálázhatóságot kínálnak, amelyek sokoldalúbbá és hatékonyabbá teszik a chatbotokat. A Botpress egyéni műveleteinek kihasználása innovatív és vonzó chatbot-élményeket teremt.