Pochopenie akcií v Botpresse
Akcie v Botpresse sú funkcie na strane servera, ktoré robot vykonáva počas konverzačných tokov. Majú právomoc meniť stav konverzácie, odosielať prispôsobené správy, spúšťať ľubovoľný kód (napríklad volať rozhrania API alebo ukladať údaje) a ďalšie. Akcie sú v podstate bežné funkcie JavaScriptu, čo znamená, že môžu vykonávať takmer čokoľvek v rámci obmedzení platformy.
Keď Dialogue Manager (DM) vyvolá akciu, dostane niekoľko argumentov, ktoré poskytujú kontext pre funkciu. Tieto argumenty zahŕňajú atribúty používateľa, premenné relácie, dočasné premenné, premenné na úrovni robota, najnovšiu udalosť používateľa v konverzácii, odovzdané argumenty z nástroja Visual Flow Builder a vm v karanténe, ktorý obsahuje niektoré premenné prostredia.
Registrácia nových akcií
Ak chcete pridať vlastné akcie robota, musíte vytvoriť súbor JavaScript (.js) a umiestniť ho do údaje/globálne/akcie priečinok vo vašom projekte Botpress. Bohužiaľ, neexistuje spôsob, ako programovo pridávať nové akcie počas behu. Pomocou komentárov JavaDoc vo svojom kóde môžete poskytnúť zmysluplné informácie o akciách, ako je ich názov, popis, argumenty a predvolené hodnoty. Akciu v editore toku môžete skryť aj pridaním príznaku @hidden true do komentára JavaDoc.
Ako vytvoriť vlastné akcie v Botpresse
Tu je niekoľko krokov, ktoré môžete použiť na vytvorenie vlastnej akcie v Botpress:
Krok 1: Vytvorte si robota a pridajte uzol
Ak chcete začať, vytvorte nového robota v Botpresse. Po vytvorení robota pridajte do toku konverzácie nový uzol.
Krok 2: Pridajte vhodné správy do svojho uzla
V novovytvorenom uzle pridajte potrebné správy na uľahčenie výmeny obsahu s používateľmi. Môžete napríklad pridať textovú správu na pozdrav používateľa a požiadať o jeho meno.
Krok 3: Otvorte spustenie kódu z bočného panela
Prejdite na bočný panel v Botpress Flow Builder a otvorte „editor kódu“. Tu môžete vytvárať a spravovať svoje vlastné akcie.
Krok 4: Kliknite na tlačidlo „Pridať akciu“.
V časti „Vykonať kód“ kliknite na tlačidlo „Pridať akciu“. Táto akcia otvorí okno „Vytvoriť novú akciu_legacy“.
Krok 5: Zadajte názov súboru a kliknite na tlačidlo Odoslať
V okne „Create a new action_legacy“ zadajte zmysluplný názov súboru vlastnej akcie; napríklad customAction.js. Po zadaní názvu kliknite na tlačidlo „Odoslať“. Tým sa vytvorí súbor „customAction.js“.
Krok 6: Napíšte svoj vlastný kód
Otvorte novovytvorený súbor „customAction.js“. Vo vnútri súboru uvidíte štandardný kód, ktorý sa vygeneruje pre novú akciu. Poskytnite zmysluplný popis vlastnej akcie pomocou príslušných komentárov.
Teraz napíšte svoj vlastný kód do funkcie. Tento kód definuje správanie vašej vlastnej akcie. JavaScript môžete použiť na vykonávanie rôznych úloh, ako je uskutočňovanie volaní API, prístup k databázam alebo spracovanie zložitej logiky.
Krok 7: Upravte svoj uzol tak, aby používal vlastnú akciu
Vráťte sa do Botpress Flow Builder a upravte uzol, kde chcete spustiť vlastnú akciu. Pridajte do uzla kartu „Vykonať kód“.
Krok 8: Vyberte názov vlastnej akcie a zadajte parametre akcie
Na karte „Vykonať kód“ sa zobrazí rozbaľovací zoznam, ktorý obsahuje názvy všetkých vašich vlastných akcií. Zo zoznamu vyberte názov vlastnej akcie. Ak vaša vlastná akcia vyžaduje nejaké parametre, môžete ich zadať v sekcii „Parametre“ na karte „Vykonať kód“.
Krok 9: Nechajte svojho robota vykonať akciu
Nakoniec pridajte do uzla ďalšiu kartu, aby váš robot vykonal vlastnú akciu. Premenné, ktoré sú uložené v udalosti (špecifikované na karte „Vykonať kód“), môžete použiť na prístup k výsledkom vlastnej akcie a zahrnúť ich do odpovede robota.
Príklad vlastnej akcie
Povedzme, že chcete, aby váš chatbot poskytoval aktuálne informácie o počasí pre konkrétne miesto. Môžete vytvoriť vlastnú akciu, ktorá zavolá rozhranie API počasia a vráti údaje o počasí.
const axios = vyžadovať ( 'axios' );const getWeather = async ( užívateľ , session, args) => {
const location = args.location || 'New York' ;
const apiKey = 'your_weather_api_key' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;
skúste {
const response = wait axios.get(apiUrl);
const weatherData = response.data;
return `Aktuálne počasie v ${location} je ${weatherData.current.condition.text} s teplotou ${weatherData.current.temp_c}°C.`;
} catch (chyba) {
vrátiť 'Prepáč, nemohol som \' t získať aktuálne informácie o počasí. Skúste neskôr prosím.' ;
}
};
return getWeather( užívateľ , relácia, argumenty);
Táto akcia vyžaduje určité argumenty vrátane používateľa, relácie a argumentov, ktoré poskytujú kontext a údaje, s ktorými má akcia pracovať. V tomto príklade používa vlastná akcia „getWeather“ miesto ako argument alebo ak nie je zadaná, predvolene sa použije „New York“. Akcia zavolá rozhranie Weather API pomocou Axios, načíta údaje o počasí a vráti správu, ktorá obsahuje stav počasia a teplotu.
Výhody vlastných akcií
Vlastné akcie v Botpresse ponúkajú niekoľko výhod, ktoré zlepšujú možnosti a funkčnosť vášho chatbota:
- Rozširujú funkčnosť chatbota nad rámec vstavaných možností.
- Vytvárajú prispôsobené interakcie pre lepšiu používateľskú skúsenosť.
- Načítavajú dáta v reálnom čase z API pre dynamické odpovede.
- Integrujú sa s backendovými systémami a databázami.
- Zvládajú zložité scenáre pomocou vlastného kódu.
- Opätovne používajú akcie v rámci chatbotov a tokov.
- Implementujú vlastné spracovanie chýb a protokolovanie.
- Optimalizujú úlohy náročné na zdroje.
- Na škálovanie využívajú externé služby.
- Majú prístup k vopred vytvoreným vlastným akciám a zdieľajú ich.
Záver
Vlastné akcie v Botpresse rozširujú možnosti chatbota, prispôsobujú interakcie a integrujú externé API. Vývojári vytvárajú funkcie JavaScript na strane servera a vyvolávajú ich z nástroja Botpress Flow Builder. Tieto akcie ponúkajú opätovnú použiteľnosť kódu, vylepšený výkon a škálovateľnosť, vďaka čomu sú chatboty všestrannejšie a výkonnejšie nástroje. Využitie vlastných akcií v Botpresse vytvára inovatívne a pútavé skúsenosti s chatbotmi.