Jak propojit Hermes Agent s Telegramem a spravovat úlohy z telefonu

Když nejste u počítače, můžete Hermes Agentovi psát nebo mu v Telegramu z telefonu diktovat úlohy a výsledek dostanete ve stejném chatu. Výsledky naplánovaných úloh dorazí do chatu, který jednou určíte jako svůj hlavní chat.

Pokud Hermes ještě nemáte, začněte návodem co je tento agent a jak ho nainstalovat a pak se vraťte k propojení Telegramu.

Další pokyny najdete v dokumentaci Ailoot.

Co potřebujete k propojení Hermes Agent s Telegramem?#

Příkaz hermes doctor zkontroluje instalaci Hermes a připojení modelu. Bota vytvoříme v aplikaci Telegram a k zadávání příkazů v terminálu budete potřebovat počítač.

Jak vytvořit Telegram bota pro Hermes Agent přes BotFather?#

Každý bot v Telegramu má token — tajný klíč k ovládání bota. Vydává ho oficiální telegramový bot @BotFather.

1. Otevřete @BotFather

   Vyhledejte v Telegramu @BotFather nebo otevřete t.me/BotFather. Skutečný BotFather má modrou ověřovací značku. Konverzaci zahájíte klepnutím na „Start“.

2. Pošlete příkaz /newbot

   BotFather si vyžádá dvě jména. Prvním je zobrazované jméno; může být libovolné, například „Můj agent“. Druhým je uživatelské jméno: musí být jedinečné a končit na bot, například moy_agent_bot.

3. Získejte token

   BotFather vám pošle blahopřejnou zprávu a dlouhý řetězec ve tvaru 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. To je token bota. Zkopírujte celý řetězec.

Existuje také rychlý způsob, který nevyžaduje ruční konverzaci s BotFatherem. Ve webovém ovládacím panelu Hermes (hermes dashboard) i v desktopové aplikaci na stránce „Messaging → Telegram“ najdete tlačítko „Create with QR“: naskenujte kód telefonem a Hermes vytvoří bota, zjistí vaše ID, uloží token do nastavení a restartuje gateway. Níže jsou popsány ruční kroky; pokud jste zvolili QR, přejděte rovnou ke kontrole připojení.

Jak zjistit své ID v Telegramu a proč ho potřebujete?#

Účet v Telegramu má dva identifikátory: veřejné uživatelské jméno se zavináčem a interní číselné ID. Hermes používá číslo.

The quick “Create with QR” method described above detects your ID automatically. Write it down next to your token.

Jak předat token Hermes Agent a spustit gateway?#

1. Spusťte průvodce nastavením

   hermes gateway setup
   

   Spusťte příkaz na počítači, kde je Hermes nainstalovaný. Průvodce nabídne seznam aplikací pro zasílání zpráv.

2. Vyberte Telegram a zadejte své údaje

   Průvodce si vyžádá token bota a povolená ID (můžete zadat několik ID oddělených čárkami) a vše uloží přímo do nastavení.

3. Spusťte gateway

   hermes gateway
   

   Gateway se spustí a připojí k Telegramu. Po několika sekundách pošlete botovi v aplikaci libovolnou zprávu: pokud Hermes odpoví, připojení je připravené.

Ruční postup místo použití průvodce vypadá takto: otevřete soubor ~/.hermes/.env a přidejte dva řádky. Nahraďte hodnoty tokenem od BotFather a svým číselným ID:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Druhý řádek povoluje tyto osoby v soukromých i skupinových chatech; přístup ale může udělit i samostatné povolení skupinového chatu. Více lidí oddělte čárkami. Po uložení souboru spusťte gateway stejným příkazem hermes gateway.

Pokud bot mlčí i v soukromém chatu, zkontrolujte protokoly gateway ve stejném terminálu a nejprve ověřte token a své ID v seznamu povolených uživatelů; další chyby jsou popsány v tabulce na konci článku.

Co umí telegramový bot ve vašem telefonu?#

Na telefonu nejčastěji využijete pět funkcí.

Textové a hlasové zprávy. Zadejte úlohu slovy nebo nadiktujte hlasovou zprávu — pokud je nastavené rozpoznávání řeči, Hermes ji přepíše a porozumí jí. U místního poskytovatele nejsou potřeba žádné klíče; vše se zpracovává na počítači, kde agent běží.

Soubory a obrázky. Botovi můžete přeposlat dokument, tabulku nebo snímek obrazovky — agent je obdrží jako přílohu. Může také posílat vytvořené soubory zpět: požádejte o zprávu a pošle vám ji jako soubor v chatu.

Potvrzení nebezpečných akcí. Když se agent chystá provést něco riskantního, například smazat soubory, nejprve se zeptá v chatu: odpovězte „yes“ nebo „y“ a provede to; odpovězte „no“ nebo „n“ a akci zruší.

