Botpressin toimintojen ymmärtäminen
Botpressin toiminnot ovat palvelinpuolen toimintoja, jotka botti suorittaa keskustelun aikana. Heillä on valta muuttaa keskustelun tilaa, lähettää mukautettuja viestejä, suorittaa mielivaltaista koodia (kuten kutsua API-liittymiä tai tallentaa tietoja) ja paljon muuta. Pohjimmiltaan toiminnot ovat tavallisia JavaScript-toimintoja, mikä tarkoittaa, että ne voivat suorittaa melkein mitä tahansa alustan rajoissa.
Kun Dialogue Manager (DM) käynnistää toiminnon, se vastaanottaa useita argumentteja, jotka tarjoavat toiminnolle kontekstin. Nämä argumentit sisältävät käyttäjän määritteet, istuntomuuttujat, väliaikaiset muuttujat, bot-tason muuttujat, keskustelun viimeisimmän käyttäjätapahtuman, Visual Flow Builderin välitetyt argumentit ja joitain ympäristömuuttujia sisältävän hiekkalaatikon virtuaalikoneen.
Uusien toimien rekisteröinti
Jos haluat lisätä mukautettuja bottitoimintoja, sinun on luotava JavaScript-tiedosto (.js) ja asetettava se data/globaali/toiminnot kansio Botpress-projektissasi. Valitettavasti ei ole mahdollista lisätä ohjelmallisesti uusia toimintoja suorituksen aikana. Käyttämällä JavaDoc-kommentteja koodissasi voit antaa merkityksellisiä tietoja toiminnoista, kuten niiden nimen, kuvauksen, argumentit ja oletusarvot. Voit myös piilottaa toiminnon kulkueditorissa lisäämällä @hidden true -lipun JavaDoc-kommenttiin.
Kuinka luoda mukautettuja toimintoja Botpressissa
Tässä on muutamia vaiheita, joita voit noudattaa luodaksesi mukautetun toiminnon Botpressissa:
Vaihe 1: Luo bottisi ja lisää solmu
Aloita luomalla uusi botti Botpressissa. Kun bottisi on luotu, lisää keskustelukulkuun uusi solmu.
Vaihe 2: Lisää sopivat viestit solmuun
Lisää äskettäin luotuun solmuun tarvittavat viestit sisällönvaihdon helpottamiseksi käyttäjien kanssa. Voit esimerkiksi lisätä tekstiviestin tervehtiäksesi käyttäjää ja kysyäksesi hänen nimeään.
Vaihe 3: Avaa suorituskoodi sivupalkista
Siirry Botpress Flow Builderin sivupalkkiin ja avaa 'Koodieditori'. Täällä voit rakentaa ja hallita mukautettuja toimintojasi.
Vaihe 4: Napsauta 'Lisää toiminto' -painiketta
Napsauta 'Suorita koodi' -osiossa 'Lisää toiminto' -painiketta. Tämä toiminto avaa 'Luo uusi action_legacy' -ikkunan.
Vaihe 5: Määritä tiedostolle nimi ja napsauta Lähetä-painiketta
Anna 'Create a new action_legacy' -ikkunassa mielekäs nimi mukautetulle toimintotiedostollesi. esimerkiksi customAction.js. Kun olet määrittänyt nimen, napsauta 'Lähetä' -painiketta. Tämä luo 'customAction.js'-tiedoston.
Vaihe 6: Kirjoita mukautettu koodi
Avaa äskettäin luotu 'customAction.js'-tiedosto. Tiedoston sisällä näet uudelle toiminnolle luodun mallikoodin. Anna mielekäs kuvaus mukautetulle toiminnallesi käyttämällä asianmukaisia kommentteja.
Kirjoita nyt mukautettu koodisi funktioon. Tämä koodi määrittää mukautetun toiminnon toiminnan. JavaScriptin avulla voit suorittaa erilaisia tehtäviä, kuten tehdä API-kutsuja, käyttää tietokantoja tai käsitellä monimutkaista logiikkaa.
Vaihe 7: Muokkaa solmuasi käyttämään mukautettua toimintoa
Palaa Botpress Flow Builderiin ja muokkaa solmua, jossa haluat käynnistää mukautetun toiminnon. Lisää 'Execute Code' -kortti solmuun.
Vaihe 8: Valitse mukautettu toimintonimi ja määritä toimintoparametrit
'Suorita koodi' -kortissa näet avattavan luettelon, joka sisältää kaikkien mukautettujen toimintojesi nimet. Valitse mukautetun toiminnon nimi luettelosta. Jos mukautettu toiminto edellyttää parametreja, voit määrittää ne 'Suorita koodi' -kortin Parametrit-osiossa.
Vaihe 9: Anna bottisi suorittaa toiminto
Lisää lopuksi toinen kortti solmuun, jotta bottisi suorittaa mukautetun toiminnon. Voit käyttää tapahtumaan tallennettuja muuttujia (määritetty 'Suorita koodi' -kortissa) päästäksesi käsiksi mukautetun toiminnon tuloksiin ja sisällyttääksesi ne botin vastaukseen.
Esimerkki mukautetusta toiminnosta
Oletetaan, että haluat chatbotin tarjoavan tietyn sijainnin nykyiset säätiedot. Voit luoda mukautetun toiminnon, joka kutsuu sää API:n ja palauttaa säätiedot.
const axios = vaatia ( 'aksiot' );const getWeather = async ( käyttäjä , istunto, args) => {
const sijainti = args.location || 'New York' ;
const apiKey = 'your_weather_api_key' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;
yrittää {
const vastaus = odota axios.get(apiUrl);
const weatherData = vastaus.data;
return `Nykyinen sää paikassa ${location} on ${weatherData.current.condition.text} ja lämpötila on ${weatherData.current.temp_c}°C.`;
} saalis (virhe) {
palata 'Anteeksi, en voinut \' t hae säätietoja tällä hetkellä. Yritä uudelleen myöhemmin.' ;
}
};
paluu getWeather( käyttäjä , istunto, args);
Tämä toiminto ottaa käyttöön tietyt argumentit, mukaan lukien käyttäjä, istunto ja argumentit, jotka tarjoavat kontekstin ja tiedot toiminnolle. Tässä esimerkissä mukautettu getWeather-toiminto ottaa sijainnin argumenttina tai oletuksena on New York, jos sitä ei ole annettu. Toiminto kutsuu Weather API:ta Axiosin avulla, hakee säätiedot ja palauttaa viestin, joka sisältää säätilan ja lämpötilan.
Mukautettujen toimintojen edut
Mukautetut toiminnot Botpressissa tarjoavat useita etuja, jotka parantavat chatbotisi ominaisuuksia ja toimintoja:
- Ne laajentavat chatbotin toimintoja sisäänrakennettujen ominaisuuksien lisäksi.
- Ne luovat räätälöityjä vuorovaikutuksia paremman käyttökokemuksen saavuttamiseksi.
- Ne hakevat reaaliaikaista dataa API:ilta dynaamisia vastauksia varten.
- Ne integroituvat taustajärjestelmiin ja tietokantoihin.
- He käsittelevät monimutkaisia skenaarioita mukautetulla koodilla.
- He käyttävät toimintoja uudelleen chatbottien ja -virtojen välillä.
- Ne toteuttavat mukautetun virheenkäsittelyn ja kirjauksen.
- Ne optimoivat resurssiintensiiviset tehtävät.
- Ne hyödyntävät ulkoisia palveluita skaalaukseen.
- He käyttävät ja jakavat valmiita mukautettuja toimintoja.
Johtopäätös
Botpressin mukautetut toiminnot laajentavat chatbotin ominaisuuksia, personoivat vuorovaikutusta ja integroivat ulkoisia sovellusliittymiä. Kehittäjät luovat palvelinpuolen JavaScript-funktioita ja kutsuvat niitä Botpress Flow Builderista. Nämä toiminnot tarjoavat koodin uudelleenkäytettävyyttä, parempaa suorituskykyä ja skaalautuvuutta, mikä tekee chatboteista monipuolisempia ja tehokkaampia työkaluja. Botpressin mukautettujen toimien hyödyntäminen luo innovatiivisia ja mukaansatempaavia chatbot-kokemuksia.