Botpressi toimingute mõistmine
Botpressi toimingud on serveripoolsed funktsioonid, mida robot vestlusvoogude ajal käivitab. Neil on õigus muuta vestluse olekut, saata kohandatud sõnumeid, käivitada suvalist koodi (nt helistada API-dele või salvestada andmeid) ja palju muud. Põhimõtteliselt on toimingud tavalised JavaScripti funktsioonid, mis tähendab, et nad saavad platvormi piires teha peaaegu kõike.
Kui dialoogihaldur (DM) toimingu käivitab, saab see mitu argumenti, mis annavad funktsioonile konteksti. Need argumendid hõlmavad kasutaja atribuute, seansi muutujaid, ajutisi muutujaid, robotitaseme muutujaid, vestluse viimast kasutajasündmust, Visual Flow Builderi edastatud argumente ja mõnda keskkonnamuutujaid sisaldavat liivakasti virtuaalmasinat.
Uute toimingute registreerimine
Kohandatud robotitoimingute lisamiseks peate looma JavaScripti faili (.js) ja asetama selle faili andmed/globaalne/toimingud kausta teie Botpressi projektis. Kahjuks ei saa käitusajal uusi toiminguid programmiliselt lisada. Kasutades oma koodis JavaDoc kommentaare, saate anda sisulist teavet toimingute kohta, nagu nende nimi, kirjeldus, argumendid ja vaikeväärtused. Samuti saate toimingu peita vooredaktoris, lisades JavaDoc kommentaari @hidden true lipu.
Kuidas luua Botpressis kohandatud toiminguid
Siin on mõned sammud, mida saate Botpressis kohandatud toimingu loomiseks järgida.
1. samm: looge oma robot ja lisage sõlm
Alustamiseks looge Botpressis uus robot. Kui teie robot on loodud, lisage vestlusvoogu uus sõlm.
2. samm: lisage oma sõlmele sobivad sõnumid
Lisage vastloodud sõlme vajalikud sõnumid, et hõlbustada sisuvahetust kasutajatega. Näiteks saate lisada tekstisõnumi, et kasutajat tervitada ja tema nime küsida.
3. samm: avage külgribal käivituskood
Liikuge Botpress Flow Builderis külgribale ja avage 'Koodiredaktor'. See on koht, kus saate oma kohandatud toiminguid koostada ja hallata.
4. samm: klõpsake nuppu 'Lisa toiming'.
Jaotises 'Käivita kood' klõpsake nuppu 'Lisa toiming'. See toiming avab akna „Loo uus action_legacy”.
5. samm: määrake faili nimi ja klõpsake nuppu Esita
Andke aknas „Loo uus action_legacy” oma kohandatud toimingufailile tähendusrikas nimi; näiteks customAction.js. Kui olete nime määranud, klõpsake nuppu 'Esita'. See loob faili „customAction.js”.
6. samm: kirjutage oma kohandatud kood
Avage äsja loodud fail 'customAction.js'. Faili sees näete standardkoodi, mis on loodud uue toimingu jaoks. Esitage oma kohandatud toimingu jaoks asjakohane kirjeldus, kasutades asjakohaseid kommentaare.
Nüüd kirjutage funktsiooni sisse oma kohandatud kood. See kood määrab teie kohandatud toimingu käitumise. JavaScripti saate kasutada mitmesuguste toimingute tegemiseks, nagu API-kõnede tegemine, andmebaasidele juurdepääs või keeruka loogika käsitlemine.
7. samm: muutke oma sõlme kohandatud toimingu kasutamiseks
Minge tagasi Botpress Flow Builderisse ja muutke sõlme, kus soovite oma kohandatud toimingu käivitada. Lisage sõlmele kaart 'Käivita kood'.
8. samm: valige oma kohandatud toimingu nimi ja määrake toimingu parameetrid
Kaardil „Koodi käivitamine” näete ripploendit, mis sisaldab kõigi teie kohandatud toimingute nimesid. Valige loendist oma kohandatud toimingu nimi. Kui teie kohandatud toiming nõuab parameetreid, saate need määrata kaardi „Koodi täitmine” jaotises „Parameetrid”.
9. samm: pange oma robot toimingu sooritama
Lõpuks lisage sõlmele veel üks kaart, et teie robot kohandatud toimingut sooritaks. Saate kasutada sündmuses salvestatud muutujaid (määratud kaardil „Koodi täitmine”), et pääseda juurde oma kohandatud toimingu tulemustele ja lisada need roboti vastusesse.
Kohandatud toimingu näide
Oletame, et soovite, et teie vestlusbot pakuks konkreetse asukoha kohta praegust ilmateavet. Saate luua kohandatud toimingu, mis kutsub välja ilmateate API ja tagastab ilmaandmed.
const axios = nõuda ( 'axios' );const getWeather = async ( kasutaja , seanss, args) => {
const asukoht = args.location || 'New York' ;
const apiKey = 'your_weather_api_key' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;
proovi {
const vastus = oota axios.get(apiUrl);
const weatherData = vastus.andmed;
return `Praegune ilm asukohas ${location} on ${weatherData.current.condition.text} ja temperatuur on ${weatherData.current.temp_c}°C.`;
} püüdmine (viga) {
tagasi 'Vabandust, ma ei saanud \' t too hetkel ilmateavet. Palun proovi hiljem uuesti.' ;
}
};
tagasi getWeather( kasutaja , seanss, args);
See toiming võtab teatud argumendid, sealhulgas kasutaja, seansi ja argumendid, mis pakuvad toimingu jaoks konteksti ja andmeid. Selles näites võtab kohandatud toiming „getWeather” asukoha argumendina või vaikeväärtuseks „New York”, kui seda pole esitatud. Toiming kutsub Axiose abil välja Weather API, hangib ilmaandmed ja tagastab teate, mis sisaldab ilmaolusid ja temperatuuri.
Kohandatud toimingute eelised
Botpressi kohandatud toimingud pakuvad mitmeid eeliseid, mis suurendavad teie vestlusroti võimalusi ja funktsionaalsust.
- Need laiendavad vestlusroboti funktsioone kaugemale sisseehitatud võimalustest.
- Need loovad parema kasutajakogemuse jaoks kohandatud suhtlust.
- Nad toovad API-delt reaalajas andmeid dünaamiliste vastuste jaoks.
- Need integreeruvad taustasüsteemide ja andmebaasidega.
- Nad tegelevad keerukate stsenaariumidega kohandatud koodiga.
- Nad taaskasutavad toiminguid vestlusrobotites ja voogudes.
- Nad rakendavad kohandatud vigade käsitlemist ja logimist.
- Need optimeerivad ressursimahukaid ülesandeid.
- Nad kasutavad skaleerimiseks välisteenuseid.
- Nad pääsevad juurde ja jagavad eelnevalt loodud kohandatud toiminguid.
Järeldus
Botpressi kohandatud toimingud laiendavad vestlusroboti võimalusi, isikupärastavad suhtlust ja integreerivad väliseid API-sid. Arendajad loovad serveripoolsed JavaScripti funktsioonid ja kutsuvad need Botpress Flow Builderist välja. Need toimingud pakuvad koodi korduvkasutatavust, paremat jõudlust ja mastaapsust, mis muudavad vestlusrobotid mitmekülgsemaks ja võimsamaks. Botpressi kohandatud toimingute kasutamine loob uuenduslikke ja kaasahaaravaid vestlusrobotite kogemusi.