Разумевање радњи у Ботпресс-у
Акције у Ботпресс-у су функције на страни сервера које извршава бот током конверзацијских токова. Они имају моћ да мењају стање разговора, шаљу прилагођене поруке, извршавају произвољни код (као што је позивање АПИ-ја или чување података) и још много тога. У суштини, акције су редовне ЈаваСцрипт функције што значи да могу да изврше скоро све у оквиру ограничења платформе.
Када менаџер дијалога (ДМ) позове акцију, она прима неколико аргумената који обезбеђују контекст функцији. Ови аргументи укључују корисничке атрибуте, променљиве сесије, привремене променљиве, променљиве на нивоу робота, последњи кориснички догађај у разговору, пренете аргументе из Висуал Флов Буилдер-а и заштићени вм који садржи неке променљиве окружења.
Регистрација нових радњи
Да бисте додали прилагођене радње бота, потребно је да креирате ЈаваСцрипт датотеку (.јс) и поставите је у подаци/глобални/акције фолдер у оквиру вашег Ботпресс пројекта. Нажалост, не постоји начин да се програмски додају нове радње током времена извршавања. Користећи ЈаваДоц коментаре у вашем коду, можете да пружите значајне информације о акцијама као што су њихово име, опис, аргументи и подразумеване вредности. Такође можете сакрити акцију у уређивачу тока додавањем @хидден труе заставице у ЈаваДоц коментар.
Како креирати прилагођене акције у Ботпресс-у
Ево неколико корака које можете пратити да бисте креирали прилагођену радњу у Ботпресс-у:
Корак 1: Креирајте свог бота и додајте чвор
Да бисте започели, направите новог бота у Ботпресс-у. Када се ваш бот креира, додајте нови чвор у ток разговора.
Корак 2: Додајте одговарајуће поруке свом чвору
У новостворени чвор додајте потребне поруке како бисте олакшали размену садржаја са корисницима. На пример, можете додати текстуалну поруку да поздравите корисника и затражите његово име.
Корак 3: Отворите извршни код са бочне траке
Дођите до бочне траке у Ботпресс Флов Буилдер-у и отворите „Уређивач кода“. Овде можете да конструишете и управљате својим прилагођеним радњама.
Корак 4: Кликните на дугме „Додај акцију“.
У одељку „Изврши код“ кликните на дугме „Додај акцију“. Ова радња отвара прозор „Креирај нову ацтион_легаци“.
Корак 5: Одредите име датотеке и кликните на дугме Пошаљи
У прозору „Креирај нову ацтион_легаци“ дајте смислено име за вашу прилагођену датотеку радњи; на пример, цустомАцтион.јс. Када наведете име, кликните на дугме „Пошаљи“. Ово креира датотеку „цустомАцтион.јс“.
Корак 6: Напишите свој прилагођени код
Отворите новостворену датотеку „цустомАцтион.јс“. Унутар датотеке ћете видети шаблонски код који је генерисан за нову радњу. Наведите смислен опис своје прилагођене радње користећи одговарајуће коментаре.
Сада напишите свој прилагођени код унутар функције. Овај код дефинише понашање ваше прилагођене радње. Можете да користите ЈаваСцрипт за обављање различитих задатака као што су упућивање АПИ позива, приступ базама података или руковање сложеном логиком.
Корак 7: Измените свој чвор да бисте користили прилагођену радњу
Вратите се на Ботпресс Флов Буилдер и измените чвор где желите да покренете своју прилагођену радњу. Додајте картицу „Изврши код“ у чвор.
Корак 8: Изаберите назив ваше прилагођене радње и наведите параметре акције
На картици „Изврши код“ видећете падајућу листу која садржи називе свих ваших прилагођених радњи. Изаберите назив своје прилагођене радње са листе. Ако ваша прилагођена радња захтева неке параметре, можете их навести у одељку „Параметри“ на картици „Изврши код“.
Корак 9: Нека ваш бот изврши радњу
На крају, додајте још једну картицу у чвор да би ваш бот извршио прилагођену радњу. Можете да користите променљиве које су сачуване у догађају (наведене на картици „Изврши код“) да бисте приступили резултатима ваше прилагођене радње и укључили их у одговор бота.
Пример прилагођене радње
Рецимо да желите да ваш цхатбот пружи тренутне временске информације за одређену локацију. Можете да креирате прилагођену радњу која позива временски АПИ и враћа временске податке.
цонст акиос = захтевају ( 'акиос' );цонст гетВеатхер = асинц ( корисник , сесија, аргументи) => {
цонст локација = аргс.лоцатион || 'Њу Јорк' ;
цонст апиКеи = 'ваш_веатхер_апи_кеи' ;
цонст апиУрл = `4ФД6ДЦ69Ц35Ф5Ф13636Е618217Е6А0БЦ8ДБ33Б89${апиКеи}&к=${лоцатион}`;
покушати {
цонст одговор = чекај акиос.гет(апиУрл);
цонст веатхерДата = респонсе.дата;
ретурн `Тренутно време у ${лоцатион} је ${веатхерДата.цуррент.цондитион.тект} са температуром од ${веатхерДата.цуррент.темп_ц}°Ц.`;
} ухватити (грешка) {
повратак „Извини, нисам могао \' т дохвати информације о времену у овом тренутку. Покушајте поново касније.' ;
}
};
врати гетВеатхер( корисник , сесија, аргументи);
Ова радња узима одређене аргументе, укључујући корисника, сесију и аргументе који обезбеђују контекст и податке за радњу са којом радња ради. У овом примеру, прилагођена радња „гетВеатхер“ узима локацију као аргумент или подразумевано подразумева „Њујорк“ ако није наведена. Акција позива Веатхер АПИ користећи Акиос, преузима временске податке и враћа поруку која садржи временске услове и температуру.
Предности прилагођених радњи
Прилагођене радње у Ботпресс-у нуде неколико предности које побољшавају могућности и функционалност вашег цхат бота:
- Они проширују функционалност цхатбот-а изван уграђених могућности.
- Они креирају прилагођене интеракције за боље корисничко искуство.
- Они преузимају податке у реалном времену из АПИ-ја за динамичке одговоре.
- Интегришу се са позадинским системима и базама података.
- Они рукују сложеним сценаријима са прилагођеним кодом.
- Они поново користе радње у цхатботовима и токовима.
- Они имплементирају прилагођено руковање грешкама и евидентирање.
- Они оптимизују задатке који захтевају велике ресурсе.
- Они користе екстерне услуге за скалирање.
- Они приступају и деле унапред направљене прилагођене радње.
Закључак
Прилагођене радње у Ботпресс-у проширују могућности цхатбот-а, персонализују интеракције и интегришу спољне АПИ-је. Програмери креирају ЈаваСцрипт функције на страни сервера и позивају их из Ботпресс Флов Буилдер-а. Ове радње нуде могућност поновне употребе кода, побољшане перформансе и скалабилност што четботе чини свестранијим и моћнијим алатима. Коришћење прилагођених радњи у Ботпресс-у ствара иновативна и занимљива искуства са четботом.