A Hermes Agent csatlakoztatása a Telegramhoz és a feladatok kezelése telefonról

A Hermes Agentnek üzeneteket küldhetsz, vagy feladatokat diktálhatsz neki a Telegramon a telefonodról, amikor nem vagy a számítógépednél, az eredményt pedig ugyanabban a csevegésben kapod meg. Az ütemezett feladatok eredményei egyszeri beállítás után az általad kijelölt fő csevegésbe érkeznek.

Ha még nincs Hermesed, először olvasd el az útmutatót arról, mi ez az ügynök, és hogyan telepítheted, majd térj vissza a Telegram csatlakoztatásához.

További útmutatást az Ailoot dokumentációjában találsz.

Mire van szükséged a Hermes Agent Telegramhoz csatlakoztatásához?#

A hermes doctor parancs ellenőrzi a Hermes telepítését és a modellkapcsolatot. A botot a Telegram alkalmazásban hozzuk létre; a terminálparancsok futtatásához számítógépre lesz szükséged.

Hogyan hozhatsz létre botot a BotFatherrel?#

Minden Telegram-botnak van tokenje — ez egy titkos kulcs, amellyel vezérelhető a bot. Ezt a Telegram hivatalos botja, a @BotFather adja ki.

1. Nyisd meg a @BotFather botot

   Keress rá a Telegramon a @BotFather névre, vagy nyisd meg a t.me/BotFather oldalt. Az igazi BotFather neve mellett kék hitelesítési pipa látható. A „Start” gombra koppintva kezdd el a beszélgetést.

2. Küldd el a /newbot parancsot

   A BotFather két nevet fog kérni. Az első a megjelenített név; bármi lehet, például „My Agent”. A második a felhasználónév: egyedinek kell lennie, és bot végződésűnek kell lennie, például moy_agent_bot.

3. Szerezd meg a tokent

   A BotFather gratuláló üzenetet és egy hosszú, 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ formátumú karakterláncot küld. Ez a bot tokenje. Másold ki a teljes karakterláncot.

Van egy gyorsabb módszer is, amelyhez nem kell kézzel beszélgetned a BotFatherrel. A Hermes webes irányítópultján (hermes dashboard) és az asztali alkalmazásban, a „Messaging → Telegram” oldalon található egy „Create with QR” gomb: olvasd be a kódot a telefonoddal, és a Hermes létrehozza a botot, felismeri az azonosítódat, elmenti a tokent a beállításokba, majd újraindítja a gatewayt. Az alábbi lépések a kézi módszert mutatják be; ha a QR-kódot választottad, ugorj egyenesen a kapcsolat ellenőrzéséhez.

Hogyan találhatod meg a Telegram-azonosítódat, és miért van rá szükség?#

A Telegram-fióknak két azonosítója van: egy nyilvános, @ jellel kezdődő felhasználónév és egy belső, numerikus azonosító. A Hermes a számot használja.

A gyors, QR-kóddal történő „Create with QR” módszer automatikusan felismeri az azonosítódat. Írd fel a token mellé.

Hogyan adhatod meg a tokent a Hermes Agentnek, és hogyan indíthatod el a gatewayt?#

1. Futtasd a beállítóvarázslót

   hermes gateway setup
   

   A parancsot azon a gépen futtasd, amelyre a Hermes telepítve van. A varázsló megjeleníti az üzenetküldő alkalmazások listáját.

2. Válaszd ki a Telegramot, és add meg az adataidat

   A varázsló bekéri a bot tokenjét és az engedélyezett azonosítókat (többet is megadhatsz, vesszővel elválasztva), majd mindent közvetlenül a beállításokba ment.

3. Indítsd el a gatewayt

   hermes gateway
   

   A gateway elindul, és csatlakozik a Telegramhoz. Néhány másodperc múlva küldj bármilyen üzenetet a botodnak az alkalmazásból: ha a Hermes válaszol, a kapcsolat készen áll.

