بوٹپریس میں کارروائیوں کو سمجھنا
بوٹپریس میں ایکشنز سرور سائیڈ فنکشنز ہیں جو بوٹ کے ذریعے بات چیت کے بہاؤ کے دوران کیے جاتے ہیں۔ ان کے پاس بات چیت کی حالت کو تبدیل کرنے، حسب ضرورت پیغامات بھیجنے، صوابدیدی کوڈ پر عمل درآمد کرنے (جیسے APIs کو کال کرنا یا ڈیٹا اسٹور کرنا) اور مزید بہت کچھ کرنے کا اختیار ہے۔ بنیادی طور پر، اعمال جاوا اسکرپٹ کے باقاعدہ افعال ہیں جس کا مطلب ہے کہ وہ پلیٹ فارم کی حدود میں تقریباً کچھ بھی کر سکتے ہیں۔
جب ڈائیلاگ مینیجر (DM) کے ذریعہ ایک کارروائی کی درخواست کی جاتی ہے، تو اسے کئی دلائل موصول ہوتے ہیں جو فنکشن کو سیاق و سباق فراہم کرتے ہیں۔ ان دلائل میں صارف کے اوصاف، سیشن متغیرات، عارضی متغیرات، بوٹ لیول کے متغیرات، گفتگو میں صارف کا تازہ ترین واقعہ، بصری فلو بلڈر سے منظور شدہ دلائل، اور ایک سینڈ باکسڈ vm شامل ہیں جس میں کچھ ماحولیاتی متغیرات شامل ہیں۔
نئی کارروائیوں کا اندراج
حسب ضرورت بوٹ ایکشنز کو شامل کرنے کے لیے، آپ کو جاوا اسکرپٹ فائل (.js) بنانے کی ضرورت ہے اور اسے ڈیٹا/عالمی/کارروائیاں آپ کے بوٹپریس پروجیکٹ کے اندر فولڈر۔ بدقسمتی سے، رن ٹائم کے دوران پروگرام کے مطابق نئی کارروائیاں شامل کرنے کا کوئی طریقہ نہیں ہے۔ اپنے کوڈ میں JavaDoc تبصروں کا استعمال کرتے ہوئے، آپ اعمال کے بارے میں معنی خیز معلومات فراہم کر سکتے ہیں جیسے کہ ان کا نام، تفصیل، دلائل، اور طے شدہ اقدار۔ آپ JavaDoc تبصرے میں @hidden true flag شامل کر کے فلو ایڈیٹر میں ایکشن کو بھی چھپا سکتے ہیں۔
بوٹپریس میں کسٹم ایکشن کیسے بنائیں
Botpress میں حسب ضرورت ایکشن بنانے کے لیے آپ یہاں چند اقدامات کر سکتے ہیں:
مرحلہ 1: اپنا بوٹ بنائیں اور نوڈ شامل کریں۔
شروع کرنے کے لیے، Botpress میں ایک نیا بوٹ بنائیں۔ ایک بار جب آپ کا بوٹ بن جائے تو گفتگو کے بہاؤ میں ایک نیا نوڈ شامل کریں۔
مرحلہ 2: اپنے نوڈ میں مناسب پیغامات شامل کریں۔
نئے بنائے گئے نوڈ میں، صارفین کے ساتھ مواد کے تبادلے کی سہولت کے لیے ضروری پیغامات شامل کریں۔ مثال کے طور پر، آپ صارف کو سلام کرنے کے لیے ایک ٹیکسٹ میسج شامل کر سکتے ہیں اور ان کا نام پوچھ سکتے ہیں۔
مرحلہ 3: سائڈبار سے Execute Code کھولیں۔
بوٹپریس فلو بلڈر میں سائڈبار پر جائیں اور 'کوڈ ایڈیٹر' کھولیں۔ یہ وہ جگہ ہے جہاں آپ اپنی مرضی کے مطابق اعمال کی تشکیل اور انتظام کر سکتے ہیں۔
مرحلہ 4: 'ایڈ ایکشن' بٹن پر کلک کریں۔
'Execute Code' سیکشن میں، 'Add Action' بٹن پر کلک کریں۔ یہ عمل 'ایک نیا ایکشن_لیگیسی بنائیں' ونڈو کو کھولتا ہے۔
مرحلہ 5: فائل کے لیے ایک نام بتائیں اور جمع کروائیں بٹن پر کلک کریں۔
'ایک نئی ایکشن_لیگیسی بنائیں' ونڈو میں، اپنی حسب ضرورت ایکشن فائل کے لیے ایک معنی خیز نام دیں۔ مثال کے طور پر customAction.js۔ نام بتانے کے بعد، 'جمع کروائیں' بٹن پر کلک کریں۔ یہ 'customAction.js' فائل بناتا ہے۔
مرحلہ 6: اپنا حسب ضرورت کوڈ لکھیں۔
نئی بنائی گئی 'customAction.js' فائل کو کھولیں۔ فائل کے اندر، آپ کو بوائلر پلیٹ کوڈ نظر آئے گا جو ایک نئی کارروائی کے لیے تیار کیا گیا ہے۔ مناسب تبصروں کا استعمال کرتے ہوئے اپنی مرضی کے مطابق کارروائی کے لیے ایک معنی خیز وضاحت فراہم کریں۔
اب، فنکشن کے اندر اپنا کسٹم کوڈ لکھیں۔ یہ کوڈ آپ کے حسب ضرورت عمل کے رویے کی وضاحت کرتا ہے۔ آپ JavaScript کا استعمال مختلف کاموں کو انجام دینے کے لیے کر سکتے ہیں جیسے API کال کرنا، ڈیٹا بیس تک رسائی حاصل کرنا، یا پیچیدہ منطق کو سنبھالنا۔
مرحلہ 7: کسٹم ایکشن استعمال کرنے کے لیے اپنے نوڈ میں ترمیم کریں۔
بوٹپریس فلو بلڈر پر واپس جائیں اور اس نوڈ میں ترمیم کریں جہاں آپ اپنی مرضی کے مطابق کارروائی کو متحرک کرنا چاہتے ہیں۔ نوڈ میں ایک 'Execute Code' کارڈ شامل کریں۔
مرحلہ 8: اپنی مرضی کے مطابق ایکشن کا نام منتخب کریں اور ایکشن کے پیرامیٹرز کی وضاحت کریں۔
'Execute Code' کارڈ میں، آپ کو ایک ڈراپ ڈاؤن فہرست نظر آئے گی جس میں آپ کے تمام حسب ضرورت کاموں کے نام ہوں گے۔ فہرست سے اپنی مرضی کے مطابق کارروائی کا نام منتخب کریں۔ اگر آپ کی حسب ضرورت کارروائی کو کسی پیرامیٹرز کی ضرورت ہے، تو آپ انہیں 'Execute Code' کارڈ کے 'پیرامیٹر' سیکشن میں بتا سکتے ہیں۔
مرحلہ 9: اپنے بوٹ کو ایکشن پرفارم کریں۔
آخر میں، اپنے بوٹ کو حسب ضرورت کارروائی کرنے کے لیے نوڈ میں ایک اور کارڈ شامل کریں۔ آپ اپنی حسب ضرورت کارروائی کے نتائج تک رسائی حاصل کرنے اور انہیں بوٹ کے جواب میں شامل کرنے کے لیے ایونٹ میں محفوظ کردہ متغیرات ('Execute Code' کارڈ میں بیان کردہ) استعمال کر سکتے ہیں۔
مثال حسب ضرورت کارروائی
فرض کریں کہ آپ چاہتے ہیں کہ آپ کا چیٹ بوٹ کسی مخصوص مقام کے لیے موجودہ موسم کی معلومات فراہم کرے۔ آپ ایک حسب ضرورت کارروائی تشکیل دے سکتے ہیں جو موسم API کو کال کرے اور موسم کا ڈیٹا واپس کرے۔
const axios = ضرورت ہے ( 'محور' );const getWeather = async ( صارف ، سیشن، آرگس) => {
const location = args.location || 'نیویارک' ;
const apiKey = 'آپ کا_موسم_اپی_کی' ;
const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;
کوشش کریں {
const جواب = await axios.get(apiUrl)؛
const weatherData = response.data؛
واپسی `${location} میں موجودہ موسم ہے ${weatherData.current.condition.text} جس کا درجہ حرارت ${weatherData.current.temp_c}°C.` ہے۔
} کیچ (خرابی) {
واپسی 'معذرت، میں کر سکا \' t اس وقت موسم کی معلومات حاصل کریں۔ براہ کرم کچھ دیر بعد کوشش کریں.' ;
}
};
واپس گیٹ ویدر( صارف ، سیشن، آرگس)
اس کارروائی میں صارف، سیشن، اور آرگس سمیت کچھ دلائل لی جاتی ہیں جو کارروائی کے لیے سیاق و سباق اور ڈیٹا فراہم کرتے ہیں۔ اس مثال میں، 'getWeather' حسب ضرورت کارروائی ایک دلیل کے طور پر مقام کو لے جاتی ہے یا اگر فراہم نہ کی گئی ہو تو 'نیویارک' پر ڈیفالٹ ہو جاتی ہے۔ ایکشن Axios کا استعمال کرتے ہوئے Weather API کو کال کرتا ہے، موسم کا ڈیٹا لاتا ہے، اور ایک پیغام واپس کرتا ہے جس میں موسم کی حالت اور درجہ حرارت ہوتا ہے۔
حسب ضرورت اعمال کے فوائد
بوٹپریس میں حسب ضرورت کارروائیاں کئی فوائد پیش کرتی ہیں جو آپ کے چیٹ بوٹ کی صلاحیتوں اور فعالیت کو بڑھاتی ہیں:
- وہ چیٹ بوٹ کی فعالیت کو بلٹ ان صلاحیتوں سے آگے بڑھاتے ہیں۔
- وہ صارف کے بہتر تجربے کے لیے موزوں تعاملات تخلیق کرتے ہیں۔
- وہ متحرک ردعمل کے لیے APIs سے ریئل ٹائم ڈیٹا لاتے ہیں۔
- وہ بیک اینڈ سسٹم اور ڈیٹا بیس کے ساتھ ضم ہوتے ہیں۔
- وہ اپنی مرضی کے کوڈ کے ساتھ پیچیدہ منظرناموں کو سنبھالتے ہیں۔
- وہ چیٹ بوٹس اور بہاؤ میں کارروائیوں کو دوبارہ استعمال کرتے ہیں۔
- وہ کسٹم ایرر ہینڈلنگ اور لاگنگ کو لاگو کرتے ہیں۔
- وہ وسائل سے متعلق کاموں کو بہتر بناتے ہیں۔
- وہ اسکیلنگ کے لیے بیرونی خدمات کا فائدہ اٹھاتے ہیں۔
- وہ پہلے سے تیار کردہ حسب ضرورت کارروائیوں تک رسائی اور اشتراک کرتے ہیں۔
نتیجہ
Botpress میں حسب ضرورت کارروائیاں چیٹ بوٹ کی صلاحیتوں کو بڑھاتی ہیں، تعاملات کو ذاتی بناتی ہیں، اور بیرونی APIs کو مربوط کرتی ہیں۔ ڈویلپرز سرور سائیڈ JavaScript فنکشنز بناتے ہیں اور انہیں Botpress Flow Builder سے طلب کرتے ہیں۔ یہ اعمال کوڈ کو دوبارہ استعمال کرنے، بہتر کارکردگی اور اسکیل ایبلٹی پیش کرتے ہیں جو چیٹ بوٹس کو زیادہ ورسٹائل اور طاقتور ٹولز بناتے ہیں۔ Botpress میں حسب ضرورت کارروائیوں کا فائدہ اٹھانا اختراعی اور دلکش چیٹ بوٹ کے تجربات تخلیق کرتا ہے۔