„Botpress“ veiksmų supratimas
„Botpress“ veiksmai yra serverio funkcijos, kurias robotas vykdo pokalbių srautų metu. Jie gali keisti pokalbio būseną, siųsti tinkintus pranešimus, vykdyti savavališką kodą (pvz., iškviesti API arba saugoti duomenis) ir dar daugiau. Iš esmės veiksmai yra įprastos „JavaScript“ funkcijos, o tai reiškia, kad platformos ribose jie gali atlikti beveik bet ką.
Kai dialogo tvarkyklė (DM) iškviečia veiksmą, jis gauna kelis argumentus, suteikiančius funkcijos kontekstą. Šie argumentai apima vartotojo atributus, seanso kintamuosius, laikinuosius kintamuosius, roboto lygio kintamuosius, naujausią vartotojo įvykį pokalbyje, pateiktus argumentus iš Visual Flow Builder ir smėlio dėžės virtualią mašiną, kurioje yra kai kurių aplinkos kintamųjų.
Naujų veiksmų registravimas
Norėdami pridėti tinkintus roboto veiksmus, turite sukurti „JavaScript“ failą (.js) ir įdėti jį į duomenys/pasauliniai/veiksmai aplanką savo Botpress projekte. Deja, vykdymo metu nėra galimybės programiškai pridėti naujų veiksmų. Naudodami „JavaDoc“ komentarus savo kode galite pateikti prasmingos informacijos apie veiksmus, pvz., jų pavadinimą, aprašymą, argumentus ir numatytąsias reikšmes. Taip pat galite paslėpti veiksmą srauto rengyklėje, „JavaDoc“ komentare pridėdami @hidden true vėliavėlę.
Kaip sukurti pasirinktinius veiksmus „Botpress“.
Štai keli veiksmai, kuriuos galite atlikti norėdami sukurti pasirinktinį veiksmą „Botpress“:
1 veiksmas: sukurkite savo robotą ir pridėkite mazgą
Norėdami pradėti, sukurkite naują robotą „Botpress“. Sukūrę robotą, pridėkite naują mazgą prie pokalbio srauto.
2 veiksmas: pridėkite atitinkamus pranešimus prie savo mazgo
Naujai sukurtame mazge pridėkite reikiamus pranešimus, kad būtų lengviau keistis turiniu su vartotojais. Pavyzdžiui, galite pridėti tekstinį pranešimą, kad pasveikintumėte vartotoją ir paprašytumėte jo vardo.
3 veiksmas: šoninėje juostoje atidarykite vykdymo kodą
Eikite į šoninę juostą „Botpress Flow Builder“ ir atidarykite „Kodo rengyklė“. Čia galite kurti ir administruoti pasirinktinius veiksmus.
4 veiksmas: spustelėkite mygtuką „Pridėti veiksmą“.
Skiltyje „Vykdyti kodą“ spustelėkite mygtuką „Pridėti veiksmą“. Šis veiksmas atveria langą „Sukurti naują action_legacy“.
5 veiksmas: nurodykite failo pavadinimą ir spustelėkite mygtuką Pateikti
Lange „Create a new action_legacy“ suteikite prasmingą priskirto veiksmo failo pavadinimą; pavyzdžiui, customAction.js. Nurodę vardą, spustelėkite mygtuką „Pateikti“. Taip sukuriamas „customAction.js“ failas.
6 veiksmas: parašykite pasirinktinį kodą
Atidarykite naujai sukurtą „customAction.js“ failą. Failo viduje matysite pagrindinį kodą, sugeneruotą naujam veiksmui. Pateikite prasmingą tinkinto veiksmo aprašą naudodami atitinkamus komentarus.
Dabar funkcijoje parašykite pasirinktinį kodą. Šis kodas apibrėžia jūsų pasirinktinio veiksmo veikimą. Galite naudoti „JavaScript“ įvairioms užduotims atlikti, pvz., API skambučiams, prieigai prie duomenų bazių ar sudėtingos logikos tvarkymui.
7 veiksmas: pakeiskite mazgą, kad galėtumėte naudoti pasirinktinį veiksmą
Grįžkite į „Botpress Flow Builder“ ir pakeiskite mazgą, kuriame norite suaktyvinti pasirinktinį veiksmą. Prie mazgo pridėkite kortelę „Vykdyti kodą“.
8 veiksmas: pasirinkite savo pasirinktinio veiksmo pavadinimą ir nurodykite veiksmo parametrus
Kortelėje „Vykdyti kodą“ matysite išskleidžiamąjį sąrašą, kuriame yra visų tinkintų veiksmų pavadinimai. Sąraše pasirinkite tinkinto veiksmo pavadinimą. Jei tinkintam veiksmui reikia kokių nors parametrų, galite juos nurodyti kortelės „Vykdyti kodą“ skiltyje „Parametrai“.
9 veiksmas: priverskite savo robotą atlikti veiksmą
Galiausiai prie mazgo pridėkite kitą kortelę, kad jūsų robotas atliktų pasirinktinį veiksmą. Galite naudoti įvykio metu išsaugotus kintamuosius (nurodytus kortelėje „Vykdyti kodą“), kad pasiektumėte tinkinto veiksmo rezultatus ir įtrauktumėte juos į roboto atsakymą.
Tinkinto veiksmo pavyzdys
Tarkime, kad norite, kad jūsų pokalbių robotas pateiktų dabartinę konkrečios vietos orų informaciją. Galite sukurti pasirinktinį veiksmą, kuris iškviečia orų API ir grąžina orų duomenis.
const axios = reikalauti ( 'aksios' );const getWeather = async ( Vartotojas , sesija, args) => {
const vieta = args.location || 'Niujorkas' ;
const apiKey = „your_weather_api_key“ ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;
bandyti {
const atsakymas = laukti axios.get(apiUrl);
const weatherData = atsakas.duomenys;
return `Dabartinis oras ${location} yra ${weatherData.current.condition.text}, o temperatūra ${weatherData.current.temp_c}°C.`;
} sugauti (klaida) {
grąžinti 'Atsiprašau, aš negalėjau \' šiuo metu negauti orų informacijos. Pabandykite dar kartą vėliau.' ;
}
};
grįžti getWeather ( Vartotojas , sesija, args);
Šiam veiksmui reikia tam tikrų argumentų, įskaitant vartotoją, seansą ir argumentus, kurie suteikia kontekstą ir duomenis, su kuriais veiksmas gali dirbti. Šiame pavyzdyje tinkintas veiksmas „getWeather“ naudoja vietą kaip argumentą arba numatytąjį „Niujorkas“, jei nenurodytas. Veiksmas iškviečia orų API naudojant „Axios“, gauna orų duomenis ir pateikia pranešimą, kuriame yra oro sąlygos ir temperatūra.
Pasirinktinių veiksmų privalumai
Pasirinktiniai Botpress veiksmai suteikia keletą privalumų, kurie pagerina jūsų pokalbių roboto galimybes ir funkcionalumą:
- Jie praplečia pokalbių roboto funkcijas, ne tik įtaisytąsias.
- Jie sukuria pritaikytas sąveikas geresnei vartotojo patirčiai.
- Jie gauna realaus laiko duomenis iš API, kad gautų dinaminius atsakymus.
- Jie integruojami su užpakalinėmis sistemomis ir duomenų bazėmis.
- Jie tvarko sudėtingus scenarijus naudodami pasirinktinį kodą.
- Jie pakartotinai naudoja veiksmus pokalbių robotuose ir srautuose.
- Jie įgyvendina pasirinktinį klaidų tvarkymą ir registravimą.
- Jie optimizuoja daug išteklių reikalaujančias užduotis.
- Jie naudoja išorines paslaugas mastelio keitimui.
- Jie pasiekia ir bendrina iš anksto sukurtus pasirinktinius veiksmus.
Išvada
Pasirinktiniai Botpress veiksmai išplečia pokalbių roboto galimybes, suasmenina sąveiką ir integruoja išorines API. Kūrėjai sukuria serverio JavaScript funkcijas ir iškviečia jas iš Botpress Flow Builder. Dėl šių veiksmų galima pakartotinai naudoti kodą, pagerinti našumą ir mastelį, todėl pokalbių robotai tampa universalesni ir galingesni įrankiai. Naudojant pasirinktinius Botpress veiksmus sukuriama naujoviška ir patraukli pokalbių roboto patirtis.