A varázsló helyett a kézi módszer így néz ki: nyisd meg a ~/.hermes/.env fájlt, és adj hozzá két sort; a BotFathertől kapott tokent és a numerikus azonosítódat írd be:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

A második sor ezeket az embereket privát és csoportos chatben engedélyezi; a külön csoportos engedélyezés is adhat hozzáférést. Több személy esetén vesszővel válaszd el az azonosítókat. A fájl mentése után indítsd el a gatewayt ugyanazzal a hermes gateway paranccsal.

Ha a bot még privát csevegésben is néma marad, ellenőrizd a gateway naplóit ugyanabban a terminálban, és először győződj meg arról, hogy a token és az azonosítód helyesen szerepel a hozzáférési listában; a többi hibát a cikk végén található táblázat ismerteti.

Mire képes a Telegram-bot a telefonodon?#

A telefonodon leggyakrabban öt képességre lesz szükséged.

Szöveges és hangüzenetek. Írd le szavakkal a feladatot, vagy diktálj hangüzenetet — ha be van állítva a beszédfelismerés, a Hermes átírja és megérti. Helyi szolgáltató használatakor nincs szükség kulcsokra; minden azon a gépen fut, amelyen az ügynök működik.

Fájlok és képek. Továbbíthatsz a botnak dokumentumot, táblázatot vagy képernyőképet — az ügynök mellékletként kapja meg. Az ügynök létrehozott fájlokat is vissza tud küldeni: kérj egy jelentést, és fájlként küldi el a csevegésben.

Megerősítés veszélyes műveletek előtt. Ha az ügynök valami kockázatos műveletet készül végrehajtani, például fájlokat törölni, előbb rákérdez a csevegésben: válaszolj „yes” vagy „y” szöveggel a végrehajtáshoz, illetve „no” vagy „n” szöveggel a megszakításhoz.

Gombok a begépelés helyett. Ha az ügynöknek pontosításra van szüksége, kérdést küld beágyazott választógombokkal — koppints egy lehetőségre, és az ügynök folytatja a munkát. A /model parancs argumentumok nélkül ugyanilyen gombokkal megjelenített modellválasztó menüt nyit meg.

Csendes értesítések. Alapértelmezés szerint a telefonod csak a végső válaszok, a megerősítési kérések és a parancsok megerősítései esetén csöng. Az olyan szolgáltatási értesítések, mint a „calling a tool” és a „compressing context”, hang nélkül érkeznek, így a telefonod nem csöng minden lépésnél. Ha minden lépésnél hangjelzést szeretnél, módosítsd az üzemmódot a beállításokban.

Hogyan kaphatod meg a háttérfeladatok eredményét a csevegésben?#

Fő csevegés az ütemezett feladatokhoz. A Hermes támogatja az ütemezett feladatokat: „minden reggel 7:43-kor állíts össze nekem egy összefoglalót.” Az eredményt a fő csevegésbe küldi, amelyet egyszer kell kijelölnöd úgy, hogy közvetlenül a bottal folytatott beszélgetésben elküldöd a /sethome parancsot. Amíg a gateway fut, az összefoglalók automatikusan megérkeznek.

Háttérfeladatok. Elküldhetsz egy hosszabb feladatot háttérben történő futtatásra, majd folytathatod a napodat: a bot üzenetet küld, amikor elkészült. Ha egy feladatot valamelyik témából indítasz, a válasz ugyanabba a témába érkezik vissza, így semmi sem vész el.

Fontos korlátozás: a bot csak akkor válaszol, amikor a gateway fut. Ha kikapcsolod vagy alvó módba helyezed a Hermest futtató számítógépet, a bot addig nem válaszol, amíg a gép újra működésbe nem lép. Ha folyamatosan online szeretnéd tartani a botot, költöztesd az ügynököt egy szerverre: külön útmutatónk szól arról, hogyan futtathatod a Hermes Agentet éjjel-nappal. Alapértelmezés szerint a gateway lekérdezi a Telegramot új üzenetekért; az olyan felhőplatformokhoz, amelyek bejövő forgalom nélkül alvó módba lépnek, a dokumentáció webhook módot kínál, amely megfordítja a kapcsolat irányát, így maga a Telegram küld kéréseket a botnak.

