Pag-unawa sa Mga Uri ng Data para sa Mga Variable
Bago tayo sumisid sa mga praktikal na aspeto ng paggamit ng mga variable, maging pamilyar tayo sa iba't ibang available na uri ng data sa Botpress.
- String: Ang mga string ay ginagamit upang iimbak ang teksto na maaaring binubuo ng mga titik, numero, o mga espesyal na character. Karaniwang ginagamit ang mga ito upang mag-imbak ng mga user name o mga mensaheng binuo ng AI.
- Boolean: Ang mga Boolean ay maaari lamang magkaroon ng dalawang halaga - totoo o mali. Ang mga ito ay mainam para sa pag-iimbak ng binary na impormasyon tulad ng kung ang isang user ay isang bumabalik na customer o kung ang user ay gustong magtanong ng iba.
- Numero: Gaya ng ipinahihiwatig ng pangalan, ang mga variable ng numero ay ginagamit upang mag-imbak ng mga numeric na halaga na maaaring alinman sa mga integer o mga numero na may mga decimal na lugar. Ang mga ito ay kapaki-pakinabang para sa pag-iimbak ng mga numero ng telepono, area code, at iba pang numerical na data.
- Petsa: Ginagamit ng mga variable ng Petsa ang format ng petsa/oras na ISO 8601. Ito ay kumakatawan sa alinman sa isang petsa o isang petsa at oras.
- bagay: Ang object variable ay isang koleksyon ng mga key-value pairs na katulad ng mga diksyunaryo o mapa. Mahalaga ang mga ito para sa pag-iimbak ng mga kumplikadong istruktura ng data gaya ng mga profile ng user o mga resulta ng isang tawag sa API.
- Array: Ang mga array ay ginagamit upang mag-imbak ng mga koleksyon ng mga katulad na variable. Maaari nilang hawakan ang mga string o mga bagay, na ginagawa itong versatile para sa iba't ibang mga kaso ng paggamit tulad ng pag-iimbak ng mga nakaraang mensahe ng user o pagbibigay ng mga opsyon na mapagpipilian ng user.
- Enum: Isa itong variable na may limitadong hanay ng mga paunang natukoy na pagpipilian. Angkop ang mga ito para sa mga sitwasyon tulad ng pag-iimbak ng mga araw ng linggo o ang mga available na item sa isang menu ng pagkain.
- Pattern: Ginagamit ng mga variable ng pattern ang Regular Expressions (Regex) upang iimbak ang mga espesyal na pattern na maaaring magamit upang tumugma sa mga partikular na salita o numero. Ang mga ito ay madaling gamitin para sa pag-iimbak ng mga account number o flight number.
Pag-unawa sa Mga Saklaw ng Variable
Iba't ibang uri ng mga variable ang kasama sa Botpress, at iba-iba ang mga ito depende sa kung saan sila maa-access sa daloy ng iyong chatbot. Tuklasin natin ang iba't ibang saklaw ng variable, simula sa pinakalimitado hanggang sa pinakamalawak:
Mga Variable ng Workflow
Ang mga variable na ito ay tinukoy at ginagamit sa loob ng isa o parehong workflow. Mahusay ang mga ito para sa mga single-use na daloy tulad ng pag-iimbak ng mga output ng gawain ng AI, mga sagot ng user sa mga tanong, o pag-aayos ng data mula sa mga tawag sa API.
Maaaring sundin ang mga hakbang na ito para sa paggawa ng variable ng daloy ng trabaho:
Hakbang 1. Piliin ang naaangkop na daloy ng trabaho sa menu na 'Explorer'.
Hakbang 2. Ang pag-double click sa isang walang laman na lugar sa editor ng daloy ng trabaho ay magbubukas sa panel ng Inspector.
Hakbang 3. Tukuyin ang pangalan ng variable, piliin ang uri ng data ng variable, at i-click ang button na 'Idagdag' upang gawin ang variable.
Maaari kang magdagdag ng default (initial) na halaga sa iyong variable mula sa seksyong 'Mga Karagdagang Setting.'
Mga Variable ng Input at Output Workflow
Upang makipagpalitan ng impormasyon, ang mga daloy ng trabaho ay maaaring may mga variable ng input at output. Ginagamit ang mga input upang makatanggap ng impormasyon mula sa mga panlabas na mapagkukunan o iba pang mga daloy ng trabaho, habang ang mga output ay nagbibigay ng impormasyon sa mga panlabas na mapagkukunan o iba pang mga daloy ng trabaho. Nagbibigay-daan ito para sa mas nababaluktot na komunikasyon at pagpapalitan ng data sa loob ng bot.
Maaaring sundin ang mga hakbang na ito para sa pagmamarka ng input variable:
Hakbang 1. Lumikha ng variable sa loob ng workflow.
Hakbang 2. Piliin ang variable sa pamamagitan ng pag-click sa entry node ng workflow sa Inspector panel.
Ang mga hakbang na ito ay maaaring sundin para sa pagmamarka ng isang output variable:
Hakbang 1. Lumikha ng variable sa loob ng workflow.
Hakbang 2. Piliin ang variable sa pamamagitan ng pag-click sa exit node ng workflow sa Inspector panel.
Mga Variable ng Session
Maa-access ng lahat ng daloy ang mga variable na ito, ngunit para lang sa isang pag-uusap. Tamang-tama ang mga ito para sa pag-iimbak ng data na ginagamit sa buong pag-uusap gaya ng kasaysayan ng chat, mga nakolektang item sa isang virtual shopping cart, o pansamantalang data mula sa mga tawag sa API.
Upang lumikha ng variable ng session, maaari mong isulat ang sumusunod na code:
session.variablename = 'Hello Guys!' ;Para sa paggamit ng iyong variable sa isang text card, kailangan namin itong isara sa mga kulot na bracket, hal., {{session.variablename}} .
Mga Variable ng User
Sinusundan ng mga variable ng user ang isang user sa pagitan ng mga pag-uusap na nagpapahintulot sa data na magpatuloy sa maraming pakikipag-ugnayan sa chatbot. Ang mga ito ay perpekto para sa pag-iimbak ng impormasyon na nananatiling may kaugnayan sa isang user sa paglipas ng panahon gaya ng mga personal na detalye, mga tag mula sa mga nakaraang pag-uusap, o mga kagustuhan sa wika.
Para gumawa ng variable ng user:
Hakbang 1. Buksan ang 'Mga Setting ng Chatbot' mula sa icon ng Botpress na matatagpuan sa kaliwang sulok sa itaas.
Hakbang 2. Piliin ang 'Mga Variable' mula sa mga tab.
Hakbang 3. Tukuyin ang variable ng user sa pamamagitan ng pagpapangalan dito at pagtukoy sa uri ng data.
Maaaring gamitin ang alinman sa @user.variablename o {{user.variablename}} para sumangguni sa variable na “User” sa isang text card.
Mga Variable ng Bot
Ang lahat ng user sa chatbot ay may access sa mga variable na ito sa lahat ng pag-uusap. Madalas na ginagamit ang mga ito upang mag-imbak ng impormasyon at configuration ng developer tulad ng pag-iimbak ng mga endpoint para sa mga tawag sa API, numero ng bersyon ng bot, o pangalan nito.
Sundin ang mga hakbang na ito para sa paggawa ng variable ng Bot:
Hakbang 1. Piliin ang 'Mga Setting ng Chatbot' sa pamamagitan ng pag-click sa icon ng Botpress sa kaliwang sulok sa itaas.
Hakbang 2. Piliin ang 'Mga Variable' mula sa mga tab.
Hakbang 3. Tukuyin ang pangalan at uri ng data ng variable ng bot.
Tulad ng mga variable ng user, maaaring gamitin ang @bot.variablename o bot.variablename para sumangguni sa mga variable ng bot sa mga card.
Mga Variable ng Configuration
Ang mga ito ay isang espesyal na uri ng secure na bot variable. Maaari mong pamahalaan ang mga ito mula sa Cloud Dashboard, at hindi na kailangang buksan ang bot. Ang mga variable ng configuration ay mainam para sa pag-imbak ng sensitibong impormasyon tulad ng mga token ng API, pribadong IP address, o mga kredensyal sa database.
Para gumawa ng configuration variable:
Hakbang 1. Buksan ang 'Mga Setting ng Chatbot' mula sa icon ng Botpress na matatagpuan sa kaliwang sulok sa itaas.
Hakbang 2. Mag-click sa tab na 'Mga Variable'.
Hakbang 3. Magdagdag ng configuration variable at ibigay ang pangalan at halaga nito.
Upang ma-access ang mga variable ng configuration sa code, maaari mong gamitin ang 'env.key' kung saan kinakatawan ng 'key' ang pangalan ng variable ng configuration na kukunin.
Paggamit ng mga Variable sa Code
Ang mga kulot na bracket na “{{ }}” o @ na simbolo ay hindi kailangan kapag gumagamit ng mga variable sa code. Ang syntax para sa pag-access sa mga variable sa code ay sumusunod sa pattern na 'variabletype.variablename'. Halimbawa:
Code:
- daloy ng trabaho.phoneNumber
- session.userAcctId
- user.firstName
- bot.endpoint
- env.apiKey
Ang mga variable ay maaaring italaga na may mga halaga o na-update sa code. Ngunit mahalagang tiyaking tumutugma ang nakatalagang halaga sa uri ng data ng variable upang maiwasan ang mga error.
Konklusyon
Ang mga variable ay ang pagbuo ng mga dynamic at personalized na pakikipag-ugnayan sa Botpress. Sa pamamagitan ng paggamit ng iba't ibang uri ng data at pag-unawa sa mga variable na saklaw, ang mga developer ay makakagawa ng mga chatbot na may malalakas na kakayahan. Kung kailangan mong iimbak ang impormasyon ng user, pagkonekta sa mga API o pagpasa ng data sa pagitan ng mga workflow at variable sa Botpress ay nagbibigay ng kinakailangang flexibility at kontrol.