Slik kobler du Hermes Agent til Telegram og håndterer oppgaver fra telefonen

Du kan sende meldinger til Hermes Agent eller diktere oppgaver til den i Telegram fra telefonen når du er borte fra datamaskinen, og få resultatet i samme chat. Resultater fra planlagte oppgaver kommer én gang i chatten du har valgt som hjemchat.

Hvis du ikke har Hermes ennå, kan du begynne med veiledningen om hva denne agenten er, og hvordan du installerer den, og deretter komme tilbake for å koble til Telegram.

Du finner flere instruksjoner i Ailoot-dokumentasjonen.

Hva trenger du for å koble Hermes Agent til Telegram?#

Kommandoen hermes doctor sjekker Hermes-installasjonen og modelltilkoblingen. Vi oppretter boten i Telegram-appen, og du trenger en datamaskin for å kjøre kommandoer i terminalen.

Hvordan oppretter du en bot via BotFather?#

Alle Telegram-boter har et token — en hemmelig nøkkel for å styre boten. Det utstedes av Telegrams offisielle bot, @BotFather.

1. Åpne @BotFather

   Søk etter @BotFather i Telegram, eller åpne t.me/BotFather. Den ekte BotFather har et blått verifiseringsmerke. Start samtalen ved å trykke på «Start».

2. Send kommandoen /newbot

   BotFather ber om to navn. Det første er visningsnavnet; det kan være hva som helst, for eksempel «My Agent». Det andre er brukernavnet: det må være unikt og slutte på bot, for eksempel moy_agent_bot.

3. Hent tokenet

   BotFather sender en gratulasjonsmelding og en lang tegnstreng på formen 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Dette er bottokenet. Kopier hele strengen.

Det finnes også en rask måte som ikke krever en manuell samtale med BotFather. I Hermes-nettdashbordet (hermes dashboard) og i skrivebordsappen finnes det en «Create with QR»-knapp på siden «Messaging → Telegram»: Skann koden med telefonen, så oppretter Hermes en bot, finner ID-en din, lagrer tokenet i innstillingene og starter gatewayen på nytt. Trinnene nedenfor beskriver den manuelle metoden; hvis du valgte QR, kan du gå rett til å kontrollere tilkoblingen.

Hvordan finner du Telegram-ID-en din, og hvorfor trenger du den?#

En Telegram-konto har to identifikatorer: et offentlig brukernavn med et @-tegn og en intern numerisk ID. Hermes bruker tallet.

Det er enkelt å finne tallet. Skriv det ned sammen med tokenet.

Hvordan gir du tokenet til Hermes Agent og starter gatewayen?#

1. Kjør oppsettsveiviseren

   hermes gateway setup
   

   Kjør kommandoen på maskinen der Hermes er installert. Veiviseren viser en liste over meldingsapper.

2. Velg Telegram og skriv inn opplysningene dine

   Veiviseren ber om bottokenet og de tillatte ID-ene (du kan skrive inn flere, atskilt med komma) og lagrer alt i selve innstillingene.

3. Start gatewayen

   hermes gateway
   

   Gatewayen starter og kobler seg til Telegram. Etter noen sekunder sender du en melding til boten fra appen: Hvis Hermes svarer, er tilkoblingen klar.

Den manuelle metoden uten veiviseren ser slik ut: Åpne filen ~/.hermes/.env og legg til to linjer. Bytt ut verdiene med tokenet fra BotFather og den numeriske ID-en din:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Den andre linjen autoriserer disse personene i private chatter og grupper. Separat autorisering av gruppechatter kan også gi tilgang. Skill flere personer med komma. Når du har lagret filen, starter du gatewayen med den samme kommandoen hermes gateway.

Hvis boten er stille selv i en privat chat, sjekker du gateway-loggene i samme terminal og kontrollerer først at tokenet og ID-en din i tilgangslisten er riktige; andre feil er omtalt i tabellen på slutten av artikkelen.

Hva kan Telegram-boten gjøre på telefonen din?#

Det er fem funksjoner du oftest vil trenge på telefonen.

Tekst- og talemeldinger. Skriv en oppgave med ord, eller dikter inn en talemelding — når talegjenkjenning er konfigurert, transkriberer Hermes den og forstår innholdet. Med en lokal leverandør trenger du ingen nøkler; alt behandles på maskinen agenten kjører på.

Filer og bilder. Du kan videresende et dokument, et regneark eller et skjermbilde til boten — agenten mottar det som et vedlegg. Den kan også sende genererte filer tilbake: Be om en rapport, så sender den den som en fil i chatten.

Bekreftelser for farlige handlinger. Når agenten skal gjøre noe risikabelt, som å slette filer, spør den først i chatten: Svar «yes» eller «y» for å gjennomføre; svar «no» eller «n» for å avbryte.

