Birlashtirilgan majmua qo‘llanmasi

Smart Support Bot va Smart Support Manager O‘quv maqolasi

Ikkala dastur yagona zanjir sifatida ishlaydi: Smart Support Manager Windows'da kontent va deploymentni boshqaradi, Smart Support Bot Telegram'da xizmat ko‘rsatadi.

Hamkorlik arxitekturasi

  • Smart Support Manager (Windows): http://127.0.0.1:8766 da ishlab hujjatlarni tahlil qiladi, katalog va rasm ulanishlarini tayyorlaydi.
  • Smart Support Bot (Linux VPS): /opt/smart-support da ishlab /opt/smart-support/products/<id>/ ma'lumotlaridan foydalanadi.
  • Avtomatik uyg‘unlik: qo‘lda JSON tahrirlash talab qilinmaydi.

Tavsiya etilgan tartib

  • 1. Ulanish: Start-Smart-Support-Manager.bat ni ochib Settings da SSH va AI kiriting.
  • 2. Kontent: Products → Catalog → Upload Queue / Media / Catalog photos.
  • 3. Ishga tushirish: Install bot orqali o‘rnating va Telegram'da /start hamda Ask AI ni tekshiring.

1. Dashboard va jonli holat indikatorlari

Start-Smart-Support-Manager.bat dan so‘ng http://127.0.0.1:8766 ochiladi:

  • Yuqori holat belgilari: Server (SSH), Expert + AI va Expert + bot + AI.
  • 4 til tanlovi: o‘ng yuqorida فارسی, English, Русский va 中文.
  • Tezkor statistika: faol mahsulotlar va yuklash navbati.
Maslahat: Avval mahalliy qoralama tayyorlab, Server yashil bo‘lganda nashr qiling.
1-rasm: Manager Dashboard
1-rasm: Manager Dashboard

2. Mahsulotlar va manbalarni qo‘shish (Products)

Products sahifasida bot xizmat ko‘rsatadigan mahsulotlarni yarating:

  • ID va nom: noyob Product ID va ko‘rsatiladigan nom.
  • Manba formatlari: TXT, MD, JSON, CSV, HTML, PDF, DOCX, Go, Python.
  • Server yo‘li: har bir mahsulot uchun /opt/smart-support/products/<id>.
  • On / Off kaliti: Telegram menyusida vaqtincha yoqish/o‘chirish.
2-rasm: Products sahifasi
2-rasm: Products sahifasi

3. AI katalog yaratish, tahrirlash va nashr qilish (Catalog)

Catalog bo‘limida AI manbalardan qo‘llanma tayyorlaydi:

  • Avto-yaratish: sarlavha, qisqa/to‘liq ta'rif va funksiyalar ro‘yxati.
  • Qo‘lda tahrirlash: matn va funksiyalarni aniq moslashtiring.
  • Nashr qilish: Use catalog in bot bilan yoqing yoki Stop using catalog bilan to‘xtating.
Izolyatsiya: Ask AI faqat tanlangan mahsulot katalogidan javob beradi.
3-rasm: Catalog bo‘limi
3-rasm: Catalog bo‘limi

4. Yuklash navbati, Media va Catalog photos

Uch bo‘lim orqali skrinshotlar funksiyalarga bog‘lanadi:

  • Upload Queue: rasmlarni tanlab Process waiting orqali SSH orqali tartib bilan yuklang.
  • Media: skanerlangan rasmlarni AI yordamida funksiyalarga bog‘lang.
  • Catalog photos: kattalashtirib ko‘ring (Esc yopadi), Media'ga qaytaring yoki o‘chiring.
Qoida: faqat Catalog photos ga ulangan rasmlar Telegram'da yuboriladi.
4a-rasm: Upload Queue
4a-rasm: Upload Queue
4b-rasm: Media
4b-rasm: Media
4c-rasm: Catalog photos
4c-rasm: Catalog photos

5. Bir klikli o‘rnatish va Settings

Server xizmatlarini qo‘lda skript yozmasdan o‘rnating:

  • Install bot: SSH ma'lumotlari, mahalliy Smart Support Bot papkasi va @BotFather tokeni.
  • Polling yoki Webhook: domensiz Polling yoki HTTPS proksi ortida Webhook (8080).
  • 3 qadamli deploy: Install bot → Install Expert → Activate bot and Expert.
  • Settings va Stop all: SSH, Bot AI, Expert ulanishi va favqulodda Stop all.
Xavfsizlik: parollar mahalliy shifrlanadi, tokenlar server .env faylida saqlanadi.
5a-rasm: Install bot
5a-rasm: Install bot
5b-rasm: Settings
5b-rasm: Settings

6. Telegram bot, History jurnali va Contact

Faollashtirilgach foydalanuvchilar Telegram'da ishlaydi:

  • Foydalanuvchi oqimi: /start, /lang (4 til), rasmli bo‘limlar, mahsulot ichidagi Ask AI, /menu va /help.
  • Admin buyruqlari: /agents, /active_agent, /failover, /safety_status, /catalog_scan.
  • History: barcha tahrir va nashrlar vaqti va ok / FAILED holati bilan yoziladi.
  • Contact: rasmiy GitHub va PowerShell o‘rnatish buyrug‘i.
Tez yangilash: serverdagi o‘zgarishlardan so‘ng /catalog_scan bosing.
6a-rasm: History
6a-rasm: History
6b-rasm: Contact
6b-rasm: Contact

7. Tez-tez so‘raladigan savollar (FAQ)

Savol / MuammoEhtimoliy sababYechim
Katalog o‘zgarishi Telegram'da chiqmayaptiFaqat mahalliy saqlangan yoki mahsulot Off holatida.Products da On qiling va Catalog da Use catalog in bot bosing.
Bot rasm yubormayaptiRasmlar funksiyalarga bog‘lanmagan.Upload Queue dan yuklab Media / Catalog photos da ulang.
Webhook ishlamayaptiHTTPS proksi 8080 portga yo‘naltirmayapti.Install bot da Polling — no webhook tanlang yoki proksini tekshiring.
Server indikatori qizilSSH host, port, login yoki parol/kalit xato.Settings da tuzatib Save va Connect bosing.
AI javob bermayaptiEndpoint, model yoki API kaliti noto‘g‘ri.Settings → Bot AI da tekshirib Connect to AI bosing.
Bir nechta mahsulot qo‘shsa bo‘ladimi?Ha, har bir Product ID alohida izolyatsiyalangan.Products da har bir dastur uchun yangi ID oching.