Näin yhdistät Hermes Agentin Telegramiin ja hallitset tehtäviä puhelimellasi

Voit lähettää Hermes Agentille viestejä tai sanella sille tehtäviä Telegramissa puhelimellasi, kun olet poissa tietokoneesi äärestä. Saat tulokset samaan keskusteluun. Ajastettujen tehtävien tulokset saapuvat kerran valitsemaasi kotikeskusteluun.

Jos et ole vielä asentanut Hermesiä, aloita oppaasta, jossa kerrotaan mikä tämä agentti on ja miten se asennetaan, ja palaa sitten yhdistämään Telegram.

Lisäohjeita on saatavilla Ailoot-dokumentaatiossa.

Mitä tarvitset Hermes Agentin yhdistämiseen Telegramiin?#

Komento hermes doctor tarkistaa Hermes-asennuksesi ja malliyhteyden. Luomme botin Telegram-sovelluksessa, ja komentojen suorittamiseen tarvitset tietokoneen ja päätteen.

Miten luot botin BotFatherin kautta?#

Jokaisella Telegram-botilla on tunniste — salainen avain, jolla bottia hallitaan. Sen myöntää Telegramin virallinen botti @BotFather.

1. Avaa @BotFather

   Etsi Telegramista @BotFather tai avaa t.me/BotFather. Oikealla BotFatherilla on sininen vahvistusmerkki. Aloita keskustelu napauttamalla ”Start”.

2. Lähetä komento /newbot

   BotFather pyytää kahta nimeä. Ensimmäinen on näyttönimi; se voi olla mikä tahansa, esimerkiksi ”My Agent”. Toinen on käyttäjänimi: sen on oltava yksilöllinen ja päätyttävä merkkeihin bot, esimerkiksi moy_agent_bot.

3. Hanki tunniste

   BotFather lähettää onnitteluviestin ja pitkän merkkijonon muodossa 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Tämä on bottitunniste. Kopioi koko merkkijono.

BotFatherin kanssa ei tarvitse asioida manuaalisesti, sillä käytettävissä on myös nopea tapa. Hermesin verkkonäkymän (hermes dashboard) ja työpöytäsovelluksen ”Messaging → Telegram” -sivulla on ”Create with QR” -painike: skannaa koodi puhelimellasi, niin Hermes luo botin, tunnistaa tunnuksesi, tallentaa tunnisteen asetuksiin ja käynnistää yhdyskäytävän uudelleen. Alla olevat vaiheet kuvaavat manuaalista menetelmää; jos valitsit QR-koodin, siirry suoraan yhteyden tarkistamiseen.

Miten löydät Telegram-tunnuksesi ja miksi tarvitset sitä?#

Telegram-tilillä on kaksi tunnistetta: julkinen @-merkillä alkava käyttäjänimi ja sisäinen numeerinen tunnus. Hermes käyttää numeroa.

Edellä kuvattu nopea ”Luo QR-koodilla” -menetelmä tunnistaa tunnuksesi automaattisesti. Kirjoita se muistiin tunnisteen viereen.

Miten annat tunnisteen Hermes Agentille ja käynnistät yhdyskäytävän?#

1. Suorita ohjattu käyttöönotto

   hermes gateway setup
   

   Suorita komento laitteella, johon Hermes on asennettu. Ohjattu käyttöönotto näyttää luettelon viestisovelluksista.

2. Valitse Telegram ja anna tietosi

   Ohjattu käyttöönotto pyytää bottitunnistetta ja sallittuja tunnuksia (voit antaa useita pilkuilla erotettuina) ja tallentaa kaiken suoraan asetuksiin.

3. Käynnistä yhdyskäytävä

   hermes gateway
   

   Yhdyskäytävä käynnistyy ja muodostaa yhteyden Telegramiin. Lähetä botillesi viesti sovelluksesta muutaman sekunnin kuluttua: jos Hermes vastaa, yhteys on valmis.

