متغیرات کے لیے ڈیٹا کی اقسام کو سمجھنا
اس سے پہلے کہ ہم متغیرات کے استعمال کے عملی پہلوؤں پر غور کریں، آئیے Botpress میں دستیاب ڈیٹا کی مختلف اقسام سے خود کو واقف کریں۔
- سٹرنگ: اسٹرنگ کا استعمال متن کو ذخیرہ کرنے کے لیے کیا جاتا ہے جس میں حروف، اعداد یا خصوصی حروف شامل ہو سکتے ہیں۔ وہ عام طور پر صارف کے نام یا AI سے تیار کردہ پیغامات کو ذخیرہ کرنے کے لیے استعمال ہوتے ہیں۔
- بولین: بولین صرف دو اقدار رکھ سکتے ہیں - صحیح یا غلط۔ وہ بائنری معلومات کو ذخیرہ کرنے کے لیے مثالی ہیں جیسے کہ آیا صارف واپس آنے والا صارف ہے یا صارف کچھ اور پوچھنا چاہتا ہے۔
- نمبر: جیسا کہ نام سے پتہ چلتا ہے، نمبر متغیرات کو عددی قدروں کو ذخیرہ کرنے کے لیے استعمال کیا جاتا ہے جو یا تو عددی یا عددی مقامات کے ساتھ اعداد ہو سکتے ہیں۔ وہ فون نمبرز، ایریا کوڈز، اور دیگر عددی ڈیٹا کو ذخیرہ کرنے کے لیے مفید ہیں۔
- تاریخ: تاریخ کے متغیر ISO 8601 تاریخ/وقت کی شکل استعمال کرتے ہیں۔ یہ یا تو ایک تاریخ یا تاریخ اور وقت کی نمائندگی کرتا ہے۔
- چیز: آبجیکٹ متغیر کلیدی قدر کے جوڑوں کا مجموعہ ہے جو لغات یا نقشوں سے ملتے جلتے ہیں۔ وہ پیچیدہ ڈیٹا ڈھانچے جیسے صارف پروفائلز یا API کال کے نتائج کو ذخیرہ کرنے کے لیے قیمتی ہیں۔
- صف: صفوں کا استعمال اسی طرح کے متغیرات کے مجموعوں کو ذخیرہ کرنے کے لیے کیا جاتا ہے۔ وہ تاروں یا اشیاء کو پکڑ سکتے ہیں، انہیں مختلف استعمال کے معاملات کے لیے ورسٹائل بناتے ہیں جیسے کہ صارف کے ماضی کے پیغامات کو اسٹور کرنا یا صارف کو انتخاب کرنے کے لیے اختیارات فراہم کرنا۔
- اینوم: یہ ایک متغیر ہے جس میں پہلے سے طے شدہ انتخاب کے محدود سیٹ ہیں۔ وہ ایسے منظرناموں کے لیے موزوں ہیں جیسے ہفتے کے دنوں کو ذخیرہ کرنا یا کھانے کے مینو میں دستیاب اشیاء۔
- پیٹرن: پیٹرن کے متغیر مخصوص نمونوں کو ذخیرہ کرنے کے لیے ریگولر ایکسپریشنز (Regex) کا استعمال کرتے ہیں جو مخصوص الفاظ یا اعداد سے ملنے کے لیے استعمال کیے جا سکتے ہیں۔ وہ اکاؤنٹ نمبرز یا فلائٹ نمبرز کو محفوظ کرنے کے لیے کارآمد ہیں۔
متغیر دائرہ کار کو سمجھنا
Botpress میں مختلف قسم کے متغیرات شامل ہیں، اور وہ اس بات پر منحصر ہوتے ہیں کہ وہ آپ کے چیٹ بوٹ کے بہاؤ میں کہاں قابل رسائی ہو سکتے ہیں۔ آئیے مختلف متغیر دائرہ کاروں کو دریافت کریں، سب سے زیادہ محدود سے لے کر وسیع ترین تک:
ورک فلو متغیرات
ان متغیرات کو ایک یا ایک ہی ورک فلو کے اندر بیان کیا اور استعمال کیا جاتا ہے۔ وہ واحد استعمال کے بہاؤ کے لیے بہترین ہیں جیسے کہ AI ٹاسک آؤٹ پٹ کو اسٹور کرنا، صارف کے سوالات کے جوابات، یا API کالز سے ڈیٹا کو منظم کرنا۔
ورک فلو متغیر بنانے کے لیے ان اقدامات پر عمل کیا جا سکتا ہے:
مرحلہ نمبر 1. 'ایکسپلورر' مینو میں مناسب ورک فلو کو منتخب کریں۔
مرحلہ 2. ورک فلو ایڈیٹر میں خالی جگہ پر ڈبل کلک کرنے سے انسپکٹر پینل کھل جاتا ہے۔
مرحلہ 3۔ متغیر کا نام بتائیں، متغیر کی ڈیٹا کی قسم منتخب کریں، اور متغیر بنانے کے لیے 'شامل کریں' بٹن پر کلک کریں۔
آپ 'اضافی ترتیبات' سیکشن سے اپنے متغیر میں ڈیفالٹ (ابتدائی) قدر شامل کر سکتے ہیں۔
ان پٹ اور آؤٹ پٹ ورک فلو متغیرات
معلومات کا تبادلہ کرنے کے لیے، ورک فلو میں ان پٹ اور آؤٹ پٹ متغیرات ہوسکتے ہیں۔ ان پٹ کا استعمال بیرونی ذرائع یا دیگر ورک فلو سے معلومات حاصل کرنے کے لیے کیا جاتا ہے، جب کہ آؤٹ پٹ بیرونی ذرائع یا دیگر ورک فلوز کو معلومات فراہم کرتے ہیں۔ یہ بوٹ کے اندر زیادہ لچکدار مواصلات اور ڈیٹا کے تبادلے کی اجازت دیتا ہے۔
ان پٹ متغیر کو نشان زد کرنے کے لیے ان اقدامات پر عمل کیا جا سکتا ہے:
مرحلہ نمبر 1. ورک فلو کے اندر متغیر بنائیں۔
مرحلہ 2. انسپکٹر پینل میں ورک فلو کے انٹری نوڈ پر کلک کر کے متغیر کو منتخب کریں۔
آؤٹ پٹ متغیر کو نشان زد کرنے کے لیے ان اقدامات پر عمل کیا جا سکتا ہے:
مرحلہ نمبر 1. ورک فلو کے اندر متغیر بنائیں۔
مرحلہ 2. انسپکٹر پینل میں ورک فلو کے ایگزٹ نوڈ پر کلک کر کے متغیر کو منتخب کریں۔
سیشن متغیرات
تمام بہاؤ ان متغیرات تک رسائی حاصل کر سکتے ہیں، لیکن صرف ایک ہی گفتگو کے لیے۔ وہ اس ڈیٹا کو ذخیرہ کرنے کے لیے مثالی ہیں جو گفتگو کے دوران استعمال ہوتا ہے جیسے کہ چیٹ کی سرگزشت، ورچوئل شاپنگ کارٹ میں جمع کردہ اشیاء، یا API کالز سے عارضی ڈیٹا۔
سیشن متغیر بنانے کے لیے، آپ درج ذیل کوڈ لکھ سکتے ہیں:
session.variablename = 'ہیلو لوگ!' ;اپنے متغیر کو ٹیکسٹ کارڈ میں استعمال کرنے کے لیے، ہمیں اسے گھوبگھرالی بریکٹ میں بند کرنا ہوگا، جیسے، {{session.variablename}} .
صارف متغیرات
صارف کے متغیر گفتگو کے درمیان صارف کی پیروی کرتے ہیں جو ڈیٹا کو چیٹ بوٹ کے ساتھ متعدد تعاملات میں برقرار رہنے کی اجازت دیتا ہے۔ وہ ایسی معلومات کو ذخیرہ کرنے کے لیے بہترین ہیں جو وقت گزرنے کے ساتھ ساتھ صارف کے لیے متعلقہ رہتی ہے جیسے کہ ذاتی تفصیلات، ماضی کی بات چیت کے ٹیگز، یا زبان کی ترجیحات۔
صارف متغیر بنانے کے لیے:
مرحلہ نمبر 1. اوپری بائیں کونے میں واقع Botpress آئیکن سے 'چیٹ بوٹ سیٹنگز' کھولیں۔
مرحلہ 2. ٹیبز سے 'متغیرات' کو منتخب کریں۔
مرحلہ 3۔ صارف متغیر کو نام دے کر اور ڈیٹا کی قسم بتا کر اس کی وضاحت کریں۔
ٹیکسٹ کارڈ میں 'صارف' متغیر کا حوالہ دینے کے لیے یا تو @user.variablename یا {{user.variablename}} استعمال کیا جا سکتا ہے۔
بوٹ متغیرات
چیٹ بوٹ کے تمام صارفین کو تمام بات چیت میں ان متغیرات تک رسائی حاصل ہے۔ وہ اکثر ڈویلپر کی معلومات اور کنفیگریشن کو اسٹور کرنے کے لیے استعمال ہوتے ہیں جیسے API کالز، بوٹ کے ورژن نمبر، یا اس کے نام کے لیے اینڈ پوائنٹس کو اسٹور کرنا۔
بوٹ متغیر بنانے کے لیے ان اقدامات پر عمل کریں:
مرحلہ نمبر 1. اوپری بائیں کونے میں Botpress آئیکن پر کلک کرکے 'Chatbot Settings' کو منتخب کریں۔
مرحلہ 2. ٹیبز سے 'متغیرات' کو منتخب کریں۔
مرحلہ 3۔ بوٹ متغیر کے نام اور ڈیٹا کی قسم کی وضاحت کریں۔
صارف کے متغیرات کی طرح، @bot.variablename یا bot.variablename کارڈز میں بوٹ متغیرات کا حوالہ دینے کے لیے استعمال کیا جا سکتا ہے۔
کنفیگریشن متغیرات
وہ ایک خاص قسم کے محفوظ بوٹ متغیر ہیں۔ آپ کلاؤڈ ڈیش بورڈ سے ان کا نظم کر سکتے ہیں، اور بوٹ کو کھولنے کی ضرورت نہیں ہے۔ کنفیگریشن متغیر حساس معلومات جیسے API ٹوکنز، پرائیویٹ IP ایڈریسز، یا ڈیٹا بیس کی اسناد کو ذخیرہ کرنے کے لیے مثالی ہیں۔
کنفیگریشن متغیر بنانے کے لیے:
مرحلہ نمبر 1. اوپری بائیں کونے میں واقع Botpress آئیکن سے 'چیٹ بوٹ سیٹنگز' کھولیں۔
مرحلہ 2. 'متغیرات' ٹیب پر کلک کریں۔
مرحلہ 3۔ کنفیگریشن متغیر شامل کریں اور اس کا نام اور قدر فراہم کریں۔
کوڈ میں کنفیگریشن متغیرات تک رسائی کے لیے، آپ 'env.key' استعمال کر سکتے ہیں جہاں 'key' کنفیگریشن متغیر نام کی نمائندگی کرتا ہے جسے بازیافت کیا جانا ہے۔
کوڈ میں متغیرات کا استعمال
کوڈ میں متغیرات کا استعمال کرتے وقت گھوبگھرالی بریکٹ '{{ }}' یا @ علامت ضروری نہیں ہے۔ کوڈ میں متغیرات تک رسائی کے لیے نحو 'variabletype.variablename' پیٹرن کی پیروی کرتا ہے۔ مثال کے طور پر:
کوڈ:
- workflow.phoneNumber
- session.userAcctId
- user.firstName
- bot.endpoint
- env.apiKey
متغیرات کو اقدار کے ساتھ تفویض کیا جا سکتا ہے یا کوڈ میں اپ ڈیٹ کیا جا سکتا ہے۔ لیکن یہ یقینی بنانا بہت ضروری ہے کہ غلطیوں سے بچنے کے لیے تفویض کردہ قدر متغیر کے ڈیٹا کی قسم سے میل کھاتی ہے۔
نتیجہ
متغیرات بوٹپریس میں متحرک اور ذاتی نوعیت کے تعاملات کے بنیادی بلاکس ہیں۔ ڈیٹا کی مختلف اقسام کو استعمال کرکے اور متغیر دائرہ کار کو سمجھ کر، ڈویلپرز طاقتور صلاحیتوں کے ساتھ چیٹ بوٹس بنا سکتے ہیں۔ چاہے آپ کو صارف کی معلومات کو ذخیرہ کرنے کی ضرورت ہو، APIs کے ساتھ جڑنا ہو یا Botpress میں ورک فلو اور متغیرات کے درمیان ڈیٹا کو منتقل کرنا ضروری لچک اور کنٹرول فراہم کرتا ہے۔