Kako povezati Hermes Agent s Telegramom in upravljati opravila s telefona

Hermes Agentu lahko pošiljate sporočila ali mu narekujete opravila v Telegramu s telefona, ko niste za računalnikom, rezultat pa prejmete v istem klepetu. Rezultati načrtovanih opravil prispejo v klepet, ki ga enkrat določite kot domači klepet.

Če Hermesa še nimate, najprej preberite vodnik o tem, kaj je ta agent in kako ga namestiti, nato pa se vrnite in povežite Telegram.

Dodatna navodila so na voljo v dokumentaciji Ailoot.

Kaj potrebujete za povezavo Hermes Agent s Telegramom?#

Ukaz hermes doctor preveri namestitev Hermesa in povezavo z modelom. Bota bomo ustvarili v aplikaciji Telegram, za izvajanje ukazov v terminalu pa potrebujete računalnik.

Kako ustvarite bota prek BotFatherja?#

Vsak bot Telegram ima žeton — skrivni ključ za upravljanje bota. Izdaja ga uradni bot Telegrama, @BotFather.

1. Odprite @BotFather

   V Telegramu poiščite @BotFather ali odprite t.me/BotFather. Pravi BotFather ima modro potrditveno kljukico. Pogovor začnite tako, da tapnete »Start«.

2. Pošljite ukaz /newbot

   BotFather vas bo prosil za dve imeni. Prvo je prikazno ime; lahko je poljubno, na primer »My Agent«. Drugo je uporabniško ime: biti mora edinstveno in se končati z bot, na primer moy_agent_bot.

3. Pridobite žeton

   BotFather vam bo poslal čestitko in dolg niz v obliki 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. To je žeton bota. Kopirajte celoten niz.

Obstaja tudi hitrejši način, pri katerem vam ni treba ročno klepetati z BotFatherjem. Na spletnem nadzorni plošči Hermesa (hermes dashboard) in v namizni aplikaciji je na strani »Messaging → Telegram« gumb »Create with QR«: s telefonom optično preberite kodo, Hermes pa bo ustvaril bota, zaznal vaš ID, shranil žeton v nastavitve in znova zagnal prehod. Spodnji koraki opisujejo ročni način; če ste izbrali QR, nadaljujte neposredno s preverjanjem povezave.

Kako najdete svoj ID Telegrama in zakaj ga potrebujete?#

Račun Telegram ima dva identifikatorja: javno uporabniško ime z znakom @ in notranji številčni ID. Hermes uporablja številko.

Hitri način »Ustvari s QR« iz zgornjih navodil samodejno zazna vaš ID. Zapišite si ga poleg žetona.

Kako Hermes Agentu posredujete žeton in zaženete prehod?#

1. Zaženite čarovnika za nastavitev

   hermes gateway setup
   

   Ukaz zaženite na napravi, kjer je nameščen Hermes. Čarovnik bo prikazal seznam aplikacij za sporočanje.

2. Izberite Telegram in vnesite svoje podatke

   Čarovnik bo zahteval žeton bota in dovoljene ID-je (vnesete jih lahko več, ločene z vejicami) ter vse shranil neposredno v nastavitve.

3. Zaženite prehod

   hermes gateway
   

   Prehod se bo zagnal in povezal s Telegramom. Čez nekaj sekund pošljite botu poljubno sporočilo iz aplikacije: če Hermes odgovori, je povezava pripravljena.

Ročni način namesto čarovnika je videti takole: odprite datoteko ~/.hermes/.env in dodajte dve vrstici, pri čemer nadomestite žeton s tistim od BotFatherja in svoj številčni ID s svojim:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Druga vrstica pooblasti te osebe v zasebnih klepetih in skupinah; dostop lahko dodeli tudi ločeno dovoljenje skupinskega klepeta. Več oseb ločite z vejicami. Ko shranite datoteko, zaženite prehod z istim ukazom hermes gateway.

Če bot molči tudi v zasebnem klepetu, preverite dnevnike prehoda v istem terminalu in najprej preverite, ali sta žeton in vaš ID na seznamu dovoljenih dostopov pravilna; druge napake so obravnavane v tabeli na koncu članka.

Kaj lahko Telegramov bot počne na vašem telefonu?#

Na telefonu boste najpogosteje potrebovali pet zmogljivosti.

Besedilna in glasovna sporočila. Opravilo napišite z besedami ali narekujte glasovno sporočilo — če je prepoznavanje govora nastavljeno, ga bo Hermes prepisal in razumel. Z lokalnim ponudnikom ne potrebujete ključev; vse se obdela na napravi, kjer deluje agent.

Datoteke in slike. Botu lahko posredujete dokument, preglednico ali posnetek zaslona — agent ga bo prejel kot prilogo. Pošlje vam lahko tudi ustvarjene datoteke: prosite za poročilo in poslal vam ga bo kot datoteko v klepetu.

Potrditve za nevarna dejanja. Ko bo agent želel izvesti nekaj tveganega, na primer izbrisati datoteke, bo najprej vprašal v klepetu: odgovorite »yes« ali »y«, da to izvede; odgovorite »no« ali »n«, da prekliče.

