تطوير إجراءات الروبوت المخصصة في Botpress

Ttwyr Ajra At Alrwbwt Almkhsst Fy Botpress



أصبحت Chatbots جزءًا أساسيًا من الشركات الحديثة التي تمكنها من تقديم دعم أفضل للعملاء، وأتمتة العمليات، والتفاعل مع المستخدمين بشكل أكثر فعالية. Botpress هو إطار عمل chatbot شائع ومفتوح المصدر يقدم العديد من الإجراءات المضمنة. ومع ذلك، في بعض الحالات، قد تحتاج إلى إنشاء إجراءات روبوت مخصصة لتلبية متطلبات محددة وتوسيع قدرات الروبوت. في هذا البرنامج التعليمي، سنرشدك خلال إنشاء إجراءات روبوت مخصصة في Botpress من خلال التركيز على استدعاء واجهة برمجة التطبيقات (API) واستخدام الاستجابة في عنصر المحتوى.

فهم الإجراءات في Botpress

الإجراءات في Botpress هي وظائف من جانب الخادم يتم تنفيذها بواسطة الروبوت أثناء تدفقات المحادثة. لديهم القدرة على تغيير حالة المحادثة، وإرسال رسائل مخصصة، وتنفيذ تعليمات برمجية عشوائية (مثل استدعاء واجهات برمجة التطبيقات أو تخزين البيانات)، والمزيد. في الأساس، الإجراءات هي وظائف JavaScript عادية مما يعني أنها يمكنها تنفيذ أي شيء تقريبًا ضمن حدود النظام الأساسي.

عندما يتم استدعاء إجراء ما بواسطة مدير الحوار (DM)، فإنه يتلقى العديد من الوسائط التي توفر سياقًا للوظيفة. تتضمن هذه الوسائط سمات المستخدم، ومتغيرات الجلسة، والمتغيرات المؤقتة، ومتغيرات مستوى الروبوت، وآخر حدث مستخدم في المحادثة، والوسائط التي تم تمريرها من Visual Flow Builder، وجهاز افتراضي معزول يحتوي على بعض متغيرات البيئة.







تسجيل الإجراءات الجديدة

لإضافة إجراءات الروبوت المخصصة، تحتاج إلى إنشاء ملف JavaScript (.js) ووضعه في ملف البيانات/العالمية/الإجراءات مجلد داخل مشروع Botpress الخاص بك. لسوء الحظ، لا توجد طريقة لإضافة إجراءات جديدة برمجياً أثناء وقت التشغيل. باستخدام تعليقات JavaDoc في التعليمات البرمجية الخاصة بك، يمكنك توفير معلومات مفيدة حول الإجراءات مثل الاسم والوصف والوسائط والقيم الافتراضية. يمكنك أيضًا إخفاء إجراء ما في محرر التدفق عن طريق إضافة علامة @hidden true في تعليق JavaDoc.



كيفية إنشاء إجراءات مخصصة في Botpress

فيما يلي بعض الخطوات التي يمكنك اتباعها لإنشاء إجراء مخصص في Botpress:



الخطوة 1: إنشاء الروبوت الخاص بك وإضافة عقدة

للبدء، قم بإنشاء روبوت جديد في Botpress. بمجرد إنشاء الروبوت الخاص بك، قم بإضافة عقدة جديدة إلى تدفق المحادثة.





الخطوة 2: إضافة الرسائل المناسبة إلى العقدة الخاصة بك

في العقدة المنشأة حديثًا، أضف الرسائل اللازمة لتسهيل تبادل المحتوى مع المستخدمين. على سبيل المثال، يمكنك إضافة رسالة نصية لتحية المستخدم والسؤال عن اسمه.



الخطوة 3: افتح رمز التنفيذ من الشريط الجانبي

انتقل إلى الشريط الجانبي في Botpress Flow Builder وافتح 'محرر التعليمات البرمجية'. هذا هو المكان الذي يمكنك فيه إنشاء إجراءاتك المخصصة وإدارتها.

  C:\Users\user01\Desktop\4124.PNG

الخطوة 4: انقر على زر 'إضافة إجراء'.

في قسم 'تنفيذ التعليمات البرمجية'، انقر فوق الزر 'إضافة إجراء'. يفتح هذا الإجراء نافذة 'إنشاء إجراء جديد قديم'.

  C:\Users\user01\Desktop\tempsnip.png

الخطوة 5: حدد اسمًا للملف وانقر على زر إرسال

في نافذة 'إنشاء إجراء_ليغاسي جديد'، قم بإعطاء اسم ذي معنى لملف الإجراء المخصص الخاص بك؛ على سبيل المثال، customAction.js. بمجرد تحديد الاسم، انقر فوق الزر 'إرسال'. يؤدي هذا إلى إنشاء ملف 'customAction.js'.

الخطوة 6: اكتب الرمز المخصص الخاص بك

افتح ملف 'customAction.js' الذي تم إنشاؤه حديثًا. داخل الملف، سترى الكود المعياري الذي تم إنشاؤه لإجراء جديد. قم بتوفير وصف ذي معنى للإجراء المخصص الخاص بك باستخدام التعليقات المناسبة.

