Sådan forbinder du Hermes Agent med Telegram og håndterer opgaver fra din telefon

Du kan sende beskeder til Hermes Agent eller diktere opgaver til den i Telegram fra din telefon, når du er væk fra computeren, og modtage resultatet i den samme chat. Resultater fra planlagte opgaver kommer én gang i den chat, du angiver som din hjemmechat.

Hvis du ikke har Hermes endnu, kan du begynde med vejledningen om hvad denne agent er, og hvordan du installerer den og derefter vende tilbage for at forbinde Telegram.

Yderligere instruktioner findes i Ailoot-dokumentationen.

Hvad skal du bruge for at forbinde Hermes Agent med Telegram?#

Kommandoen hermes doctor kontrollerer din Hermes-installation og modeltilslutning. Vi opretter botten i Telegram-appen, og du skal bruge en computer til at køre kommandoer i terminalen.

Hvordan opretter du en bot via BotFather?#

Hver Telegram-bot har et token — en hemmelig nøgle til at styre botten. Det udstedes af Telegrams officielle bot, @BotFather.

1. Åbn @BotFather

   Søg efter @BotFather i Telegram, eller åbn t.me/BotFather. Den ægte BotFather har et blåt verificeringsmærke. Start samtalen ved at trykke på ”Start”.

2. Send kommandoen /newbot

   BotFather beder om to navne. Det første er visningsnavnet; det kan være hvad som helst, for eksempel ”Min agent”. Det andet er brugernavnet: det skal være unikt og slutte på bot, for eksempel moy_agent_bot.

3. Hent tokenet

   BotFather sender en lykønskningsbesked og en lang streng i formatet 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Dette er bottokenet. Kopiér hele strengen.

Der er også en hurtig måde, som ikke kræver en manuel samtale med BotFather. I Hermes-webdashboardet (hermes dashboard) og i desktopappen er der en knap med teksten ”Create with QR” på siden ”Messaging → Telegram”: Scan koden med din telefon, så opretter Hermes en bot, finder dit ID, gemmer tokenet i indstillingerne og genstarter gatewayen. Trinnene nedenfor beskriver den manuelle metode; hvis du valgte QR, kan du gå direkte til at kontrollere forbindelsen.

Hvordan finder du dit Telegram-ID, og hvorfor skal du bruge det?#

En Telegram-konto har to identifikatorer: et offentligt brugernavn med et @-tegn og et internt numerisk ID. Hermes bruger nummeret.

Det er nemt at finde dit nummer: Find dit ID, og skriv det ned ved siden af dit token.

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

1. Kør opsætningsguiden

   hermes gateway setup
   

   Kør kommandoen på den maskine, hvor Hermes er installeret. Guiden viser en liste over beskedapps.

2. Vælg Telegram, og indtast dine oplysninger

   Guiden beder om bottokenet og de tilladte ID'er (du kan indtaste flere adskilt med kommaer) og gemmer det hele direkte i indstillingerne.

3. Start gatewayen

   hermes gateway
   

   Gatewayen starter og opretter forbindelse til Telegram. Send en besked til din bot fra appen efter nogle få sekunder: Hvis Hermes svarer, er forbindelsen klar.

Den manuelle metode i stedet for at bruge guiden ser sådan ud: Åbn filen ~/.hermes/.env, og tilføj to linjer. Erstat værdierne med tokenet fra BotFather og dit numeriske ID:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Den anden linje giver disse personer adgang i private chats og grupper; særskilt godkendelse af en gruppechat kan også give adgang. Adskil flere personer med kommaer. Når du har gemt filen, skal du starte gatewayen med den samme kommando, hermes gateway.

Hvis botten forbliver tavs selv i en privat chat, skal du kontrollere gatewayloggene i den samme terminal og først bekræfte, at tokenet og dit ID på adgangslisten er korrekte. Andre fejl er beskrevet i tabellen sidst i artiklen.

Hvad kan Telegram-botten gøre på din telefon?#

Der er fem funktioner, du oftest får brug for på telefonen.

Tekst- og talebeskeder. Skriv en opgave med ord, eller dikter en talebesked — når talegenkendelse er konfigureret, transskriberer Hermes den og forstår den. Med en lokal udbyder er der ikke brug for nøgler; alt behandles på den maskine, hvor agenten kører.

Filer og billeder. Du kan videresende et dokument, et regneark eller et skærmbillede til botten — agenten modtager det som en vedhæftet fil. Den kan også sende genererede filer tilbage: Bed om en rapport, så sender den den som en fil i chatten.

Bekræftelser af farlige handlinger. Når agenten er ved at gøre noget risikabelt, for eksempel slette filer, spørger den først i chatten: Svar ”yes” eller ”y”, så gør den det; svar ”no” eller ”n”, så annullerer den.

Knapper i stedet for at skrive tilbage. Når agenten har brug for en præcisering, sender den et spørgsmål med knapper med valgmuligheder — tryk på en mulighed, så fortsætter agenten arbejdet. Kommandoen /model uden argumenter viser en menu til valg af model med samme slags knapper.