Gumbi namesto tipkanja odgovora. Ko agent potrebuje pojasnilo, pošlje vprašanje z vgrajenimi izbirnimi gumbi — tapnite možnost in agent bo nadaljeval z delom. Ukaz /model brez argumentov prikaže meni za izbiro modela z enakimi gumbi.

Tiha obvestila. Privzeto telefon zazvoni samo za končne odgovore, zahteve za potrditev in potrditve ukazov. Obvestila o delovanju, kot sta »calling a tool« in »compressing context«, prispejo tiho, zato telefon ne zazvoni ob vsakem koraku. Če želite zvočna obvestila pri vsakem koraku, spremenite način v nastavitvah.

Kako prejmete rezultate opravil v ozadju v klepet?#

Domači klepet za načrtovana opravila. Hermes podpira načrtovana opravila: »vsako jutro ob 7:43 mi pripravi povzetek«. Rezultate pošlje v domači klepet, ki ga enkrat določite tako, da ukaz /sethome pošljete neposredno v pogovoru z botom. Dokler prehod deluje, povzetki prihajajo samodejno.

Opravila v ozadju. Pošljete lahko dolgotrajno opravilo, ki se izvaja v ozadju, in nadaljujete svoj dan: bot vam bo poslal sporočilo, ko bo pripravljen. Opravilo, začeto v temi, vrne odgovor v isto temo, zato se nič ne izgubi.

Pomembna omejitev: bot odgovarja samo, ko prehod deluje. Če izklopite računalnik, na katerem deluje Hermes, ali ga preklopite v stanje spanja, bot ne bo odgovarjal, dokler naprava znova ne bo delovala. Če želite, da je bot ves čas dosegljiv, premaknite agenta na strežnik: na voljo je ločen vodnik o tem, kako Hermes Agent ohraniti delujoč ves čas. Prehod privzeto preverja, ali so v Telegramu nova sporočila; za platforme v oblaku, ki preidejo v stanje spanja, ko ni dohodnega prometa, dokumentacija ponuja način webhook, ki obrne smer povezave, tako da Telegram sam pošilja zahteve botu.

Kako preprečite neznancem dostop do bota?#

Vaš bot je v Telegramu mogoče najti z iskanjem po uporabniškem imenu, zato zaščita temelji na dveh stvareh: seznamu dovoljenih dostopov in ohranjanju tajnosti žetona.

Najprej dostop pošiljateljev nastavite s TELEGRAM_ALLOWED_USERS. Za skupine preglejte tudi TELEGRAM_GROUP_ALLOWED_CHATS: navedba klepeta tam dovoljuje dostop vsakemu članu, tudi če njegovega ID-ja ni na osebnem seznamu. Sam prazen osebni seznam zato ne dokazuje, da so vse skupine zaprte.

Drugi je žeton. Ne sme se znajti na posnetkih zaslona, v posredovanih sporočilih ali v repozitorijih. Če žeton uide, ga prekličite z ukazom /revoke pri BotFatherju. Nato v nastavitvah vnesite nov žeton in znova zaženite prehod.

Posebna opomba o skupinah: pooblastilo pošiljatelja in pooblastilo klepeta sta različni stvari. Član skupine, dovoljene prek TELEGRAM_GROUP_ALLOWED_CHATS, lahko bot uporablja, tudi če njegovega ID-ja ni v TELEGRAM_ALLOWED_USERS. Če mora dostop ostati individualen, ne dovolite celotne skupine; za nameščeno različico nastavite in preverite omejitve pošiljateljev. Če želite, da bot v skupini odgovori samo, ko ga pokličete, je na voljo nastavitev telegram.require_mention — v tem primeru se odzove na omembo z @, odgovor na svoje sporočilo, ukaz, kot je /command@yourbot, in ujemanje z vzorci v telegram.mention_patterns, običajna skupinska sporočila pa prezre.

Zakaj je bot v skupini tiho in kako to popravite?#

Pri novih botih Telegram je način zasebnosti privzeto vklopljen; dokumentacija Hermesa navaja, da je to najpogostejši vir zmede pri botih v skupinah. V tem načinu bot prejme samo sporočila, ki se začnejo z ukazom /, odgovore na svoja sporočila in obvestila o delovanju. Običajnih skupinskih sporočil preprosto ne prejme — Telegram mu jih ne pošlje in nobena nastavitev agenta tega ne more popraviti.

Kako to popraviti:

1. Odprite @BotFather in pošljite /mybots.
2. Izberite svojega bota.
3. Odprite »Bot Settings« → »Group Privacy« → »Turn off«.
4. Odstranite bota iz skupine in ga znova dodajte.

Četrti korak zlahka spregledate; potem bot »še vedno molči«. Telegram si zapomni nastavitev zasebnosti, ki je veljala ob pridružitvi bota skupini, in je ne posodobi, dokler bota ne odstranite iz skupine in ga znova dodate.

Če ne želite izklopiti zasebnosti za vse skupine, je na voljo še druga možnost: bota določite za skrbnika skupine. Skrbniški boti prejmejo vsa sporočila ne glede na način zasebnosti.

Pogoste napake pri povezavi in njihova rešitev#

Kaj ljudje še sprašujejo o Hermes Agent v Telegramu?#

Ko boste pripravljeni, spoznajte Ailoot.