Manuaalinen menetelmä ohjatun käyttöönoton sijaan toimii näin: avaa tiedosto ~/.hermes/.env ja lisää siihen kaksi riviä. Korvaa arvot BotFatherilta saamallasi tunnisteella ja numeerisella tunnuksellasi:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Toinen rivi valtuuttaa nämä henkilöt yksityiskeskusteluihin ja ryhmiin. Myös erillinen ryhmäkeskustelun valtuutus voi myöntää pääsyn. Erota useat henkilöt pilkuilla. Tallenna tiedosto ja käynnistä sitten yhdyskäytävä samalla komennolla hermes gateway.

Jos botti pysyy hiljaa myös yksityiskeskustelussa, tarkista yhdyskäytävän lokit samassa päätteessä ja varmista ensin, että tunniste ja tunnuksesi käyttöoikeuslistassa ovat oikein. Muut virheet on koottu artikkelin lopussa olevaan taulukkoon.

Mitä Telegram-botti voi tehdä puhelimellasi?#

Puhelimella tarvitset useimmin näitä viittä toimintoa.

Teksti- ja ääniviestit. Kirjoita tehtävä tai sanele ääniviesti — kun puheentunnistus on määritetty, Hermes muuntaa puheen tekstiksi ja ymmärtää sen. Paikallisen palveluntarjoajan kanssa avaimia ei tarvita; kaikki käsitellään laitteella, jolla agentti toimii.

Tiedostot ja kuvat. Voit välittää botille asiakirjan, laskentataulukon tai kuvakaappauksen — agentti vastaanottaa sen liitteenä. Se voi myös lähettää luomiaan tiedostoja takaisin: pyydä raporttia, niin agentti lähettää sen keskusteluun tiedostona.

Vaarallisten toimintojen vahvistukset. Kun agentti on tekemässä jotakin riskialtista, kuten poistamassa tiedostoja, se kysyy ensin keskustelussa: vastaa ”yes” tai ”y”, niin se tekee sen; vastaa ”no” tai ”n”, niin se peruuttaa toiminnon.

Painikkeet kirjoittamisen sijaan. Kun agentti tarvitsee tarkennuksen, se lähettää kysymyksen, jossa on vaihtoehtopainikkeita — napauta vaihtoehtoa, niin agentti jatkaa työtä. Komento /model ilman argumentteja näyttää samanlaisilla painikkeilla varustetun mallinvalintavalikon.

Äänettömät ilmoitukset. Oletusarvoisesti puhelin soi vain lopullisista vastauksista, vahvistuspyynnöistä ja komentojen vahvistuksista. Palveluilmoitukset, kuten ”työkalun kutsuminen” ja ”kontekstin tiivistäminen”, tulevat äänettömästi, joten puhelin ei soi jokaisessa vaiheessa. Jos haluat ääni-ilmoituksen jokaisesta vaiheesta, vaihda tila asetuksissa.

Miten saat taustatehtävien tulokset keskusteluun?#

Kotikeskustelu ajastetuille tehtäville. Hermes tukee ajastettuja tehtäviä: ”kokoa minulle yhteenveto joka aamu kello 7:43”. Se lähettää tulokset kotikeskusteluun, jonka määrität kerran lähettämällä komennon /sethome suoraan keskustelussa botin kanssa. Yhteenvedot saapuvat automaattisesti niin kauan kuin yhdyskäytävä on käynnissä.

Taustatehtävät. Voit lähettää pitkän tehtävän suoritettavaksi taustalla ja jatkaa päivääsi: botti lähettää viestin, kun tehtävä on valmis. Aiheesta käynnistetty tehtävä palauttaa vastauksen samaan aiheeseen, joten mitään ei katoa.

Tärkeä rajoitus: botti vastaa vain yhdyskäytävän ollessa käynnissä. Jos sammutat Hermesin käynnissä pitävän tietokoneen tai siirrät sen lepotilaan, botti ei vastaa ennen kuin laite on taas käynnissä. Jos haluat botin olevan jatkuvasti verkossa, siirrä agentti palvelimelle: meillä on erillinen opas siitä, miten pidät Hermes Agentin käynnissä ympäri vuorokauden. Oletusarvoisesti yhdyskäytävä kyselee Telegramilta uusia viestejä. Pilvialustoille, jotka menevät lepotilaan saapuvan liikenteen puuttuessa, dokumentaatio tarjoaa webhook-tilan: se kääntää yhteyden suunnan niin, että Telegram lähettää pyynnöt itse botille.