Tlačítka místo psaní odpovědi. Když agent potřebuje upřesnění, pošle otázku s tlačítky možností přímo ve zprávě — klepněte na možnost a agent pokračuje v práci. Příkaz /model bez argumentů zobrazí nabídku výběru modelu se stejnými tlačítky.

Tichá oznámení. Ve výchozím nastavení telefon zazvoní jen při konečných odpovědích, žádostech o potvrzení a potvrzených příkazech. Služební oznámení, například „volání nástroje“ a „komprimace kontextu“, přicházejí potichu, takže telefon nezvoní při každém kroku. Pokud chcete zvuková oznámení při každém kroku, změňte režim v nastavení.

Jak dostávat výsledky úloh na pozadí v chatu?#

Hlavní chat pro naplánované úlohy. Hermes podporuje naplánované úlohy: „každé ráno v 7:43 mi připrav přehled“. Výsledky posílá do hlavního chatu, který jednou určíte odesláním příkazu /sethome přímo v konverzaci s botem. Dokud gateway běží, přehledy přicházejí automaticky.

Úlohy na pozadí. Můžete zadat dlouhou úlohu, která poběží na pozadí, a věnovat se svému dni: bot vám napíše, až bude hotová. Úloha spuštěná z tématu vrátí odpověď do stejného tématu, takže se nic neztratí.

Důležité omezení: bot odpovídá pouze tehdy, když běží gateway. Pokud vypnete počítač, na kterém Hermes běží, nebo ho uspíte, bot nebude odpovídat, dokud počítač znovu nespustíte. Chcete-li, aby byl bot stále online, přesuňte agenta na server: máme samostatný návod jak nechat Hermes Agent běžet nepřetržitě. Gateway ve výchozím nastavení zjišťuje nové zprávy dotazováním Telegramu; pro cloudové platformy, které bez příchozího provozu přecházejí do režimu spánku, dokumentace nabízí režim webhooku. Ten obrací směr připojení, takže Telegram posílá požadavky botovi.

Jak zabránit cizím lidem v přístupu k botovi?#

Vašeho bota lze v Telegramu najít podle uživatelského jména, proto ochrana závisí na dvou věcech: seznamu povolených uživatelů a utajení tokenu.

Nejprve nastavte přístup odesílatelů přes TELEGRAM_ALLOWED_USERS. U skupin prohlédněte i TELEGRAM_GROUP_ALLOWED_CHATS: uvedení chatu povoluje každého člena, i když jeho ID chybí v osobním seznamu. Samotný prázdný osobní seznam proto nedokazuje uzavření všech skupin.

Druhou věcí je token. Nesmí se objevit na snímcích obrazovky, v přeposlaných zprávách ani v repozitářích. Pokud token unikne, zneplatněte ho příkazem /revoke v BotFatheru. Poté zadejte nový token do nastavení a restartujte gateway.

Zvláštní poznámka ke skupinám: oprávnění odesílatele a chatu jsou odlišná. Člen skupiny povolené přes TELEGRAM_GROUP_ALLOWED_CHATS může bota používat i bez svého ID v TELEGRAM_ALLOWED_USERS. Má-li přístup zůstat individuální, nepovolujte celou skupinu; nastavte a ověřte omezení odesílatelů pro nainstalovanou verzi. Pokud chcete, aby bot ve skupině odpovídal pouze při oslovení, použijte nastavení telegram.require_mention. Pak odpovídá na zmínku @, odpověď na jeho zprávu, příkaz jako /command@yourbot a shody s vašimi vzory v telegram.mention_patterns, zatímco běžné skupinové zprávy ignoruje.

Proč bot ve skupině mlčí a jak to napravit?#

Noví telegramoví boti mají ve výchozím nastavení zapnutý režim soukromí; dokumentace Hermes ho označuje za nejčastější zdroj nejasností při používání botů ve skupinách. V tomto režimu bot dostává pouze zprávy začínající příkazem /, odpovědi na vlastní zprávy a služební oznámení. Běžné skupinové zprávy jednoduše nedostává — Telegram mu je neposílá a žádné nastavení agenta to nenapraví.

Jak to napravit:

1. Otevřete @BotFather a pošlete /mybots.
2. Vyberte svého bota.
3. Otevřete „Bot Settings“ → „Group Privacy“ → „Turn off“.
4. Odeberte bota ze skupiny a znovu ho přidejte.

Na čtvrtý krok se snadno zapomene, a pak bot „stále mlčí“. Telegram si pamatuje nastavení soukromí platné v době, kdy se bot připojil ke skupině, a nezmění ho, dokud bota neodeberete ze skupiny a znovu nepřidáte.

Pokud nechcete soukromí vypnout globálně, existuje druhá možnost: udělejte z bota správce skupiny. Boti se správcovskými právy dostávají všechny zprávy bez ohledu na režim soukromí.

Časté chyby při připojení a co s nimi dělat#

Na co dalšího se lidé ptají o Hermes Agent v Telegramu?#

Až budete připraveni, seznamte se s Ailoot.