Hermes Agent’ni Telegram’ga qanday ulash va vazifalarni telefondan boshqarish

Kompyuteringizdan uzoqda bo‘lganingizda Hermes Agent’ga Telegram orqali telefoningizdan xabar yozishingiz yoki vazifalarni aytib berishingiz, natijani esa o‘sha chatning o‘zida olishingiz mumkin. Rejalashtirilgan vazifalar natijalari bir marta asosiy chat sifatida belgilagan chatga keladi.

Agar Hermes hali o‘rnatilmagan bo‘lsa, avval bu agent nima ekani va uni qanday o‘rnatish haqidagi qo‘llanma bilan tanishing, keyin Telegram’ni ulash uchun shu yerga qayting.

Qo‘shimcha ko‘rsatmalarni Ailoot hujjatlaridan topishingiz mumkin.

Hermes Agent’ni Telegram’ga ulash uchun nima kerak?#

hermes doctor buyrug‘i Hermes o‘rnatilishi va model bilan ulanishni tekshiradi. Botni Telegram ilovasida yaratamiz, buyruqlarni terminalda bajarish uchun esa kompyuter kerak bo‘ladi.

BotFather orqali botni qanday yaratasiz?#

Har bir Telegram botida token — botni boshqarish uchun maxfiy kalit bo‘ladi. Uni Telegram’ning rasmiy boti @BotFather beradi.

1. @BotFather’ni oching

   Telegram’da @BotFather deb qidiring yoki t.me/BotFather sahifasini oching. Haqiqiy BotFather’da ko‘k tasdiqlash belgisi bo‘ladi. “Start” tugmasini bosib suhbatni boshlang.

2. /newbot buyrug‘ini yuboring

   BotFather sizdan ikkita nom so‘raydi. Birinchisi — ko‘rinadigan nom; u istalgancha bo‘lishi mumkin, masalan, “My Agent.” Ikkinchisi — foydalanuvchi nomi: u noyob bo‘lishi va bot bilan tugashi kerak, masalan, moy_agent_bot.

3. Tokenni oling

   BotFather tabrik xabarini va 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ shaklidagi uzun satrni yuboradi. Bu bot tokeni. Butun satrni nusxalang.

BotFather bilan qo‘lda suhbatlashishni talab qilmaydigan tezkor usul ham bor. Hermes veb boshqaruv panelida (hermes dashboard) va desktop ilovasidagi “Messaging → Telegram” sahifasida “Create with QR” tugmasi mavjud: kodni telefoningiz bilan skanerlang, shunda Hermes bot yaratadi, ID raqamingizni aniqlaydi, tokenni sozlamalarda saqlaydi va gateway’ni qayta ishga tushiradi. Quyidagi bosqichlar qo‘lda bajariladigan usulni ko‘rsatadi; QR usulini tanlagan bo‘lsangiz, bevosita ulanishni tekshirishga o‘ting.

Telegram ID raqamingizni qanday topasiz va u nima uchun kerak?#

Telegram hisobida ikkita identifikator bor: @ belgili ochiq foydalanuvchi nomi va ichki raqamli ID. Hermes raqamdan foydalanadi.

Tezkor “QR orqali yaratish” usuli ID’ingizni avtomatik aniqlaydi. Uni tokeningiz yoniga yozib qo‘ying.

Tokenni Hermes Agent’ga qanday berasiz va gateway’ni ishga tushirasiz?#

1. Sozlash ustasini ishga tushiring

   hermes gateway setup
   

   Buyruqni Hermes o‘rnatilgan mashinada bajaring. Usta xabar almashish ilovalari ro‘yxatini taklif qiladi.

2. Telegram’ni tanlab, ma’lumotlaringizni kiriting

   Usta bot tokeni va ruxsat berilgan ID raqamlarini so‘raydi (vergul bilan ajratib, bir nechtasini kiritishingiz mumkin) va hammasini sozlamalarning o‘zida saqlaydi.

3. Gateway’ni ishga tushiring

   hermes gateway
   

   Gateway ishga tushib, Telegram’ga ulanadi. Bir necha soniyadan so‘ng ilovada botingizga istalgan xabarni yuboring: Hermes javob bersa, ulanish tayyor.