Miten pidät tuntemattomat poissa botin luota?#

Bottisi voi löytyä Telegram-hausta käyttäjänimellään, joten suojaus perustuu kahteen asiaan: käyttöoikeuslistaan ja tunnisteen pitämiseen salassa.

Määritä ensin lähettäjien pääsy asetuksella TELEGRAM_ALLOWED_USERS. Tarkista ryhmistä myös TELEGRAM_GROUP_ALLOWED_CHATS: siinä lueteltu keskustelu sallii jokaisen jäsenensä, vaikka lähettäjätunnus puuttuisi henkilökohtaiselta sallittujen listalta. Pelkkä tyhjä henkilölista ei siksi todista kaikkien ryhmien olevan suljettuja.

Toinen on tunniste. Se ei saa päätyä kuvakaappauksiin, edelleenlähetettyihin viesteihin tai koodivarastoihin. Jos tunniste vuotaa, peruuta se BotFatherissa komennolla /revoke. Anna sitten uusi tunniste asetuksiin ja käynnistä yhdyskäytävä uudelleen.

Ryhmiä koskeva erillinen huomautus: lähettäjän valtuutus ja keskustelun valtuutus ovat eri asioita. Asetuksella TELEGRAM_GROUP_ALLOWED_CHATS sallitun ryhmän jäsen voi käyttää bottia, vaikka hänen tunnuksensa ei olisi asetuksessa TELEGRAM_ALLOWED_USERS. Jos pääsyn pitää pysyä henkilökohtaisena, älä myönnä oikeutta koko ryhmälle. Määritä ja varmista asennetun versiosi lähettäjärajoitukset. Jos haluat botin vastaavan ryhmässä vain silloin, kun sitä puhutellaan, käytössä on asetus telegram.require_mention — silloin botti vastaa @-mainintaan, sen viestiin kirjoitettuun vastaukseen, komentoihin kuten /command@yourbot sekä asetuksen telegram.mention_patterns mukaisiin osumiin ja jättää tavalliset ryhmäviestit huomiotta.

Miksi botti on hiljaa ryhmässä, ja miten korjaat asian?#

Uusissa Telegram-boteissa yksityisyystila on oletusarvoisesti käytössä. Hermes-dokumentaation mukaan se aiheuttaa useimmiten hämmennystä ryhmäbottien kanssa. Tässä tilassa botti vastaanottaa vain /-komennolla alkavat viestit, vastaukset omiin viesteihinsä ja palveluviestit. Tavallisia ryhmäviestejä se ei yksinkertaisesti vastaanota — Telegram ei lähetä niitä sille, eikä mikään agentin asetus korjaa asiaa.

Korjaa asia näin:

1. Avaa @BotFather ja lähetä /mybots.
2. Valitse bottisi.
3. Avaa ”Bot Settings” → ”Group Privacy” → ”Turn off”.
4. Poista botti ryhmästä ja lisää se uudelleen.

Neljäs vaihe on helppo unohtaa, jolloin botti ”on edelleen hiljaa”. Telegram muistaa yksityisyysasetuksen siltä hetkeltä, kun botti liittyi ryhmään, eikä päivitä sitä ennen kuin botti poistetaan ryhmästä ja lisätään uudelleen.

Jos et halua poistaa yksityisyystilaa käytöstä kaikkialla, toinen vaihtoehto on tehdä botista ryhmän ylläpitäjä. Ylläpitäjäbotit vastaanottavat kaikki viestit yksityisyystilasta riippumatta.

Tavallisia yhteysvirheitä ja niiden korjaaminen#

Mitä muuta Hermes Agentista Telegramissa kysytään?#

Kun olet valmis, tutustu Ailootiin.