Cara Menghubungkan Hermes Agent ke Telegram dan Mengurus Tugas dari Telefon

Anda boleh menghantar mesej kepada Hermes Agent atau mendiktekan tugas kepadanya dalam Telegram melalui telefon apabila anda jauh dari komputer, dan menerima hasilnya dalam sembang yang sama. Hasil tugas berjadual akan dihantar ke sembang yang anda tetapkan sebagai sembang utama sekali sahaja.

Jika anda belum mempunyai Hermes, mulakan dengan panduan tentang apa itu ejen ini dan cara memasangnya, kemudian kembali untuk menghubungkan Telegram.

Arahan tambahan tersedia dalam dokumentasi Ailoot.

Apakah yang diperlukan untuk menghubungkan Hermes Agent ke Telegram?#

Perintah hermes doctor memeriksa pemasangan Hermes dan sambungan model anda. Kita akan mencipta bot dalam aplikasi Telegram, dan anda memerlukan komputer untuk menjalankan perintah di terminal.

Bagaimanakah cara mencipta bot melalui BotFather?#

Setiap bot Telegram mempunyai token — kunci rahsia untuk mengawal bot. Token ini dikeluarkan oleh bot rasmi Telegram, @BotFather.

1. Buka @BotFather

   Cari @BotFather dalam Telegram atau buka t.me/BotFather. BotFather yang sebenar mempunyai tanda pengesahan biru. Mulakan perbualan dengan mengetik “Start”.

2. Hantar perintah /newbot

   BotFather akan meminta dua nama. Nama pertama ialah nama paparan; anda boleh memilih apa-apa nama, contohnya “Ejen Saya”. Nama kedua ialah nama pengguna: nama ini mesti unik dan berakhir dengan bot, contohnya moy_agent_bot.

3. Dapatkan token

   BotFather akan menghantar mesej tahniah dan rentetan panjang dalam bentuk 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Inilah token bot. Salin keseluruhan rentetan itu.

Ada juga cara pantas yang tidak memerlukan perbualan manual dengan BotFather. Dalam papan pemuka web Hermes (hermes dashboard) dan aplikasi desktop, pada halaman “Messaging → Telegram”, terdapat butang “Create with QR”: imbas kod itu dengan telefon anda, dan Hermes akan mencipta bot, mengesan ID anda, menyimpan token dalam tetapan serta memulakan semula gateway. Langkah di bawah menerangkan kaedah manual; jika anda memilih QR, teruskan ke langkah menyemak sambungan.

Bagaimanakah cara mencari ID Telegram anda, dan mengapa anda memerlukannya?#

Akaun Telegram mempunyai dua pengecam: nama pengguna awam dengan tanda @ dan ID angka dalaman. Hermes menggunakan nombor tersebut.

Catatkan nombor itu bersama token.

Bagaimanakah cara memberikan token kepada Hermes Agent dan memulakan gateway?#

1. Jalankan wizard persediaan

   hermes gateway setup
   

   Jalankan perintah ini pada mesin tempat Hermes dipasang. Wizard akan memaparkan senarai aplikasi pemesejan.

2. Pilih Telegram dan masukkan butiran anda

   Wizard akan meminta token bot dan ID yang dibenarkan (anda boleh memasukkan beberapa ID, dipisahkan dengan koma) lalu menyimpan semuanya sendiri dalam tetapan.

3. Mulakan gateway

   hermes gateway
   

   Gateway akan bermula dan bersambung ke Telegram. Selepas beberapa saat, hantar apa-apa mesej kepada bot melalui aplikasi: jika Hermes membalas, sambungan itu sudah sedia.

Kaedah manual sebagai ganti wizard adalah seperti berikut: buka fail ~/.hermes/.env dan tambah dua baris, gantikan nilainya dengan token daripada BotFather dan ID angka anda:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Baris kedua membenarkan orang itu dalam sembang peribadi dan kumpulan; kebenaran sembang kumpulan berasingan juga boleh memberikan akses. Pisahkan beberapa orang dengan koma. Selepas menyimpan fail, mulakan gateway dengan perintah hermes gateway yang sama.

Jika bot terus senyap walaupun dalam sembang peribadi, semak log gateway dalam terminal yang sama dan pastikan dahulu token serta ID anda dalam senarai akses adalah betul; ralat lain diterangkan dalam jadual di hujung artikel.

Apakah yang boleh dilakukan oleh bot Telegram pada telefon anda?#

Terdapat lima keupayaan yang paling kerap anda perlukan pada telefon.

Mesej teks dan suara. Taip tugas dengan perkataan atau rakam mesej suara — jika pengecaman pertuturan telah dikonfigurasikan, Hermes akan mentranskripsikan dan memahaminya. Dengan penyedia tempatan, tiada kunci diperlukan; semuanya diproses pada mesin tempat ejen berjalan.

Fail dan gambar. Anda boleh memajukan dokumen, hamparan atau tangkapan skrin kepada bot — ejen akan menerimanya sebagai lampiran. Ejen juga boleh menghantar fail yang dijana kepada anda: minta laporan, dan ejen akan menghantarnya sebagai fail dalam sembang.

Pengesahan untuk tindakan berbahaya. Apabila ejen hendak melakukan sesuatu yang berisiko, seperti memadam fail, ejen akan bertanya dahulu dalam sembang: balas “yes” atau “y” untuk meneruskannya; balas “no” atau “n” untuk membatalkannya.