Ustadan foydalanmay, qo‘lda sozlash quyidagicha: ~/.hermes/.env faylini oching va BotFather’dan olgan token hamda raqamli Telegram ID’ingizni qo‘yib, ikkita qator qo‘shing:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Ikkinchi qator shu odamlarga shaxsiy chat va guruhlarda ruxsat beradi; alohida guruh avtorizatsiyasi ham kirish ochishi mumkin. Bir nechta odam bo‘lsa, vergul bilan ajrating. Faylni saqlagach, o‘sha hermes gateway buyrug‘i bilan gateway’ni ishga tushiring.

Agar bot shaxsiy chatda ham jim tursa, o‘sha terminaldagi gateway jurnallarini tekshiring va avvalo token hamda ruxsatlar ro‘yxatidagi ID raqamingiz to‘g‘riligini tasdiqlang; boshqa xatolar maqolaning oxiridagi jadvalda keltirilgan.

Telegram boti telefoningizda nimalar qila oladi?#

Telefoningizda eng ko‘p kerak bo‘ladigan beshta imkoniyat bor.

Matnli va ovozli xabarlar. Vazifani yozib yuboring yoki ovozli xabar qilib ayting — nutqni tanish sozlangan bo‘lsa, Hermes uni matnga aylantirib, tushunadi. Mahalliy provayderdan foydalansangiz, kalitlar kerak emas; hammasi agent ishlayotgan mashinada qayta ishlanadi.

Fayllar va rasmlar. Botga hujjat, elektron jadval yoki ekran tasvirini yo‘naltirishingiz mumkin — agent uni biriktirma sifatida oladi. U yaratgan fayllarni ham qaytarib yuborishi mumkin: hisobot so‘rang, u uni chatda fayl qilib yuboradi.

Xavfli amallar uchun tasdiqlash. Agent fayllarni o‘chirish kabi xavfli ishni bajarmoqchi bo‘lsa, avval chatda so‘raydi: “yes” yoki “y” deb javob bersangiz, bajaradi; “no” yoki “n” desangiz, bekor qiladi.

Qayta yozish o‘rniga tugmalar. Agentga aniqlik kiritish kerak bo‘lsa, u ichki variant tugmalari bo‘lgan savol yuboradi — variantni bosing, agent ishini davom ettiradi. Parametrsiz /model buyrug‘i xuddi shunday tugmalari bo‘lgan model tanlash menyusini ko‘rsatadi.

Ovozsiz bildirishnomalar. Odatiy sozlamada telefoningiz faqat yakuniy javoblar, tasdiqlash so‘rovlari va buyruq tasdiqlari uchun jiringlaydi. “Asbob chaqirilmoqda” va “kontekst siqilmoqda” kabi xizmat bildirishnomalari ovozsiz keladi, shuning uchun telefon har qadamda jiringlamaydi. Har qadamda ovozli bildirishnoma olishni istasangiz, sozlamalardagi rejimni o‘zgartiring.

Fon vazifalari natijalarini chatda qanday olasiz?#

Rejalashtirilgan vazifalar uchun asosiy chat. Hermes rejalashtirilgan vazifalarni qo‘llab-quvvatlaydi: “har kuni ertalab 7:43 da menga qisqacha xulosa tayyorla.” Natijalarni bot bilan suhbatda bevosita /sethome buyrug‘ini yuborib bir marta belgilaydigan asosiy chatga jo‘natadi. Gateway ishlab turganida xulosalar avtomatik keladi.

Fon vazifalari. Uzoq davom etadigan vazifani fonda bajarish uchun yuborib, kuningizni davom ettirishingiz mumkin: tayyor bo‘lganda bot sizga xabar beradi. Mavzudan boshlangan vazifa javobini o‘sha mavzuga qaytaradi, shunda hech narsa yo‘qolmaydi.

