Ako pripojiť Hermes Agent k Telegramu a spravovať úlohy z telefónu

Keď ste mimo počítača, môžete Hermes Agentu posielať správy alebo mu v Telegrame z telefónu diktovať úlohy a výsledok dostanete v tom istom chate. Výsledky naplánovaných úloh sa raz doručia do chatu, ktorý určíte ako svoj domovský chat.

Ak ešte nemáte Hermes, začnite sprievodcom o tom, čo je tento agent a ako ho nainštalovať, a potom sa vráťte a pripojte Telegram.

Ďalšie pokyny nájdete v dokumentácii Ailoot.

Čo potrebujete na pripojenie Hermes Agentu k Telegramu?#

Príkaz hermes doctor skontroluje inštaláciu Hermes a pripojenie modelu. Bota vytvoríme v aplikácii Telegram a na spúšťanie príkazov v termináli budete potrebovať počítač.

Ako vytvoriť bota cez BotFather?#

Každý bot v Telegrame má token — tajný kľúč na ovládanie bota. Vydáva ho oficiálny bot Telegramu, @BotFather.

1. Otvorte @BotFather

   Vyhľadajte v Telegrame @BotFather alebo otvorte t.me/BotFather. Skutočný BotFather má modrú overovaciu značku. Konverzáciu začnite klepnutím na „Štart“.

2. Pošlite príkaz /newbot

   BotFather si vyžiada dve mená. Prvé je zobrazované meno; môže to byť čokoľvek, napríklad „Môj agent“. Druhé je používateľské meno: musí byť jedinečné a končiť na bot, napríklad moy_agent_bot.

3. Získajte token

   BotFather vám pošle gratulačnú správu a dlhý reťazec v tvare 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Toto je token bota. Skopírujte celý reťazec.

Existuje aj rýchly spôsob, ktorý nevyžaduje ručnú konverzáciu s BotFatherom. Vo webovom ovládacom paneli Hermes (hermes dashboard) a v desktopovej aplikácii je na stránke „Messaging → Telegram“ tlačidlo „Create with QR“: naskenujte kód telefónom a Hermes vytvorí bota, zistí vaše ID, uloží token do nastavení a reštartuje gateway. Nasledujúce kroky opisujú ručný postup; ak ste zvolili QR, prejdite rovno na kontrolu pripojenia.

Ako zistiť svoje Telegram ID a načo ho potrebujete?#

Účet Telegram má dva identifikátory: verejné používateľské meno so znakom @ a interné číselné ID. Hermes používa číslo.

Ako záloha slúži ďalší bot, ktorý funguje rovnako.

Ako odovzdať token Hermes Agentu a spustiť gateway?#

1. Spustite sprievodcu nastavením

   hermes gateway setup
   

   Spustite príkaz na zariadení, na ktorom je nainštalovaný Hermes. Sprievodca ponúkne zoznam aplikácií na posielanie správ.

2. Vyberte Telegram a zadajte svoje údaje

   Sprievodca si vyžiada token bota a povolené ID (môžete zadať viacero ID oddelených čiarkami) a uloží všetko priamo do nastavení.

3. Spustite gateway

   hermes gateway
   

   Gateway sa spustí a pripojí k Telegramu. Po niekoľkých sekundách pošlite botovi ľubovoľnú správu z aplikácie: ak Hermes odpovie, pripojenie je pripravené.

Ručný postup namiesto použitia sprievodcu vyzerá takto: otvorte súbor ~/.hermes/.env a pridajte dva riadky, pričom nahraďte tokenom od BotFathera a svojím číselným ID:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Druhý riadok oprávňuje týchto ľudí v súkromných aj skupinových chatoch; prístup sa môže udeliť aj samostatným povolením celého skupinového chatu. Viacerých ľudí oddeľte čiarkami. Po uložení súboru spustite gateway rovnakým príkazom hermes gateway.

Ak bot mlčí aj v súkromnom chate, skontrolujte záznamy gateway v tom istom termináli a najprv overte token a svoje ID v zozname prístupov; ďalšie chyby sú uvedené v tabuľke na konci článku.

Čo dokáže bot Telegramu vo vašom telefóne?#

V telefóne budete najčastejšie potrebovať päť funkcií.

Textové a hlasové správy. Napíšte úlohu slovami alebo nadiktujte hlasovú správu — ak je nastavené rozpoznávanie reči, Hermes ju prepíše a porozumie jej. Pri lokálnom poskytovateľovi nie sú potrebné žiadne kľúče; všetko sa spracúva na zariadení, na ktorom agent beží.

Súbory a obrázky. Botovi môžete preposlať dokument, tabuľku alebo snímku obrazovky — agent ich dostane ako prílohu. Môže vám poslať aj vytvorené súbory: požiadajte o správu a pošle vám ju ako súbor v chate.

Potvrdenia nebezpečných akcií. Keď sa agent chystá urobiť niečo riskantné, napríklad odstrániť súbory, najprv sa opýta v chate: odpovedzte „yes“ alebo „y“ a vykoná to; odpovedzte „no“ alebo „n“ a zruší to.

