Razumevanje dejanj v Botpressu
Dejanja v Botpressu so funkcije na strani strežnika, ki jih izvaja bot med pogovornimi tokovi. Imajo moč spreminjanja stanja pogovora, pošiljanja prilagojenih sporočil, izvajanja poljubne kode (na primer klicanja API-jev ali shranjevanja podatkov) in več. Dejanja so v bistvu običajne funkcije JavaScript, kar pomeni, da lahko izvajajo skoraj vse v okviru omejitev platforme.
Ko upravitelj dialoga (DM) prikliče dejanje, prejme več argumentov, ki zagotavljajo kontekst funkciji. Ti argumenti vključujejo uporabniške atribute, spremenljivke seje, začasne spremenljivke, spremenljivke na ravni botov, zadnji uporabniški dogodek v pogovoru, posredovane argumente iz Visual Flow Builderja in virtualni vir v peskovniku, ki vsebuje nekaj spremenljivk okolja.
Registracija novih dejanj
Če želite dodati dejanja robota po meri, morate ustvariti datoteko JavaScript (.js) in jo postaviti v mapo podatki/globalno/dejanja znotraj vašega projekta Botpress. Na žalost ni mogoče programsko dodati novih dejanj med izvajanjem. Z uporabo komentarjev JavaDoc v vaši kodi lahko zagotovite pomembne informacije o dejanjih, kot so njihovo ime, opis, argumenti in privzete vrednosti. Prav tako lahko skrijete dejanje v urejevalniku toka tako, da dodate oznako @hidden true v komentar JavaDoc.
Kako ustvariti dejanja po meri v Botpressu
Sledite nekaj korakom, da ustvarite dejanje po meri v Botpressu:
1. korak: Ustvarite svojega bota in dodajte vozlišče
Za začetek ustvarite novega bota v Botpressu. Ko je vaš bot ustvarjen, dodajte novo vozlišče v tok pogovora.
2. korak: dodajte ustrezna sporočila svojemu vozlišču
V novo ustvarjeno vozlišče dodajte potrebna sporočila za lažjo izmenjavo vsebin z uporabniki. Na primer, lahko dodate besedilno sporočilo, da pozdravite uporabnika in vprašate za njegovo ime.
3. korak: Odprite kodo za izvajanje v stranski vrstici
Pomaknite se do stranske vrstice v Botpress Flow Builderju in odprite »Urejevalnik kode«. Tukaj lahko ustvarite in upravljate svoja dejanja po meri.
4. korak: Kliknite gumb »Dodaj dejanje«.
V razdelku »Izvedi kodo« kliknite gumb »Dodaj dejanje«. To dejanje odpre okno »Ustvari novo dejanje_legacy«.
5. korak: Določite ime za datoteko in kliknite gumb Pošlji
V oknu »Create a new action_legacy« podajte smiselno ime vaši akcijski datoteki po meri; na primer customAction.js. Ko določite ime, kliknite na gumb 'Pošlji'. S tem se ustvari datoteka »customAction.js«.
6. korak: Napišite kodo po meri
Odprite novo ustvarjeno datoteko »customAction.js«. Znotraj datoteke boste videli okvirno kodo, ki je bila ustvarjena za novo dejanje. Podajte smiseln opis za svoje dejanje po meri z uporabo ustreznih komentarjev.
Zdaj napišite kodo po meri znotraj funkcije. Ta koda definira vedenje vašega dejanja po meri. JavaScript lahko uporabite za izvajanje različnih nalog, kot so klici API-ja, dostop do podatkovnih baz ali obravnava kompleksne logike.
7. korak: spremenite svoje vozlišče za uporabo dejanja po meri
Vrnite se v Botpress Flow Builder in spremenite vozlišče, kjer želite sprožiti svoje dejanje po meri. Vozlišču dodajte kartico »Izvedi kodo«.
8. korak: Izberite ime dejanja po meri in določite parametre dejanja
Na kartici »Izvedi kodo« boste videli spustni seznam z imeni vseh vaših dejanj po meri. Na seznamu izberite ime dejanja po meri. Če vaše dejanje po meri zahteva kakršne koli parametre, jih lahko določite v razdelku »Parametri« na kartici »Izvedi kodo«.
9. korak: Naj vaš bot izvede dejanje
Na koncu vozlišču dodajte še eno kartico, da bo vaš bot izvedel dejanje po meri. Spremenljivke, ki so shranjene v dogodku (navedene na kartici »Izvedi kodo«), lahko uporabite za dostop do rezultatov vašega dejanja po meri in jih vključite v odgovor bota.
Primer dejanja po meri
Recimo, da želite, da vaš chatbot zagotovi trenutne vremenske informacije za določeno lokacijo. Ustvarite lahko dejanje po meri, ki pokliče vremenski API in vrne vremenske podatke.
const axios = zahtevati ( 'axios' );const getWeather = async ( uporabnik , seja, argumenti) => {
const lokacija = args.location || 'New York' ;
const apiKey = 'your_weather_api_key' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;
poskusi {
odziv const = await axios.get(apiUrl);
const weatherData = response.data;
return `Trenutno vreme v ${location} je ${weatherData.current.condition.text} s temperaturo ${weatherData.current.temp_c}°C.`;
} ulov (napaka) {
vrnitev 'Oprosti, lahko bi \' trenutno ne pridobi informacij o vremenu. Prosim poskusite kasneje.' ;
}
};
vrni getWeather( uporabnik , seja, argumenti);
To dejanje sprejme določene argumente, vključno z uporabnikom, sejo in argumenti, ki zagotavljajo kontekst in podatke za delovanje dejanja. V tem primeru dejanje po meri »getWeather« vzame lokacijo kot argument ali privzeto nastavi na »New York«, če ni podana. Dejanje pokliče Weather API z uporabo Axios, pridobi vremenske podatke in vrne sporočilo, ki vsebuje vremenske razmere in temperaturo.
Prednosti dejanj po meri
Dejanja po meri v Botpressu ponujajo številne prednosti, ki izboljšujejo zmogljivosti in funkcionalnost vašega chatbota:
- Funkcionalnost chatbota razširjajo preko vgrajenih zmožnosti.
- Ustvarjajo prilagojene interakcije za boljšo uporabniško izkušnjo.
- Pridobijo podatke v realnem času iz API-jev za dinamične odzive.
- Integrirajo se z zalednimi sistemi in bazami podatkov.
- S kodo po meri obravnavajo zapletene scenarije.
- Znova uporabijo dejanja v klepetalnih robotih in tokovih.
- Izvajajo obdelavo in beleženje napak po meri.
- Optimizirajo naloge, ki zahtevajo veliko virov.
- Za skaliranje izkoriščajo zunanje storitve.
- Dostopajo do vnaprej izdelanih dejanj po meri in jih delijo.
Zaključek
Dejanja po meri v Botpressu razširjajo zmogljivosti chatbota, personalizirajo interakcije in integrirajo zunanje API-je. Razvijalci ustvarijo funkcije JavaScript na strani strežnika in jih prikličejo iz Botpress Flow Builderja. Ta dejanja ponujajo možnost ponovne uporabe kode, izboljšano zmogljivost in razširljivost, zaradi česar so chatboti bolj vsestranska in zmogljiva orodja. Izkoriščanje prilagojenih dejanj v Botpressu ustvarja inovativne in privlačne izkušnje chatbota.