Knapper i stedet for å skrive tilbake. Når agenten trenger en avklaring, sender den et spørsmål med innebygde valgknapper — trykk på et alternativ, så fortsetter agenten arbeidet. Kommandoen /model uten argumenter viser en meny for valg av modell med samme type knapper.

Stille varsler. Som standard ringer telefonen bare ved endelige svar, forespørsler om bekreftelse og kommandobekreftelser. Tjenestevarsler som «kaller et verktøy» og «komprimerer kontekst» kommer lydløst, så telefonen ikke ringer ved hvert trinn. Hvis du vil ha lydvarsler ved hvert trinn, endrer du modus i innstillingene.

Hvordan får du resultater fra bakgrunnsoppgaver i chatten?#

Hjemchat for planlagte oppgaver. Hermes støtter planlagte oppgaver: «Sett sammen en oppsummering til meg hver morgen kl. 7:43.» Resultatene sendes til hjemchatten, som du angir én gang ved å sende kommandoen /sethome direkte i samtalen med boten. Så lenge gatewayen kjører, kommer oppsummeringene automatisk.

Bakgrunnsoppgaver. Du kan sende en lang oppgave for å kjøre i bakgrunnen og fortsette med dagen din: Boten sender deg en melding når den er ferdig. En oppgave som startes fra et topic, sender svaret tilbake til det samme topicet, slik at ingenting går tapt.

Viktig begrensning: Boten svarer bare mens gatewayen kjører. Hvis du slår av datamaskinen Hermes kjører på, eller setter den i hvilemodus, svarer ikke boten før maskinen kjører igjen. Hvis du vil holde boten på nett hele tiden, flytter du agenten til en server: Vi har en egen veiledning om hvordan du holder Hermes Agent i gang døgnet rundt. Som standard spør gatewayen Telegram etter nye meldinger; for skyplattformer som går i hvilemodus når det ikke kommer inn trafikk, tilbyr dokumentasjonen en webhook-modus. Den snur retningen på tilkoblingen, slik at Telegram selv sender forespørsler til boten.

Hvordan holder du fremmede ute fra boten?#

Botens brukernavn kan søkes opp i Telegram, så beskyttelsen bygger på to ting: tilgangslisten og at tokenet holdes hemmelig.

Konfigurer først avsendertilgang med TELEGRAM_ALLOWED_USERS. For grupper undersøker du også TELEGRAM_GROUP_ALLOWED_CHATS: En chat oppført der tillater alle medlemmene, selv når avsender-ID-en mangler fra den personlige tillatelseslisten. En tom personlig liste alene beviser derfor ikke at alle grupper er lukket.

For det andre har vi tokenet. Det må ikke havne i skjermbilder, videresendte meldinger eller kodearkiver. Hvis tokenet lekker, tilbakekaller du det med kommandoen /revoke i BotFather. Legg deretter det nye tokenet inn i innstillingene og start gatewayen på nytt.

En egen merknad om grupper: Avsenderautorisasjon og chatautorisasjon er forskjellige. Et medlem av en gruppe tillatt via TELEGRAM_GROUP_ALLOWED_CHATS kan bruke boten selv om ID-en mangler i TELEGRAM_ALLOWED_USERS. Skal tilgangen forbli individuell, gir du ikke hele gruppen tilgang. Konfigurer og verifiser avsenderbegrensninger for installert versjon. Hvis du vil at boten bare skal svare i en gruppe når den blir tilkalt, finnes innstillingen telegram.require_mention. Da svarer den på en @-omtale, et svar på meldingen dens, en kommando som /command@yourbot og treff på mønstrene dine i telegram.mention_patterns, mens vanlige gruppemeldinger ignoreres.

Hvorfor er boten stille i en gruppe, og hvordan løser du det?#

Nye Telegram-boter har personvernmodus aktivert som standard; Hermes-dokumentasjonen beskriver dette som den vanligste kilden til forvirring rundt boter i grupper. I denne modusen mottar boten bare meldinger som starter med en /-kommando, svar på egne meldinger og tjenestevarsler. Den mottar rett og slett ikke vanlige gruppemeldinger — Telegram sender dem ikke til den, og ingen agentinnstilling kan løse dette.

Slik løser du det:

1. Åpne @BotFather og send /mybots.
2. Velg boten din.
3. Åpne «Bot Settings» → «Group Privacy» → «Turn off».
4. Fjern boten fra gruppen og legg den til igjen.

Det er lett å glemme det fjerde trinnet; da «er boten fortsatt stille». Telegram husker personverninnstillingen fra da boten ble med i gruppen og oppdaterer den ikke før boten fjernes fra gruppen og legges til igjen.

Hvis du ikke vil slå av personvern globalt, finnes det et annet alternativ: Gjør boten til gruppeadministrator. Administratorboter mottar alle meldinger uansett personvernmodus.

Vanlige tilkoblingsfeil og hva du kan gjøre#

Hva annet spør folk om Hermes Agent i Telegram?#

Når du er klar, kan du bli kjent med Ailoot.