Butang sebagai ganti menaip balasan. Apabila ejen memerlukan penjelasan, ejen menghantar soalan dengan butang pilihan sebaris — ketik satu pilihan dan ejen akan meneruskan kerja. Perintah /model tanpa argumen memaparkan menu pemilihan model dengan butang yang sama.

Pemberitahuan senyap. Secara lalai, telefon anda hanya berbunyi untuk jawapan akhir, permintaan pengesahan dan pengesahan perintah. Pemberitahuan perkhidmatan seperti “memanggil alat” dan “memampatkan konteks” tiba tanpa bunyi, jadi telefon tidak berbunyi pada setiap langkah. Jika anda mahu pemberitahuan berbunyi pada setiap langkah, tukar mod dalam tetapan.

Bagaimanakah cara mendapatkan hasil tugas latar belakang dalam sembang?#

Sembang utama untuk tugas berjadual. Hermes menyokong tugas berjadual: “setiap pagi pada 7:43, sediakan ringkasan untuk saya”. Hasilnya dihantar ke sembang utama, yang anda tetapkan sekali dengan menghantar perintah /sethome terus dalam perbualan dengan bot. Selagi gateway berjalan, ringkasan akan tiba secara automatik.

Tugas latar belakang. Anda boleh menghantar tugas yang panjang untuk dijalankan di latar belakang dan meneruskan urusan harian anda: bot akan menghantar mesej apabila tugas itu siap. Tugas yang dimulakan daripada topik akan menghantar jawapannya kembali ke topik yang sama supaya tiada apa-apa yang hilang.

Had penting: bot hanya membalas semasa gateway berjalan. Jika anda mematikan atau meletakkan komputer yang menjalankan Hermes dalam mod tidur, bot tidak akan membalas sehingga mesin itu berjalan semula. Untuk memastikan bot sentiasa dalam talian, pindahkan ejen ke pelayan: kami mempunyai panduan berasingan tentang cara memastikan Hermes Agent berjalan sepanjang masa. Secara lalai, gateway mengundi Telegram untuk mendapatkan mesej baharu; bagi platform awan yang masuk ke mod tidur apabila tiada trafik masuk, dokumentasi menawarkan mod webhook, yang membalikkan arah sambungan supaya Telegram sendiri menghantar permintaan kepada bot.

Bagaimanakah cara menghalang orang asing daripada mengakses bot?#

Bot anda boleh ditemukan melalui nama penggunanya dalam carian Telegram, jadi perlindungan bergantung pada dua perkara: senarai akses dan kerahsiaan token.

Pertama, konfigurasikan akses penghantar dengan TELEGRAM_ALLOWED_USERS. Untuk kumpulan, periksa juga TELEGRAM_GROUP_ALLOWED_CHATS: menyenaraikan sembang di situ membenarkan mana-mana ahlinya, walaupun ID penghantar tiada dalam senarai benarkan peribadi. Senarai peribadi kosong sahaja tidak membuktikan semua kumpulan tertutup.

Kedua, terdapat token. Token tidak boleh muncul dalam tangkapan skrin, mesej yang dimajukan atau repositori. Jika token bocor, batalkannya dengan perintah /revoke dalam BotFather. Kemudian masukkan token baharu dalam tetapan dan mulakan semula gateway.

Nota berasingan tentang kumpulan: kebenaran penghantar dan kebenaran sembang ialah perkara berbeza. Ahli kumpulan yang dibenarkan melalui TELEGRAM_GROUP_ALLOWED_CHATS boleh menggunakan bot walaupun IDnya tiada dalam TELEGRAM_ALLOWED_USERS. Jika akses mesti kekal individu, jangan berikan akses kepada seluruh kumpulan; konfigurasikan dan sahkan sekatan penghantar untuk versi dipasang. Jika anda mahu bot hanya membalas dalam kumpulan apabila dipanggil, terdapat tetapan telegram.require_mention — bot kemudian akan membalas sebutan @, balasan kepada mesejnya, perintah seperti /command@yourbot dan padanan dengan corak anda dalam telegram.mention_patterns, sambil mengabaikan mesej kumpulan biasa.

Mengapa bot senyap dalam kumpulan, dan bagaimanakah cara membetulkannya?#

Bot Telegram baharu mempunyai mod privasi yang diaktifkan secara lalai; dokumentasi Hermes menyifatkannya sebagai punca kekeliruan yang paling lazim tentang bot dalam kumpulan. Dalam mod ini, bot hanya menerima mesej yang bermula dengan perintah /, balasan kepada mesejnya sendiri dan pemberitahuan perkhidmatan. Bot memang tidak menerima mesej kumpulan biasa — Telegram tidak menghantarnya kepada bot dan tiada tetapan ejen yang dapat membetulkannya.

Cara membetulkannya:

1. Buka @BotFather dan hantar /mybots.
2. Pilih bot anda.
3. Buka “Bot Settings” → “Group Privacy” → “Turn off”.
4. Keluarkan bot daripada kumpulan dan tambahnya semula.

Langkah keempat mudah terlepas pandang, lalu bot “masih senyap”. Telegram mengingati tetapan privasi semasa bot menyertai kumpulan dan tidak mengemas kininya sehingga bot dikeluarkan daripada kumpulan dan ditambah semula.

Jika anda tidak mahu mematikan privasi secara menyeluruh, ada pilihan kedua: jadikan bot pentadbir kumpulan. Bot pentadbir menerima semua mesej dalam apa-apa mod privasi.

Ralat sambungan lazim dan tindakan yang perlu diambil#

Apakah lagi yang ditanyakan orang tentang Hermes Agent dalam Telegram?#

Apabila anda bersedia, kenali Ailoot.