Pag-unawa sa Mga Aksyon sa Botpress
Ang mga aksyon sa Botpress ay mga function sa gilid ng server na isinasagawa ng bot sa panahon ng mga daloy ng pakikipag-usap. May kapangyarihan silang baguhin ang estado ng pag-uusap, magpadala ng mga naka-customize na mensahe, magsagawa ng arbitrary code (gaya ng pagtawag sa mga API o pag-iimbak ng data), at higit pa. Sa esensya, ang mga aksyon ay mga regular na function ng JavaScript na nangangahulugang magagawa nila ang halos anumang bagay sa loob ng mga limitasyon ng platform.
Kapag ang isang aksyon ay hinihimok ng Dialogue Manager (DM), nakakatanggap ito ng ilang argumento na nagbibigay ng konteksto sa function. Kasama sa mga argumentong ito ang mga attribute ng user, mga variable ng session, mga pansamantalang variable, mga variable sa antas ng bot, ang pinakabagong kaganapan ng user sa pag-uusap, mga pumasa na argumento mula sa Visual Flow Builder, at isang sandboxed vm na naglalaman ng ilang mga variable ng kapaligiran.
Pagrerehistro ng mga Bagong Aksyon
Upang idagdag ang mga custom na pagkilos ng bot, kailangan mong gumawa ng JavaScript file (.js) at ilagay ito sa data/global/aksyon folder sa loob ng iyong proyekto sa Botpress. Sa kasamaang-palad, walang paraan para makapagdagdag ng mga bagong aksyon sa programa sa panahon ng runtime. Gamit ang mga komento ng JavaDoc sa iyong code, maaari kang magbigay ng makabuluhang impormasyon tungkol sa mga pagkilos gaya ng kanilang pangalan, paglalarawan, argumento, at mga default na halaga. Maaari mo ring itago ang isang aksyon sa editor ng daloy sa pamamagitan ng pagdaragdag ng @hidden true flag sa komento ng JavaDoc.
Paano Gumawa ng Mga Custom na Pagkilos sa Botpress
Narito ang ilang hakbang na maaari mong sundin upang lumikha ng custom na pagkilos sa Botpress:
Hakbang 1: Gumawa ng Iyong Bot at Magdagdag ng Node
Upang makapagsimula, lumikha ng bagong bot sa Botpress. Kapag nagawa na ang iyong bot, magdagdag ng bagong node sa daloy ng pag-uusap.
Hakbang 2: Magdagdag ng Mga Naaangkop na Mensahe sa Iyong Node
Sa bagong likhang node, idagdag ang mga kinakailangang mensahe upang mapadali ang pagpapalitan ng nilalaman sa mga user. Halimbawa, maaari kang magdagdag ng text message upang batiin ang user at tanungin ang kanilang pangalan.
Hakbang 3: Buksan ang Execute Code mula sa Sidebar
Mag-navigate sa sidebar sa Botpress Flow Builder at buksan ang 'Code editor'. Ito ay kung saan maaari kang bumuo at mangasiwa ng iyong mga custom na aksyon.
Hakbang 4: Mag-click sa 'Magdagdag ng Aksyon' na Button
Sa seksyong 'Ipatupad ang Code', mag-click sa pindutang 'Magdagdag ng Aksyon'. Binubuksan ng pagkilos na ito ang window na 'Gumawa ng bagong action_legacy'.
Hakbang 5: Tukuyin ang Pangalan para sa File at Mag-click sa Isumite na Button
Sa window na 'Gumawa ng bagong action_legacy,' magbigay ng makabuluhang pangalan para sa iyong custom na file ng pagkilos; halimbawa, customAction.js. Sa sandaling tinukoy mo ang pangalan, mag-click sa pindutang 'Isumite'. Lumilikha ito ng 'customAction.js' na file.
Hakbang 6: Isulat ang Iyong Custom na Code
Buksan ang bagong likhang “customAction.js” na file. Sa loob ng file, makikita mo ang boilerplate code na nabuo para sa isang bagong aksyon. Magbigay ng makabuluhang paglalarawan para sa iyong custom na pagkilos gamit ang mga naaangkop na komento.
Ngayon, isulat ang iyong custom na code sa loob ng function. Tinutukoy ng code na ito ang gawi ng iyong custom na pagkilos. Maaari mong gamitin ang JavaScript upang magsagawa ng iba't ibang gawain tulad ng paggawa ng mga tawag sa API, pag-access sa mga database, o paghawak ng kumplikadong lohika.
Hakbang 7: Baguhin ang Iyong Node para Gamitin ang Custom na Aksyon
Bumalik sa Botpress Flow Builder at baguhin ang node kung saan mo gustong i-trigger ang iyong custom na pagkilos. Magdagdag ng card na 'Ipatupad ang Code' sa node.
Hakbang 8: Piliin ang Iyong Custom na Pangalan ng Aksyon at Tukuyin ang Mga Parameter ng Aksyon
Sa card na 'Ipatupad ang Code,' makakakita ka ng dropdown na listahan na naglalaman ng mga pangalan ng lahat ng iyong custom na pagkilos. Piliin ang pangalan ng iyong custom na pagkilos mula sa listahan. Kung ang iyong custom na pagkilos ay nangangailangan ng anumang mga parameter, maaari mong tukuyin ang mga ito sa seksyong 'Mga Parameter' ng card na 'Ipatupad ang Code.'
Hakbang 9: Gawin ang Iyong Bot na Gawin ang Aksyon
Panghuli, magdagdag ng isa pang card sa node para gawin ng iyong bot ang custom na pagkilos. Maaari mong gamitin ang mga variable na naka-save sa kaganapan (tinukoy sa card na 'Ipatupad ang Code') upang ma-access ang mga resulta ng iyong custom na pagkilos at isama ang mga ito sa tugon ng bot.
Halimbawa ng Custom na Pagkilos
Sabihin nating gusto mong ibigay ng iyong chatbot ang kasalukuyang impormasyon ng panahon para sa isang tinukoy na lokasyon. Maaari kang gumawa ng custom na pagkilos na tumatawag sa weather API at ibinabalik ang data ng panahon.
const axios = nangangailangan ( 'axios' );const getWeather = async ( gumagamit , session, args) => {
const location = args.location || 'New York' ;
const apiKey = 'your_weather_api_key' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${lokasyon}`;
subukan {
const response = hintayin ang axios.get(apiUrl);
const weatherData = tugon.data;
return `Ang kasalukuyang panahon sa ${location} ay ${weatherData.current.condition.text} na may temperaturang ${weatherData.current.temp_c}°C.`;
} catch (error) {
bumalik 'Sorry, kaya ko \' t kunin ang impormasyon ng panahon sa ngayon. Subukang muli mamaya.' ;
}
};
bumalik getWeather( gumagamit , session, args);
Ang pagkilos na ito ay tumatagal ng ilang partikular na argumento kabilang ang user, session, at mga argumento na nagbibigay ng konteksto at data para gumana ang pagkilos. Sa halimbawang ito, ginagawa ng custom na pagkilos ng 'getWeather' ang lokasyon bilang argumento o magiging default sa 'New York' kung hindi ibinigay. Tinatawag ng aksyon ang Weather API gamit ang Axios, kinukuha ang data ng lagay ng panahon, at nagbabalik ng mensahe na naglalaman ng kondisyon ng panahon at temperatura.
Mga Bentahe ng Mga Custom na Pagkilos
Nag-aalok ang mga custom na aksyon sa Botpress ng ilang mga pakinabang na nagpapahusay sa mga kakayahan at functionality ng iyong chatbot:
- Pinapalawak nila ang paggana ng chatbot nang higit sa mga built-in na kakayahan.
- Gumagawa sila ng mga iniangkop na pakikipag-ugnayan para sa mas magandang karanasan ng user.
- Kumukuha sila ng real-time na data mula sa mga API para sa mga dynamic na tugon.
- Sumasama sila sa mga backend system at database.
- Pinangangasiwaan nila ang mga masalimuot na senaryo gamit ang custom na code.
- Muli nilang ginagamit ang mga pagkilos sa mga chatbot at daloy.
- Ipinapatupad nila ang custom na paghawak ng error at pag-log.
- Ino-optimize nila ang mga gawaing masinsinang mapagkukunan.
- Ginagamit nila ang mga panlabas na serbisyo para sa pag-scale.
- Ina-access at ibinabahagi nila ang mga paunang ginawang custom na pagkilos.
Konklusyon
Ang mga custom na pagkilos sa Botpress ay nagpapalawak ng mga kakayahan sa chatbot, nag-personalize ng mga pakikipag-ugnayan, at nagsasama ng mga panlabas na API. Ginagawa ng mga developer ang server-side na JavaScript function at hinihimok ang mga ito mula sa Botpress Flow Builder. Ang mga pagkilos na ito ay nag-aalok ng muling paggamit ng code, pinahusay na pagganap, at scalability na ginagawang mas maraming nalalaman at makapangyarihang mga tool ang mga chatbot. Ang paggamit sa mga custom na pagkilos sa Botpress ay lumilikha ng mga makabago at nakakaengganyo na karanasan sa chatbot.