Stille notifikationer. Som standard ringer telefonen kun ved endelige svar, anmodninger om bekræftelse og kommandobekræftelser. Servicenotifikationer som ”kalder et værktøj” og ”komprimerer kontekst” kommer lydløst, så telefonen ikke ringer ved hvert trin. Hvis du vil have lydnotifikationer ved hvert trin, kan du skifte tilstanden i indstillingerne.

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

Hjemmechat til planlagte opgaver. Hermes understøtter planlagte opgaver: ”Saml en oversigt til mig hver morgen klokken 7:43”. Den sender resultaterne til hjemmechatten, som du angiver én gang ved at sende kommandoen /sethome direkte i samtalen med botten. Så længe gatewayen kører, kommer oversigterne automatisk.

Baggrundsopgaver. Du kan sende en lang opgave, der skal køre i baggrunden, og fortsætte med din dag: Botten sender dig en besked, når den er klar. En opgave, der startes fra et emne, sender svaret tilbage til det samme emne, så intet går tabt.

Vigtig begrænsning: Botten svarer kun, mens gatewayen kører. Hvis du slukker computeren, hvor Hermes kører, eller sætter den på vågeblus, svarer botten ikke, før maskinen kører igen. Hvis du vil holde botten online hele tiden, skal du flytte agenten til en server: Vi har en separat vejledning om hvordan du holder Hermes Agent kørende døgnet rundt. Som standard forespørger gatewayen Telegram for nye beskeder; for cloudplatforme, der går i dvale uden indgående trafik, beskriver dokumentationen en webhook-tilstand, som vender forbindelsesretningen om, så Telegram selv sender anmodninger til botten.

Hvordan holder du fremmede ude af botten?#

Din bot kan findes ved at søge på dens brugernavn i Telegram, så beskyttelsen bygger på to ting: adgangslisten og at holde tokenet hemmeligt.

Konfigurér først afsenderadgang med TELEGRAM_ALLOWED_USERS. Undersøg også TELEGRAM_GROUP_ALLOWED_CHATS for grupper: En chat på den liste tillader alle dens medlemmer, selv når deres afsender-ID ikke findes på den personlige tilladelsesliste. En tom personlig liste alene beviser derfor ikke, at alle grupper er lukkede.

Dernæst er der tokenet. Det må ikke ende i skærmbilleder, videresendte beskeder eller kodearkiver. Hvis tokenet bliver lækket, skal du tilbagekalde det med kommandoen /revoke i BotFather. Indtast derefter det nye token i indstillingerne, og genstart gatewayen.

En særlig bemærkning om grupper: Afsendergodkendelse og chatgodkendelse er forskellige. Et medlem af en gruppe tilladt gennem TELEGRAM_GROUP_ALLOWED_CHATS kan bruge botten, selv om vedkommendes ID ikke står i TELEGRAM_ALLOWED_USERS. Hvis adgangen skal forblive individuel, skal du undlade at give hele gruppen adgang og konfigurere samt verificere afsenderbegrænsningerne for din installerede version. Hvis du kun vil have botten til at svare i en gruppe, når den bliver tiltalt, findes indstillingen telegram.require_mention — så svarer den på en @-omtale, et svar på dens besked, en kommando som /command@yourbot og matches med dine mønstre i telegram.mention_patterns, mens almindelige gruppebeskeder ignoreres.

Hvorfor er botten tavs i en gruppe, og hvordan løser du det?#

Nye Telegram-bots har privatlivstilstanden slået til som standard; Hermes-dokumentationen beskriver den som den hyppigste kilde til forvirring med bots i grupper. I denne tilstand modtager botten kun beskeder, der begynder med en /-kommando, svar på dens egne beskeder og servicemeddelelser. Den modtager ganske enkelt ikke almindelige gruppebeskeder — Telegram sender dem ikke til den, og ingen agentindstilling kan løse det.

Sådan løser du det:

1. Åbn @BotFather, og send /mybots.
2. Vælg din bot.
3. Åbn ”Bot Settings” → ”Group Privacy” → ”Turn off”.
4. Fjern botten fra gruppen, og tilføj den igen.

Det er let at overse det fjerde trin, hvorefter botten ”stadig er tavs”. Telegram husker privatlivsindstillingen fra det tidspunkt, hvor botten blev føjet til gruppen, og opdaterer den ikke, før botten er fjernet fra gruppen og tilføjet igen.

Hvis du ikke vil slå privatlivstilstanden fra globalt, er der en anden mulighed: Gør botten til gruppeadministrator. Administratorbots modtager alle beskeder uanset privatlivstilstanden.

Almindelige forbindelsesfejl, og hvad du kan gøre ved dem#

Hvad spørger folk ellers om Hermes Agent i Telegram?#

Når du er klar, kan du lære Ailoot at kende.