فهم أنواع البيانات للمتغيرات
قبل أن نتعمق في الجوانب العملية لاستخدام المتغيرات، دعونا نتعرف على أنواع البيانات المختلفة المتاحة في Botpress.
- خيط: تُستخدم السلاسل لتخزين النص الذي يمكن أن يتكون من أحرف أو أرقام أو أحرف خاصة. يتم استخدامها بشكل شائع لتخزين أسماء المستخدمين أو الرسائل التي ينشئها الذكاء الاصطناعي.
- منطقية: يمكن أن تحتوي القيم المنطقية على قيمتين فقط – صحيح أو خطأ. إنها مثالية لتخزين المعلومات الثنائية مثل ما إذا كان المستخدم عميلاً عائداً أو إذا كان المستخدم يريد طرح شيء آخر.
- رقم: كما يوحي الاسم، يتم استخدام متغيرات الأرقام لتخزين القيم الرقمية التي يمكن أن تكون إما أعدادًا صحيحة أو أرقامًا ذات منازل عشرية. وهي مفيدة لتخزين أرقام الهواتف ورموز المناطق والبيانات الرقمية الأخرى.
- تاريخ: تستخدم متغيرات التاريخ تنسيق التاريخ/الوقت ISO 8601. إنه يمثل إما تاريخًا واحدًا أو تاريخًا ووقتًا.
- هدف: متغير الكائن عبارة عن مجموعة من أزواج القيمة الرئيسية التي تشبه القواميس أو الخرائط. إنها ذات قيمة لتخزين هياكل البيانات المعقدة مثل ملفات تعريف المستخدمين أو نتائج استدعاء واجهة برمجة التطبيقات (API).
- مجموعة مصفوفة: يتم استخدام المصفوفات لتخزين مجموعات من المتغيرات المماثلة. يمكنها الاحتفاظ بالسلاسل أو الكائنات، مما يجعلها متعددة الاستخدامات لحالات الاستخدام المختلفة مثل تخزين رسائل المستخدم السابقة أو توفير الخيارات للمستخدم للاختيار من بينها.
- التعداد: هذا متغير ذو مجموعة محدودة من الاختيارات المحددة مسبقًا. إنها مناسبة لسيناريوهات مثل تخزين أيام الأسبوع أو العناصر المتوفرة في قائمة الطعام.
- نمط: تستخدم متغيرات النمط التعبيرات العادية (Regex) لتخزين الأنماط الخاصة التي يمكن استخدامها لمطابقة كلمات أو أرقام محددة. إنها سهلة الاستخدام لتخزين أرقام الحسابات أو أرقام الرحلات.
فهم النطاقات المتغيرة
يتم تضمين أنواع مختلفة من المتغيرات في Botpress، وتختلف اعتمادًا على المكان الذي يمكن الوصول إليه في تدفق برنامج الدردشة الآلي الخاص بك. دعونا نستكشف نطاقات المتغيرات المختلفة، بدءًا من الأكثر محدودية إلى الأوسع:
متغيرات سير العمل
ويتم تحديد هذه المتغيرات واستخدامها ضمن سير عمل واحد أو نفس سير العمل. إنها ممتازة للتدفقات ذات الاستخدام الواحد مثل تخزين مخرجات مهمة الذكاء الاصطناعي، أو إجابات المستخدم على الأسئلة، أو تنظيم البيانات من مكالمات واجهة برمجة التطبيقات.
يمكن اتباع هذه الخطوات لإنشاء متغير سير العمل:
الخطوة 1. حدد سير العمل المناسب في قائمة 'المستكشف'.
الخطوة 2. يؤدي النقر المزدوج على منطقة فارغة في محرر سير العمل إلى فتح لوحة Inspector.
الخطوه 3. حدد اسم المتغير، واختر نوع بيانات المتغير، ثم انقر فوق الزر 'إضافة' لإنشاء المتغير.
يمكنك إضافة قيمة افتراضية (أولية) إلى المتغير الخاص بك من قسم 'الإعدادات الإضافية'.
متغيرات سير العمل المدخلة والمخرجة
لتبادل المعلومات، قد يكون لسير العمل متغيرات الإدخال والإخراج. تُستخدم المدخلات لتلقي معلومات من المصادر الخارجية أو مسارات العمل الأخرى، بينما توفر المخرجات معلومات إلى المصادر الخارجية أو مسارات العمل الأخرى. وهذا يسمح بمزيد من المرونة في الاتصال وتبادل البيانات داخل الروبوت.
يمكن اتباع هذه الخطوات لوضع علامة على متغير الإدخال:
الخطوة 1. قم بإنشاء المتغير داخل سير العمل.
الخطوة 2. حدد المتغير بالنقر فوق عقدة إدخال سير العمل في لوحة Inspector.
يمكن اتباع هذه الخطوات لوضع علامة على متغير الإخراج:
الخطوة 1. قم بإنشاء المتغير داخل سير العمل.
الخطوة 2. حدد المتغير بالنقر فوق عقدة الخروج من سير العمل في لوحة Inspector.
متغيرات الجلسة
يمكن لجميع التدفقات الوصول إلى هذه المتغيرات، ولكن لمحادثة واحدة فقط. إنها مثالية لتخزين البيانات المستخدمة خلال المحادثة مثل سجل الدردشة أو العناصر المجمعة في عربة التسوق الافتراضية أو البيانات المؤقتة من مكالمات API.
لإنشاء متغير جلسة، يمكنك كتابة الكود التالي:
اسم الجلسة المتغير = 'مرحبا يا شباب!' ;لاستخدام المتغير الخاص بك في بطاقة نصية، نحتاج إلى إغلاقه بين قوسين متعرجين، على سبيل المثال، {{session.variablename}} .
متغيرات المستخدم
تتبع متغيرات المستخدم المستخدم بين المحادثات مما يسمح للبيانات بالاستمرار عبر تفاعلات متعددة مع chatbot. إنها مثالية لتخزين المعلومات التي تظل ذات صلة بالمستخدم بمرور الوقت مثل التفاصيل الشخصية أو العلامات من المحادثات السابقة أو تفضيلات اللغة.
لإنشاء متغير مستخدم:
الخطوة 1. افتح 'إعدادات Chatbot' من رمز Botpress الموجود في الزاوية العلوية اليسرى.
الخطوة 2. حدد 'المتغيرات' من علامات التبويب.
الخطوه 3. حدد متغير المستخدم من خلال تسميته وتحديد نوع البيانات.
يمكن استخدام @user.variablename أو {{user.variablename}} للإشارة إلى متغير 'المستخدم' في بطاقة نصية.
متغيرات البوت
يتمتع جميع المستخدمين في chatbot بإمكانية الوصول إلى هذه المتغيرات عبر جميع المحادثات. يتم استخدامها بشكل متكرر لتخزين معلومات المطور والتكوين مثل تخزين نقاط النهاية لاستدعاءات واجهة برمجة التطبيقات أو رقم إصدار الروبوت أو اسمه.
اتبع هذه الخطوات لإنشاء متغير Bot:
الخطوة 1. حدد 'إعدادات Chatbot' من خلال النقر على أيقونة Botpress في الزاوية العلوية اليسرى.
الخطوة 2. حدد 'المتغيرات' من علامات التبويب.
الخطوه 3. حدد اسم ونوع بيانات متغير الروبوت.
مثل متغيرات المستخدم، يمكن استخدام @bot.variablename أو bot.variablename للإشارة إلى متغيرات الروبوت في البطاقات.
متغيرات التكوين
إنها نوع خاص من متغيرات الروبوت الآمنة. يمكنك إدارتها من لوحة التحكم السحابية، وليس هناك حاجة لفتح الروبوت. تعد متغيرات التكوين مثالية لتخزين المعلومات الحساسة مثل الرموز المميزة لواجهة برمجة التطبيقات أو عناوين IP الخاصة أو بيانات اعتماد قاعدة البيانات.
لإنشاء متغير التكوين:
الخطوة 1. افتح 'إعدادات Chatbot' من رمز Botpress الموجود في الزاوية العلوية اليسرى.
الخطوة 2. انقر فوق علامة التبويب 'المتغيرات'.
الخطوه 3. أضف متغير التكوين وقم بتوفير اسمه وقيمته.
للوصول إلى متغيرات التكوين في الكود، يمكنك استخدام 'env.key' حيث يمثل 'key' اسم متغير التكوين المراد استرجاعه.
استخدام المتغيرات في الكود
الأقواس المتعرجة '{{ }}' أو الرمز @ ليست ضرورية عند استخدام المتغيرات في الكود. يتبع بناء جملة الوصول إلى المتغيرات في الكود نمط 'variabletype.variablename'. على سبيل المثال:
شفرة:
- سير العمل. رقم الهاتف
- session.userAcctId
- اسم المستخدم.الاسم الأول
- bot.endpoint
- env.apiKey
يمكن تعيين المتغيرات بقيم أو تحديثها في الكود. ولكن من المهم التأكد من أن القيمة المخصصة تطابق نوع بيانات المتغير لتجنب الأخطاء.
خاتمة
المتغيرات هي اللبنات الأساسية للتفاعلات الديناميكية والشخصية في Botpress. من خلال استخدام أنواع البيانات المختلفة وفهم النطاقات المتغيرة، يمكن للمطورين إنشاء روبوتات دردشة ذات إمكانات قوية. سواء كنت بحاجة إلى تخزين معلومات المستخدم، فإن الاتصال بواجهات برمجة التطبيقات أو تمرير البيانات بين سير العمل والمتغيرات في Botpress يوفر المرونة والتحكم اللازمين.