الآن، اكتب التعليمات البرمجية المخصصة الخاصة بك داخل الوظيفة. يحدد هذا الرمز سلوك الإجراء المخصص الخاص بك. يمكنك استخدام JavaScript لتنفيذ مهام متنوعة مثل إجراء مكالمات API أو الوصول إلى قواعد البيانات أو التعامل مع المنطق المعقد.

الخطوة 7: تعديل العقدة الخاصة بك لاستخدام الإجراء المخصص

ارجع إلى Botpress Flow Builder وقم بتعديل العقدة التي تريد تشغيل الإجراء المخصص فيها. أضف بطاقة 'تنفيذ التعليمات البرمجية' إلى العقدة.

الخطوة 8: حدد اسم الإجراء المخصص الخاص بك وحدد معلمات الإجراء

في بطاقة 'تنفيذ التعليمات البرمجية'، سترى قائمة منسدلة تحتوي على أسماء جميع إجراءاتك المخصصة. حدد اسم الإجراء المخصص الخاص بك من القائمة. إذا كان الإجراء المخصص الخاص بك يتطلب أي معلمات، فيمكنك تحديدها في قسم 'المعلمات' في بطاقة 'تنفيذ التعليمات البرمجية'.

  C:\Users\user01\Desktop\tempsnip121.png

الخطوة 9: اجعل الروبوت الخاص بك ينفذ الإجراء

أخيرًا، أضف بطاقة أخرى إلى العقدة لتجعل الروبوت الخاص بك يقوم بالإجراء المخصص. يمكنك استخدام المتغيرات المحفوظة في الحدث (المحددة في بطاقة 'تنفيذ التعليمات البرمجية') للوصول إلى نتائج الإجراء المخصص الخاص بك وإدراجها في استجابة الروبوت.

مثال على الإجراء المخصص

لنفترض أنك تريد أن يقوم برنامج الدردشة الآلي الخاص بك بتوفير معلومات الطقس الحالية لموقع محدد. يمكنك إنشاء إجراء مخصص يستدعي واجهة برمجة تطبيقات الطقس ويعيد بيانات الطقس.

محاور ثابتة = يتطلب ( 'أكسيوس' );

const getWeather = غير متزامن ( مستخدم ، الجلسة، الحجج) => {

موقع ثابت = args.location || 'نيويورك' ;

const apiKey = 'your_weather_api_key' ;

const apiUrl = `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${location}`;

يحاول {

استجابة ثابتة = انتظار axios.get(apiUrl);

const WeatherData = Response.data;

return `الطقس الحالي في ${location} هو ${weatherData.current.condition.text} مع درجة حرارة ${weatherData.current.temp_c}°C.`;

} التقاط (خطأ) {

يعود 'آسف، لم أستطع.' \' لجلب معلومات الطقس في الوقت الراهن. الرجاء معاودة المحاولة في وقت لاحق.' ;

}

};

إرجاع getWeather( مستخدم ، الجلسة، الحجج)؛

يأخذ هذا الإجراء وسيطات معينة بما في ذلك المستخدم والجلسة والوسائط التي توفر السياق والبيانات للإجراء للعمل معه. في هذا المثال، يأخذ الإجراء المخصص 'getWeather' الموقع كوسيطة أو يتم تعيينه افتراضيًا على 'نيويورك' إذا لم يتم توفيره. يستدعي الإجراء واجهة برمجة تطبيقات الطقس باستخدام Axios، ويجلب بيانات الطقس ويعيد رسالة تحتوي على حالة الطقس ودرجة الحرارة.

مزايا الإجراءات المخصصة

توفر الإجراءات المخصصة في Botpress العديد من المزايا التي تعمل على تحسين قدرات ووظائف برنامج الدردشة الآلي الخاص بك:

  1. إنها تعمل على توسيع وظيفة chatbot إلى ما هو أبعد من القدرات المضمنة.
  2. إنهم ينشئون تفاعلات مخصصة لتجربة مستخدم أفضل.
  3. يقومون بجلب البيانات في الوقت الفعلي من واجهات برمجة التطبيقات للاستجابات الديناميكية.
  4. أنها تتكامل مع الأنظمة الخلفية وقواعد البيانات.
  5. إنهم يتعاملون مع السيناريوهات المعقدة باستخدام تعليمات برمجية مخصصة.
  6. إنهم يعيدون استخدام الإجراءات عبر روبوتات الدردشة والتدفقات.
  7. يقومون بتنفيذ معالجة الأخطاء المخصصة وتسجيلها.
  8. يقومون بتحسين المهام كثيفة الاستخدام للموارد.
  9. إنهم يستفيدون من الخدمات الخارجية للتوسع.
  10. يمكنهم الوصول إلى الإجراءات المخصصة المعدة مسبقًا ومشاركتها.

خاتمة

تعمل الإجراءات المخصصة في Botpress على توسيع إمكانيات chatbot وتخصيص التفاعلات ودمج واجهات برمجة التطبيقات الخارجية. يقوم المطورون بإنشاء وظائف JavaScript من جانب الخادم واستدعاءها من Botpress Flow Builder. توفر هذه الإجراءات إمكانية إعادة استخدام التعليمات البرمجية والأداء المحسن وقابلية التوسع مما يجعل أدوات الدردشة أكثر تنوعًا وقوة. تؤدي الاستفادة من الإجراءات المخصصة في Botpress إلى إنشاء تجارب chatbot مبتكرة وجذابة.