Muhim cheklov: bot faqat gateway ishlab turganda javob beradi. Hermes ishlayotgan kompyuterni o‘chirsangiz yoki uyqu rejimiga qo‘ysangiz, mashina qayta ishga tushmaguncha bot javob bermaydi. Botni doimo onlayn saqlash uchun agentni serverga ko‘chiring: Hermes Agent’ni sutka davomida ishlatish haqidagi alohida qo‘llanmamiz bor. Odatiy sozlamada gateway yangi xabarlarni Telegram’dan so‘rab turadi; kiruvchi trafik bo‘lmaganda uyquga ketadigan bulut platformalari uchun hujjatlarda webhook rejimi taklif etilgan. Bu rejim ulanish yo‘nalishini teskarisiga o‘zgartiradi, ya’ni so‘rovlarni Telegram’ning o‘zi botga yuboradi.

Begonalarni botdan qanday cheklaysiz?#

Foydalanuvchi nomi orqali botingizni Telegram qidiruvida topish mumkin, shuning uchun himoya ikki narsaga tayanadi: ruxsatlar ro‘yxati va tokenning maxfiy saqlanishi.

Avval TELEGRAM_ALLOWED_USERS orqali yuboruvchi kirishini sozlang. Guruhlar uchun TELEGRAM_GROUP_ALLOWED_CHATS ni ham ko‘ring: chat shu yerda bo‘lsa, ID’si shaxsiy ro‘yxatda yo‘q a’zo ham kira oladi. Shaxsiy ro‘yxat bo‘shligi barcha guruhlar yopiq ekanini isbotlamaydi.

Ikkinchisi — token. U skrinshotlarda, yo‘naltirilgan xabarlarda yoki repozitoriylarda qolib ketmasligi kerak. Token oshkor bo‘lsa, BotFather’da /revoke buyrug‘i bilan bekor qiling. Keyin yangi tokenni sozlamalarga kiriting va gateway’ni qayta ishga tushiring.

Guruhlarda yuboruvchi va chat avtorizatsiyasi alohida. TELEGRAM_GROUP_ALLOWED_CHATS orqali ruxsatli guruh a’zosi TELEGRAM_ALLOWED_USERS da bo‘lmasa ham botdan foydalana oladi. Kirish individual qolishi kerak bo‘lsa, butun guruhni ochmang; o‘rnatilgan versiyada yuboruvchi cheklovlarini sozlab tekshiring. Agar bot guruhda faqat chaqirilganda javob berishini istasangiz, telegram.require_mention sozlamasi bor — shunda u @ orqali eslatilganda, o‘z xabariga javob yozilganda, /command@yourbot kabi buyruq yuborilganda va telegram.mention_patterns ichidagi andozalarga mos kelganda javob beradi, oddiy guruh xabarlarini esa e’tiborsiz qoldiradi.

Guruhda bot nega jim turadi va buni qanday tuzatasiz?#

Yangi Telegram botlarida maxfiylik rejimi odatiy sozlamada yoqilgan bo‘ladi; Hermes hujjatlarida bu guruh botlari bilan bog‘liq chalkashliklarning eng keng tarqalgan manbasi sifatida tasvirlangan. Bu rejimda bot faqat / bilan boshlanadigan buyruqlarni, o‘z xabarlariga yozilgan javoblarni va xizmat bildirishnomalarini oladi. Oddiy guruh xabarlarini umuman olmaydi — Telegram ularni botga yubormaydi, agentning hech qanday sozlamasi buni tuzata olmaydi.

Buni tuzatish:

1. @BotFather’ni ochib, /mybots yuboring.
2. Botni tanlang.
3. “Bot Settings” → “Group Privacy” → “Turn off” bo‘limini oching.
4. Botni guruhdan olib tashlab, qayta qo‘shing.

To‘rtinchi bosqichni unutish oson, shunda bot “hali ham jim turadi.” Telegram bot guruhga qo‘shilgan paytdagi maxfiylik sozlamasini eslab qoladi va bot guruhdan olib tashlanib, qayta qo‘shilmaguncha uni yangilamaydi.

Maxfiylikni hamma joyda o‘chirishni istamasangiz, ikkinchi yo‘l — botni guruh administratori qilish. Administrator botlar istalgan maxfiylik rejimida barcha xabarlarni oladi.

Ulanishda ko‘p uchraydigan xatolar va ularni tuzatish#

Odamlar Hermes Agent’ning Telegram’dagi ishlashi haqida yana nimalarni so‘rashadi?#

Tayyor bo‘lganingizda, Ailoot bilan tanishing.