Hogyan tarthatod távol az idegeneket a bottól?#

A botod felhasználóneve alapján rá lehet keresni a Telegramon, ezért a védelem két dolgon múlik: a hozzáférési listán és a token titokban tartásán.

Először a TELEGRAM_ALLOWED_USERS segítségével állítsd be a küldők hozzáférését. Csoportoknál a TELEGRAM_GROUP_ALLOWED_CHATS beállítást is nézd át: az ott felsorolt chat bármely tagja hozzáférhet, akkor is, ha küldőazonosítója nincs a személyes engedélylistán. Az üres személyes lista önmagában ezért nem bizonyítja minden csoport lezárását.

Másodszor ott van a token. Nem kerülhet képernyőképekre, továbbított üzenetekbe vagy kódtárakba. Ha kiszivárog, vond vissza a BotFatherben a /revoke paranccsal. Ezután add meg az új tokent a beállításokban, majd indítsd újra a gatewayt.

Külön megjegyzés a csoportokról: a küldő és a chat jogosultsága külön dolog. A TELEGRAM_GROUP_ALLOWED_CHATS által engedélyezett csoport tagja akkor is használhatja a botot, ha azonosítója nincs a TELEGRAM_ALLOWED_USERS listán. Ha a hozzáférésnek egyéninek kell maradnia, ne engedélyezd az egész csoportot; a telepített verzión állítsd be és igazold a küldőkorlátozásokat. Ha azt szeretnéd, hogy a bot csoportban csak megszólításra válaszoljon, létezik a telegram.require_mention beállítás — ekkor egy @-os megemlítésre, az üzenetére adott válaszra, egy /command@yourbot formátumú parancsra és a telegram.mention_patterns mezőben megadott mintákra reagál, a szokásos csoportüzeneteket pedig figyelmen kívül hagyja.

Miért néma a bot egy csoportban, és hogyan javíthatod meg?#

Az új Telegram-botoknál alapértelmezés szerint be van kapcsolva az adatvédelmi mód; a Hermes dokumentációja szerint ez okozza a legtöbb félreértést a csoportokban használt botokkal kapcsolatban. Ebben a módban a bot csak a / jellel kezdődő parancsokat, a saját üzeneteire adott válaszokat és a szolgáltatási értesítéseket kapja meg. A szokásos csoportüzeneteket egyszerűen nem kapja meg — a Telegram nem küldi el neki őket, és ezt semmilyen ügynökbeállítás nem javítja meg.

A javítás menete:

1. Nyisd meg a @BotFather botot, és küldd el a /mybots parancsot.
2. Válaszd ki a botodat.
3. Nyisd meg a „Bot Settings” → „Group Privacy” → „Turn off” menüpontot.
4. Távolítsd el a botot a csoportból, majd add hozzá újra.

A negyedik lépést könnyű kihagyni, ilyenkor pedig a bot „továbbra is néma marad”. A Telegram megjegyzi a bot csoporthoz csatlakozásakor érvényes adatvédelmi beállítást, és nem frissíti, amíg a botot el nem távolítják a csoportból, majd újra hozzá nem adják.

Ha nem szeretnéd globálisan kikapcsolni az adatvédelmi módot, van egy másik lehetőség: tedd a botot a csoport adminisztrátorává. Az adminbotok bármilyen adatvédelmi mód mellett minden üzenetet megkapnak.

Gyakori csatlakozási hibák és megoldásuk#

Mit kérdeznek még az emberek a Hermes Agentről a Telegramon?#

Ha készen állsz, ismerkedj meg az Ailoottal.