README-fa.md

دستیار هوشمند فروشگاه (Ai-Shop-Assistant)

English | فارسی

دستیار هوشمند فروشگاه یک ربات تلگرام مبتنی بر هوش مصنوعی است که با استفاده از Telethon و الگوریتم RAG (Retrieval-Augmented Generation) برای پشتیبانی خودکار از مشتریان فروشگاه‌های آنلاین طراحی شده است.

ویژگی‌ها

• پاسخگویی خودکار به پیام‌های کاربران در تلگرام
• استفاده از الگوریتم RAG برای تولید پاسخ‌های مرتبط و دقیق
• پردازش و استفاده از تاریخچه چت‌های قبلی برای بهبود کیفیت پاسخ‌ها
• پشتیبانی از زبان فارسی با استفاده از مدل‌های زبانی مناسب
• قابلیت استفاده از پاسخ‌های پیش‌فرض برای سوالات متداول

پیش‌نیازها

• Python 3.8+
• pip (مدیر بسته Python)
• یک اکانت تلگرام و دسترسی به API تلگرام

نصب و راه‌اندازی

1. کلون کردن مخزن:

   git clone https://github.com/ItsOrv/Ai-Shop-Assistant.git
   cd Ai-Shop-Assistant
   

2. نصب وابستگی‌ها:

   pip install -r requirements.txt
   

3. تنظیم فایل config.py:

   • API_ID و API_HASH خود را از my.telegram.org دریافت کنید.
   • شماره تلفن مرتبط با اکانت تلگرام خود را در PHONE_NUMBER وارد کنید.
   • در صورت نیاز، سایر تنظیمات را متناسب با نیاز خود تغییر دهید.

4. آماده‌سازی داده‌ها:

   • فایل raw_chat_export.json حاوی تاریخچه چت‌ها را در پوشه اصلی پروژه قرار دهید.
   • اجرای اسکریپت پردازش داده:

     python data_processor.py
     

5. اجرای ربات:

   python main.py
   

نحوه مشارکت

مشارکت‌های شما در این پروژه بسیار ارزشمند است. لطفاً برای مشارکت، مراحل زیر را دنبال کنید:

1. این مخزن را fork کنید.
2. یک شاخه جدید برای ویژگی یا رفع باگ خود ایجاد کنید.
3. تغییرات خود را اعمال کنید.
4. یک Pull Request ایجاد کنید.

مجوز

این پروژه تحت مجوز MIT منتشر شده است. برای جزئیات بیشتر، فایل LICENSE را مطالعه کنید.

تماس با ما

در صورت داشتن هرگونه سوال یا پیشنهاد، لطفاً از طریق Issues با ما در ارتباط باشید.