microsoftbotframework

مايكروسوفت بوت الإطار

Microsoft Bot Framework عبارة عن غلاف لـ Microsoft Bot API من Microsoft. ويستخدم Flask لتلقي رسائل النشر من Microsoft وCelery لإكمال مهام Async.

كان الهدف هو إنشاء مكتبة سهلة الاستخدام حقًا لتمكينك من التفاعل مع إطار عمل Microsoft bot.

يمكن العثور على المستندات الكاملة هنا: http://microsoftbotframework.readthedocs.io/

لتشغيل هذا التطبيق باستخدام جهاز المحاكاة المحلي

قم بتنزيل وتشغيل المحاكي من: https://docs.botframework.com/en-us/tools/bot-framework-emulator/

قم بتثبيت المكتبة

 pip install microsoftbotframework

تحديد مهمة

قم بإنشاء ملف في الدليل الجذر يسمى Tasks.py. في الملف تحديد مهمة على النحو التالي. يمكن العثور على مزيد من المعلومات حول كائن ResponseToActivity وغيره على http://microsoftbotframework.readthedocs.io/en/latest/conversationoperations/

 from microsoftbotframework import ReplyToActivity

def echo_response ( message ):
    if message [ "type" ] == "message" :
        ReplyToActivity ( fill = message ,
                        text = message [ "text" ]). send ()

قم بإنشاء الملف الرئيسي

 from microsoftbotframework import MsBot
from tasks import *

bot = MsBot ()
bot . add_process ( echo_response )

if __name__ == '__main__' :
    bot . run ()

قم بتشغيل التطبيق الخاص بك

 python main.py

الاتصال بالبوت الخاص بك

افتراضيًا، يعمل التطبيق على http://localhost:5000/api/messages.

أدخل هذا العنوان في أدخل رأس URL لنقطة النهاية الخاصة بالمحاكي.

ابدأ الدردشة! إذا اتبعت التعليمات المذكورة أعلاه، فيجب عليك تكرار ما كتبته.

لتشغيل هذا التطبيق باستخدام إطار عمل الروبوت عبر الإنترنت

للتفاعل مع إطار عمل Microsoft bot، يجب أن يكون لديك نقطة نهاية https مواجهة للإنترنت مع شهادة صالحة. سيوضح هذا الدليل كيفية استخدام gunicorn وheroku لاستضافة التطبيق ولكن يمكنك بسهولة استخدام أي خيار استضافة wsgi حيث يقوم كائن MsBot بتوسيع Flask.

قم بإنشاء برنامج Chatbot من Microsoft

انتقل إلى https://dev.botframework.com/bots. سجل روبوتًا وقم بإنشاء "معرف تطبيق Microsoft" و"سر تطبيق Microsoft". لا تقلق بشأن نقطة نهاية المراسلة حيث سنقوم بإنشائها قريبًا. قم بإنشاء ملف config.yaml في جذر مشروعك وقم بوضع المعلومات التالية:

 other :
    app_client_id : 
    app_client_secret :  

النشر إلى هيروكو

قم بإنشاء ملف يسمى require.txt وأضف ما يلي.

 microsoftbotframework
gunicorn

أنشئ ملفًا باسم "Procfile" وأضف ما يلي. سوف نستخدم gunicorn كخادم الويب الخاص بنا. يمكنك إزالة "--log-level INFO" أو تعيينها على مستوى أقل للإنتاج.

 web: gunicorn -b '0.0.0.0:'$PORT --log-level INFO main:bot

قم بإنشاء ملف يسمى runtime.txt وأضف ما يلي.

 python-3.6.0

إذا لم تقم بتثبيت git بعد

sudo apt-get install git

قم بالتسجيل للحصول على حساب Heroku هنا: https://www.heroku.com/ وقم بإنشاء تطبيق جديد. اتبع التعليمات للنشر باستخدام Heroku Git

ارجع إلى علامة التبويب Microsoft MyBots وقم بتحديث نقطة نهاية المراسلة لتكون المجال الموجود في علامة تبويب إعدادات Heroku. تأكد من إضافة "/api/messages" في عنوان URL.

تهانينا، يجب أن تكون الآن قادرًا على الدردشة مع الروبوت الخاص بك على Skype!

تشغيل اختبارات هذه المكتبة

1. تأكد من تثبيت المكتبات المطلوبة من قسم setup.py tests_require مع pip install -e .[test]
2. تأكد من تثبيت redis وmongodb محليًا
3. قم بتشغيل redis: redis-server
4. قم بتشغيل mongobd: mongod
5. افتح محطة في جذر هذا الدليل
6. قم بإجراء الاختبارات باستخدام أحد الخيارات أدناه
   • nosetests (يتطلب تثبيت مكتبات الخطوة 1)
   • python setup.py test (لا يتطلب تثبيت مكتبات الخطوة الأولى)