dialog chat bot

Openai Telegram chatbot

هذا هو chatbot Telegram المستندة إلى Python يستخدم API Openai مع نماذج GPT-3.5-Turbo-* لتوفير استجابات محادثة للمستخدمين بطريقة واعية سياق الحوار.

يمكنك بسهولة تكوين معلمات نماذج Openai لـ chatbot باستخدام ملف models.yml . يسمح هذا النهج بإجراء تعديلات سريعة لإعدادات النموذج مثل temperature و max_tokens voice وما إلى ذلك دون تغيير الكود. ما عليك سوى تحرير ملف models.yml .

سمات

• يوفر استجابات المحادثة لإدخال المستخدم ، باستخدام Openai API.
• القدرة على تكوين نماذج متعددة بسهولة والاختيار بينها.
• يدعم المدخلات الصوتية (معالجة الكلام إلى رسالة نصية باستخدام نموذج Openai Whisper).
• يدعم الإخراج الصوتي (معالجة النص إلى الكلام باستخدام نموذج Openai TTS).
• يمكن التعامل مع محادثات متعددة مع مستخدمين مختلفين في وقت واحد.

متطلبات

• بيثون 3.11+
• FFMPEG
• حساب Openai ورصيد الحساب الإيجابي. مستخدمون جدد يحصلون على 5 دولارات.

؟ بداية سريعة

1. قم بتثبيت الروبوت : اختر بين التثبيت المحلي أو استخدام Docker. راجع قسم التثبيت للحصول على خطوات مفصلة.
2. تفاعل مع روبوتك : بمجرد تشغيل الروبوت ، افتح برقية وابدأ في إرسال الرسائل إلى روبوتك.

تثبيت

محلي

• استنساخ أو تنزيل المستودع.

   git clone [email protected]:welel/dialog-chat-bot.git
  

• الخروج على فرع GPT-3.5 توربو .

   git checkout gpt-3.5-turbo
  

• إنشاء بيئة افتراضية وتفعيلها وتثبيت التبعيات.

   python -m venv env
  source env/bin/activate
  pip install --upgrade pip && pip install -r requirements.txt
  

• لاستخدام الرسائل الصوتية ، يرجى تثبيت FFMPEG.

   # on Ubuntu or Debian
   sudo apt update && sudo apt install ffmpeg
   
   # on Arch Linux
   sudo pacman -S ffmpeg
   
   # on MacOS using Homebrew (https://brew.sh/)
   brew install ffmpeg
   
   # on Windows using Chocolatey (https://chocolatey.org/)
   choco install ffmpeg
   
   # on Windows using Scoop (https://scoop.sh/)
   scoop install ffmpeg
  

