Izpratne par darbībām pakalpojumā Botpress
Botpress darbības ir servera puses funkcijas, kuras robots izpilda sarunu plūsmu laikā. Viņiem ir tiesības mainīt sarunas stāvokli, sūtīt pielāgotus ziņojumus, izpildīt patvaļīgu kodu (piemēram, izsaukt API vai saglabāt datus) un daudz ko citu. Būtībā darbības ir parastas JavaScript funkcijas, kas nozīmē, ka tās var veikt gandrīz jebko platformas ierobežojumu ietvaros.
Kad Dialogu Manager (DM) izsauc darbību, tas saņem vairākus argumentus, kas nodrošina funkcijas kontekstu. Šie argumenti ietver lietotāja atribūtus, sesijas mainīgos, pagaidu mainīgos, robotu līmeņa mainīgos, jaunāko lietotāja notikumu sarunā, nodotos argumentus no Visual Flow Builder un smilškastes virtuālo mašīnu, kurā ir daži vides mainīgie.
Jaunu darbību reģistrēšana
Lai pievienotu pielāgotas robotprogrammatūras darbības, jums ir jāizveido JavaScript fails (.js) un jāievieto tas mapē dati/globāli/darbības mapi savā Botpress projektā. Diemžēl izpildlaikā nav iespējams programmatiski pievienot jaunas darbības. Izmantojot JavaDoc komentārus savā kodā, varat sniegt nozīmīgu informāciju par darbībām, piemēram, to nosaukumu, aprakstu, argumentus un noklusējuma vērtības. Varat arī paslēpt darbību plūsmas redaktorā, pievienojot JavaDoc komentāram karodziņu @hidden true.
Kā izveidot pielāgotas darbības pakalpojumā Botpress
Tālāk ir norādītas dažas darbības, kuras varat veikt, lai pakalpojumā Botpress izveidotu pielāgotu darbību.
1. darbība: izveidojiet savu robotprogrammatūru un pievienojiet mezglu
Lai sāktu, izveidojiet jaunu robotu pakalpojumā Botpress. Kad robots ir izveidots, pievienojiet sarunu plūsmai jaunu mezglu.
2. darbība: pievienojiet savam mezglam atbilstošus ziņojumus
Jaunizveidotajā mezglā pievienojiet nepieciešamos ziņojumus, lai atvieglotu satura apmaiņu ar lietotājiem. Piemēram, varat pievienot īsziņu, lai sveicinātu lietotāju un lūgtu viņa vārdu.
3. darbība. Sānjoslā atveriet izpildes kodu
Pārejiet uz Botpress Flow Builder sānjoslu un atveriet 'Koda redaktoru'. Šeit varat izveidot un pārvaldīt savas pielāgotās darbības.
4. darbība: noklikšķiniet uz pogas “Pievienot darbību”.
Sadaļā “Izpildīt kodu” noklikšķiniet uz pogas “Pievienot darbību”. Šī darbība atver logu “Izveidot jaunu action_legacy”.
5. darbība: norādiet faila nosaukumu un noklikšķiniet uz pogas Iesniegt
Logā “Izveidot jaunu action_legacy” piešķiriet savam pielāgotajam darbības failam jēgpilnu nosaukumu; piemēram, customAction.js. Kad esat norādījis vārdu, noklikšķiniet uz pogas “Iesniegt”. Tādējādi tiek izveidots fails “customAction.js”.
6. darbība. Uzrakstiet savu pielāgoto kodu
Atveriet jaunizveidoto failu “customAction.js”. Failā būs redzams jaunai darbībai ģenerēts standarta kods. Sniedziet jēgpilnu pielāgotās darbības aprakstu, izmantojot atbilstošos komentārus.
Tagad funkcijā ierakstiet savu pielāgoto kodu. Šis kods nosaka jūsu pielāgotās darbības uzvedību. Varat izmantot JavaScript, lai veiktu dažādus uzdevumus, piemēram, veiktu API zvanus, piekļūtu datu bāzēm vai apstrādātu sarežģītu loģiku.
7. darbība. Modificējiet savu mezglu, lai izmantotu pielāgoto darbību
Atgriezieties Botpress Flow Builder un modificējiet mezglu, kurā vēlaties aktivizēt savu pielāgoto darbību. Pievienojiet mezglam karti “Izpildīt kodu”.
8. darbība: atlasiet savu pielāgotās darbības nosaukumu un norādiet darbības parametrus
Kartītē “Izpildīt kodu” būs redzams nolaižamais saraksts, kurā ir visu jūsu pielāgoto darbību nosaukumi. Sarakstā atlasiet pielāgotās darbības nosaukumu. Ja jūsu pielāgotajai darbībai ir nepieciešami kādi parametri, varat tos norādīt kartītes “Izpildīt kodu” sadaļā “Parametri”.
9. darbība. Lieciet savam robotam veikt darbību
Visbeidzot pievienojiet mezglam citu karti, lai jūsu robots veiktu pielāgoto darbību. Varat izmantot mainīgos, kas tiek saglabāti notikumā (norādīti kartītē “Izpildīt kodu”), lai piekļūtu pielāgotās darbības rezultātiem un iekļautu tos robota atbildē.
Pielāgotas darbības piemērs
Pieņemsim, ka vēlaties, lai jūsu tērzēšanas robots sniegtu pašreizējo informāciju par laikapstākļiem noteiktā vietā. Varat izveidot pielāgotu darbību, kas izsauc laikapstākļu API un atgriež laikapstākļu datus.
const axios = pieprasīt ( 'aksios' );const getWeather = async ( lietotājs , sesija, args) => {
const atrašanās vieta = args.location || 'Ņujorka' ;
const apiKey = 'your_weather_api_key' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;
mēģināt {
const atbilde = gaidiet axios.get(apiUrl);
const weatherData = atbilde.dati;
return `Pašreizējie laikapstākļi vietā ${location} ir ${weatherData.current.condition.text} ar temperatūru ${weatherData.current.temp_c}°C.`;
} nozveja (kļūda) {
atgriezties 'Atvainojiet, es nevarēju \' t iegūt informāciju par laikapstākļiem šobrīd. Lūdzu, pamēģiniet vēlreiz vēlāk.' ;
}
};
atgriezties getWeather( lietotājs , sesija, args);
Šai darbībai ir nepieciešami noteikti argumenti, tostarp lietotājs, sesija un argumenti, kas nodrošina kontekstu un datus darbībai. Šajā piemērā pielāgotā darbība “getWeather” izmanto atrašanās vietu kā argumentu vai noklusējuma vērtību “Ņujorka”, ja tā nav norādīta. Darbība izsauc Weather API, izmantojot Axios, ienes laikapstākļu datus un atgriež ziņojumu, kas satur laika apstākļus un temperatūru.
Pielāgoto darbību priekšrocības
Pielāgotas darbības pakalpojumā Botpress piedāvā vairākas priekšrocības, kas uzlabo jūsu tērzēšanas robota iespējas un funkcionalitāti:
- Tie paplašina tērzēšanas robota funkcionalitāti, pārsniedzot iebūvētās iespējas.
- Tie rada pielāgotas mijiedarbības labākai lietotāja pieredzei.
- Viņi iegūst reāllaika datus no API dinamiskām atbildēm.
- Tie integrējas ar aizmugursistēmām un datu bāzēm.
- Viņi apstrādā sarežģītus scenārijus ar pielāgotu kodu.
- Viņi atkārtoti izmanto darbības tērzēšanas robotos un plūsmās.
- Tie ievieš pielāgotu kļūdu apstrādi un reģistrēšanu.
- Tie optimizē resursietilpīgos uzdevumus.
- Tās mērogošanai izmanto ārējos pakalpojumus.
- Viņi piekļūst iepriekš izveidotajām pielāgotajām darbībām un kopīgo tās.
Secinājums
Pielāgotas darbības pakalpojumā Botpress paplašina tērzēšanas robota iespējas, personalizē mijiedarbību un integrē ārējās API. Izstrādātāji izveido servera puses JavaScript funkcijas un izsauc tās no Botpress Flow Builder. Šīs darbības nodrošina koda atkārtotu izmantošanu, uzlabotu veiktspēju un mērogojamību, kas padara tērzēšanas robotus daudzpusīgākus un jaudīgākus rīkus. Izmantojot Botpress pielāgotās darbības, tiek radīta novatoriska un saistoša tērzēšanas robota pieredze.