Tlačidlá namiesto písania odpovede. Keď agent potrebuje spresnenie, pošle otázku s tlačidlami možností priamo v správe — klepnite na možnosť a agent pokračuje v práci. Príkaz /model bez argumentov zobrazí ponuku na výber modelu s rovnakým typom tlačidiel.

Tiché upozornenia. Predvolene telefón zazvoní iba pri konečných odpovediach, žiadostiach o potvrdenie a potvrdeniach príkazov. Systémové upozornenia, ako „volanie nástroja“ a „komprimovanie kontextu“, prichádzajú potichu, takže telefón nezvoní pri každom kroku. Ak chcete zvukové upozornenia pri každom kroku, zmeňte režim v nastaveniach.

Ako dostávať výsledky úloh na pozadí do chatu?#

Domovský chat pre naplánované úlohy. Hermes podporuje naplánované úlohy: „každé ráno o 7:43 mi priprav súhrn“. Výsledky posiela do domovského chatu, ktorý raz určíte priamym odoslaním príkazu /sethome v konverzácii s botom. Pokiaľ gateway beží, súhrny prichádzajú automaticky.

Úlohy na pozadí. Môžete poslať dlhú úlohu na spustenie na pozadí a venovať sa svojmu dňu: bot vám napíše, keď bude hotová. Úloha spustená z témy vráti odpoveď do tej istej témy, takže sa nič nestratí.

Dôležité obmedzenie: bot odpovedá iba vtedy, keď je gateway spustený. Ak vypnete počítač, na ktorom beží Hermes, alebo ho uspíte, bot nebude odpovedať, kým zariadenie znova nespustíte. Ak chcete, aby bol bot stále online, presuňte agenta na server: máme samostatný návod ako nechať Hermes Agent bežať nepretržite. Gateway predvolene kontroluje, či v Telegrame neprišli nové správy; pre cloudové platformy, ktoré sa uspávajú bez prichádzajúcej prevádzky, dokumentácia ponúka režim webhooku, ktorý obráti smer pripojenia, takže požiadavky botovi odosiela priamo Telegram.

Ako zabrániť cudzím ľuďom v prístupe k botovi?#

Váš bot sa dá nájsť vo vyhľadávaní Telegramu podľa používateľského mena, takže ochrana závisí od dvoch vecí: zoznamu prístupov a utajenia tokenu.

Najprv nastavte prístup odosielateľov cez TELEGRAM_ALLOWED_USERS. Pri skupinách prezrite aj TELEGRAM_GROUP_ALLOWED_CHATS: uvedenie chatu povoľuje každého jeho člena, aj keď jeho ID chýba v osobnom zozname. Samotný prázdny osobný zoznam preto nedokazuje uzavretie všetkých skupín.

Druhou vecou je token. Nesmie sa objaviť na snímkach obrazovky, v preposlaných správach ani v repozitároch. Ak token unikne, zneplatnite ho príkazom /revoke v BotFatherovi. Potom zadajte nový token do nastavení a reštartujte gateway.

Osobitná poznámka ku skupinám: oprávnenie odosielateľa a oprávnenie chatu sú odlišné. Člen skupiny povolenej cez TELEGRAM_GROUP_ALLOWED_CHATS môže bota používať aj bez ID v TELEGRAM_ALLOWED_USERS. Ak má prístup zostať individuálny, nepovoľujte celú skupinu; nastavte a overte obmedzenia odosielateľov nainštalovanej verzie. Ak chcete, aby bot v skupine odpovedal iba vtedy, keď ho niekto osloví, k dispozícii je nastavenie telegram.require_mention — potom odpovedá na zmienku @, odpoveď na svoju správu, príkaz ako /command@yourbot a zhody s vašimi vzormi v telegram.mention_patterns, pričom bežné skupinové správy ignoruje.

Prečo bot v skupine mlčí a ako to opraviť?#

Nové boty Telegramu majú predvolene zapnutý režim súkromia; dokumentácia Hermes ho opisuje ako najčastejší zdroj nejasností pri používaní botov v skupinách. V tomto režime bot prijíma iba správy začínajúce príkazom /, odpovede na vlastné správy a systémové upozornenia. Bežné správy skupiny jednoducho nedostáva — Telegram mu ich neposiela a nijaké nastavenie agenta to nevyrieši.

Ako to opraviť:

1. Otvorte @BotFather a pošlite /mybots.
2. Vyberte svojho bota.
3. Otvorte „Bot Settings“ → „Group Privacy“ → „Turn off“.
4. Odstráňte bota zo skupiny a znova ho pridajte.

Na štvrtý krok sa ľahko zabudne a potom bot „stále mlčí“. Telegram si pamätá nastavenie súkromia platné v čase, keď sa bot pripojil ku skupine, a neaktualizuje ho, kým bota zo skupiny neodstránite a znova nepridáte.

Ak nechcete vypnúť režim súkromia globálne, máte druhú možnosť: urobiť z bota správcu skupiny. Boti so správcovskými právami dostávajú všetky správy v akomkoľvek režime súkromia.

Bežné chyby pripojenia a čo s nimi robiť#

Na čo ďalšie sa ľudia pýtajú o Hermes Agente v Telegrame?#

Keď budete pripravení, zoznámte sa s Ailoot.