• نسخ/إعادة تسمية .env.dist إلى .env وملءها بالبيانات.

   cp .env.dist .env
  

  • قم بإعداد روبوت برقية والحصول على رمز روبوت (انظر https://medium.com/geekculture/generate-telegram-token-for-bot-api-d26faf9bf064 للحصول على التعليمات).

  • قم بإعداد حساب Openai والحصول على مفتاح API (انظر https://beta.openai.com/docs/quickstart للحصول على التعليمات).

• تشغيل الروبوت.

   python bot.py
  

عامل ميناء

• قم بتثبيت Docker و Docker Compose (رابط إذا كنت لا تعرف كيف).

• نسخ/إعادة تسمية .env.dist إلى .env وملءها بالبيانات.

   cp .env.dist .env
  

• الآن ببساطة قم ببناء الصورة وقم بتشغيلها باستخدام Docker:

 docker compose build
docker compose up -d

الاستخدام والتكوين

لبدء التفاعل مع الروبوت ، أرسل أي رسالة إلى روبوت Telegram.

يستخدم chatbot التكوينات المحددة في ملف models.yml لتكييف استجاباته. يسمح هذا الملف بتخصيص مفصل لمعلمات نموذج Openai ، مما يوفر المرونة لضبط سلوك الروبوت وفقًا للاحتياجات أو السياقات المختلفة.

تكوين النماذج مع models.yml

يحتوي ملف models.yml في دليل المشروع على تكوينات لنماذج أو سيناريوهات مختلفة. إليك كيفية تكوينه:

1. تحديد نموذج : ضمن مفتاح models ، يمكنك تحديد تكوينات متعددة.

   يمكن لكل تكوين تحديد نموذج Openai مختلف. على سبيل المثال ، يستخدم التكوين default gpt-3.5-turbo مع حد max_tokens 100. تحتاج إلى تعيين اسم تكوين النموذج في البيئة متغير MODEL_CONFIG_NAME لتحديد التكوين.

2. تكوين نموذج دردشة Openai (قسم chat_model ) :

   • معرف النموذج : اختر معرف الطراز المناسب لحالة الاستخدام الخاصة بك. تتضمن الخيارات المتاحة إصدارات مختلفة من نموذج gpt-3.5-turbo ، ولكل منها قدرات مختلفة وأحجام نوافذ السياق.
   • Max Tokens : هذا الإعداد المطلوب يتحكم في طول الإخراج عن طريق الحد من الحد الأقصى لعدد الرموز التي ينشئها النموذج.
   • عقوبة التردد : اضبط كيفية إنشاء الرموز الجديدة بناءً على ترددها حتى الآن. القيم الإيجابية تقلل من التكرار.
   • عقوبة التواجد : تؤثر على توليد الرموز الجديدة بناءً على وجودها في المحادثة ، مما يعزز التنوع في الموضوعات.
   • درجة الحرارة : التحكم في العشوائية من الاستجابات. تؤدي القيم المنخفضة إلى نص أكثر قابلية للتنبؤ ، في حين أن القيم الأعلى تزيد من التنوع.
   • أعلى P : بديل لدرجة الحرارة ، مع التركيز على النموذج على الرموز الأكثر احتمالا أو مجموعة أوسع ، اعتمادا على القيمة.
   • توقف : تحديد تسلسلات محددة تشير إلى النموذج للتوقف عن توليد الرموز المميزة ، مفيدة لإدارة تدفق المحادثة.

3. تكوين سلوك chatbot (قسم chatbot ) :

   • الوصف : اضبط سياقًا أو دورًا لـ chatbot في بداية المحادثة ، وتوجيه ردودها وأسلوبها.
   • الطول : تحدد معلمة max_context_len العدد الإجمالي للموارد (مدخلات المستخدم واستجابات الروبوت) في نافذة محادثة واحدة. يساعد ضبط هذا على إدارة تفاصيل تاريخ المحادثة ويمكن أن يؤثر على المتطلبات الحسابية والفواتير.

4. تكوين صوت BOT (قسم voice ) :

   • النموذج : اختر بين نماذج النص إلى الكلام المتاحة (TTS) لتحديد جودة وخصائص الإخراج الصوتي. تشمل الخيارات TTS-1 للجودة القياسية و TTS-1-HD للصوت عالي الوضوح. يحدد هذا الإعداد التكنولوجيا الأساسية لتوليف الصوت.
   • الصوت : حدد الهوية الصوتية المحددة لاستخدامها من الخيارات المدعومة: alloy ، echo ، fable ، onyx ، nova ، و shimmer . كل صوت له نغمة وأسلوب فريد.
   • السرعة : اضبط سرعة التشغيل للصوت الذي تم إنشاؤه ، مع نطاق من 0.25 (أبطأ) إلى 4.0 (أسرع). الإعداد الافتراضي هو 1 ، يمثل السرعة العادية.

؟ استكشاف الأخطاء وإصلاحها

• مشكلات الرسائل الصوتية : إذا فشل الروبوت في معالجة الرسائل الصوتية ، تأكد من تثبيت FFMPEG على جهاز المضيف. تحقق من سجلات الروبوت لأي رسائل خطأ تتعلق بمعالجة الصوت.
• قيود الوصول : قد يواجه المستخدمون في مناطق معينة ، مثل روسيا ، كتل عند محاولة الوصول إلى خدمات Openai ، مما يؤدي إلى إرجاع BOT إلى صفحة خطأ HTML. للتحايل على هذا ، قم بتكوين VPN على جهاز الاستضافة الخاص بك أو التفكير في استضافة الروبوت في موقع جغرافي مختلف حيث تتوفر Openai Services.