Kaip prijungti „Hermes Agent“ prie „Telegram“ ir tvarkyti užduotis telefonu

Kai nesate prie kompiuterio, galite telefonu rašyti „Hermes Agent“ arba diktuoti jam užduotis per „Telegram“, o rezultatą gauti tame pačiame pokalbyje. Suplanuotų užduočių rezultatai vieną kartą pristatomi į pokalbį, kurį nurodote kaip pagrindinį.

Jei dar neturite „Hermes“, pradėkite nuo vadovo apie tai, kas yra šis agentas ir kaip jį įdiegti, o tada grįžkite prijungti „Telegram“.

Papildomų instrukcijų rasite „Ailoot“ dokumentacijoje.

Ko reikia norint prijungti „Hermes Agent“ prie „Telegram“?#

Komanda hermes doctor patikrina „Hermes“ diegimą ir ryšį su modeliu. Botą sukursime „Telegram“ programėlėje, o komandoms terminale vykdyti reikės kompiuterio.

Kaip sukurti botą per „BotFather“?#

Kiekvienas „Telegram“ botas turi tokeną — slaptą boto valdymo raktą. Jį išduoda oficialus „Telegram“ botas @BotFather.

1. Atidarykite @BotFather

   „Telegram“ paieškoje ieškokite @BotFather arba atidarykite t.me/BotFather. Tikrasis „BotFather“ turi mėlyną patvirtinimo ženklelį. Pradėkite pokalbį bakstelėję „Start“.

2. Išsiųskite komandą /newbot

   „BotFather“ paprašys dviejų vardų. Pirmasis yra rodomas vardas; jis gali būti bet koks, pavyzdžiui, „My Agent“. Antrasis yra naudotojo vardas: jis turi būti unikalus ir baigtis bot, pavyzdžiui, moy_agent_bot.

3. Gaukite tokeną

   „BotFather“ atsiųs sveikinimo pranešimą ir ilgą eilutę, kurios formatas yra 123456789:ABCdefGHIjklMNOpqrSTUvwxYZ. Tai boto tokenas. Nukopijuokite visą eilutę.

Yra ir greitas būdas, kuriam nereikia rankiniu būdu susirašinėti su „BotFather“. „Hermes“ žiniatinklio valdymo skydelyje (hermes dashboard) ir darbalaukio programėlėje puslapyje „Messaging → Telegram“ yra mygtukas „Create with QR“: nuskaitykite kodą telefonu, ir „Hermes“ sukurs botą, aptiks jūsų ID, išsaugos tokeną nustatymuose ir iš naujo paleis šliuzą. Toliau aprašytas rankinis būdas; jei pasirinkote QR kodą, iškart pereikite prie ryšio patikrinimo.

Kaip sužinoti savo „Telegram“ ID ir kam jo reikia?#

„Telegram“ paskyra turi du identifikatorius: viešą naudotojo vardą su @ ženklu ir vidinį skaitinį ID. „Hermes“ naudoja numerį.

Greitasis „Create with QR“ būdas, aprašytas aukščiau, aptinka jūsų ID automatiškai. Užsirašykite jį šalia tokeno.

Kaip perduoti tokeną „Hermes Agent“ ir paleisti šliuzą?#

1. Paleiskite sąrankos vedlį

   hermes gateway setup
   

   Paleiskite komandą kompiuteryje, kuriame įdiegtas „Hermes“. Vedlys pateiks susirašinėjimo programėlių sąrašą.

2. Pasirinkite „Telegram“ ir įveskite savo duomenis

   Vedlys paprašys boto tokeno ir leidžiamų ID (galite įvesti kelis, atskirdami juos kableliais) ir viską išsaugos pačiuose nustatymuose.

3. Paleiskite šliuzą

   hermes gateway
   

   Šliuzas pasileis ir prisijungs prie „Telegram“. Po kelių sekundžių iš programėlės išsiųskite botui bet kokią žinutę: jei „Hermes“ atsakys, ryšys paruoštas.

Rankinis būdas, nenaudojant vedlio, atrodo taip: atidarykite failą ~/.hermes/.env ir pridėkite dvi eilutes, įrašydami „BotFather“ tokeną ir savo skaitinį ID:

TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrSTUvwxYZ
TELEGRAM_ALLOWED_USERS=123456789

Antroji eilutė suteikia tiems žmonėms prieigą privačiuose pokalbiuose ir grupėse; atskiras grupinio pokalbio leidimas taip pat gali suteikti prieigą. Jei žmonių keli, atskirkite juos kableliais. Išsaugoję failą, paleiskite šliuzą ta pačia komanda hermes gateway.

Jei botas tyli net ir privačiame pokalbyje, tame pačiame terminale patikrinkite šliuzo žurnalus ir pirmiausia patikrinkite tokeną bei savo ID prieigos sąraše; kitos klaidos aptariamos straipsnio pabaigoje esančioje lentelėje.

Ką „Telegram“ botas gali daryti jūsų telefone?#

Telefone dažniausiai prireiks penkių funkcijų.

Tekstinės ir balso žinutės. Parašykite užduotį žodžiais arba padiktuokite balso žinutę — sukonfigūravus kalbos atpažinimą, „Hermes“ ją išrašys tekstu ir supras. Naudojant vietinį teikėją raktų nereikia; viskas apdorojama kompiuteryje, kuriame veikia agentas.

Failai ir nuotraukos. Galite persiųsti botui dokumentą, skaičiuoklę arba ekrano kopiją — agentas gaus ją kaip priedą. Jis taip pat gali atsiųsti sukurtus failus: paprašykite ataskaitos, ir jis atsiųs ją pokalbyje kaip failą.

Pavojingų veiksmų patvirtinimai. Kai agentas ruošiasi atlikti ką nors rizikingo, pavyzdžiui, ištrinti failus, jis pirmiausia paklaus pokalbyje: atsakykite „yes“ arba „y“ ir jis tai padarys; atsakykite „no“ arba „n“ ir jis atšauks veiksmą.

Mygtukai vietoj atsakymo rašymo. Kai agentui reikia patikslinimo, jis atsiunčia klausimą su įterptais pasirinkimų mygtukais — bakstelėkite pasirinkimą, ir agentas tęs darbą. Komanda /model be argumentų parodo modelio pasirinkimo meniu su tokiais pat mygtukais.

Tylūs pranešimai. Pagal numatytuosius nustatymus telefonas suskamba tik gavus galutinius atsakymus, patvirtinimo užklausas ir komandų patvirtinimus. Sisteminiai pranešimai, tokie kaip „calling a tool“ ir „compressing context“, gaunami tyliai, todėl telefonas neskamba atliekant kiekvieną veiksmą. Jei norite garsinių pranešimų kiekviename žingsnyje, nustatymuose pakeiskite režimą.

Kaip gauti fone vykdomų užduočių rezultatus pokalbyje?#

Pagrindinis pokalbis suplanuotoms užduotims. „Hermes“ palaiko suplanuotas užduotis: „kiekvieną rytą 7:43 paruošk man suvestinę“. Rezultatus jis siunčia į pagrindinį pokalbį, kurį vieną kartą nurodote tiesiogiai pokalbyje su botu išsiųsdami komandą /sethome. Kol veikia šliuzas, suvestinės atkeliauja automatiškai.

Fone vykdomos užduotys. Galite nusiųsti ilgą užduotį vykdyti fone ir užsiimti savo reikalais: kai ji bus paruošta, botas jums parašys. Iš temos paleista užduotis atsakymą grąžins į tą pačią temą, tad niekas nepasimes.

Svarbus apribojimas: botas atsako tik tada, kai veikia šliuzas. Jei išjungsite kompiuterį, kuriame veikia „Hermes“, arba užmigdysite jį, botas neatsakys, kol kompiuteris vėl neveiks. Jei norite, kad botas būtų nuolat prisijungęs, perkelkite agentą į serverį: turime atskirą vadovą, kaip išlaikyti „Hermes Agent“ veikiantį visą parą. Pagal numatytuosius nustatymus šliuzas tikrina, ar „Telegram“ nėra naujų žinučių; debesijos platformoms, kurios užmiega negavusios įeinančio srauto, dokumentacijoje siūlomas „webhook“ režimas, pakeičiantis ryšio kryptį, kad užklausas botui siųstų pats „Telegram“.

Kaip neleisti nepažįstamiems žmonėms pasiekti boto?#

Jūsų botą galima rasti „Telegram“ paieškoje pagal naudotojo vardą, todėl apsauga priklauso nuo dviejų dalykų: prieigos sąrašo ir slaptai laikomo tokeno.

Pirmiausia siuntėjų prieigą nustatykite su TELEGRAM_ALLOWED_USERS. Grupėms taip pat peržiūrėkite TELEGRAM_GROUP_ALLOWED_CHATS: įrašius ten pokalbį, leidžiama bet kuriam jo nariui, net jei siuntėjo ID nėra asmeniniame leidžiamų naudotojų sąraše. Todėl vien tuščias asmeninis sąrašas neįrodo, kad visos grupės uždaros.

Antra, yra tokenas. Jis neturi patekti į ekrano kopijas, persiųstas žinutes ar saugyklas. Jei tokenas nutekėtų, atšaukite jį „BotFather“ komanda /revoke. Tada įveskite naują tokeną nustatymuose ir iš naujo paleiskite šliuzą.

Atskira pastaba apie grupes: siuntėjo leidimas ir pokalbio leidimas yra skirtingi dalykai. Per TELEGRAM_GROUP_ALLOWED_CHATS leidžiamos grupės narys gali naudoti botą, net jei jo ID nėra TELEGRAM_ALLOWED_USERS. Jei prieiga turi likti individuali, nesuteikite jos visai grupei; sukonfigūruokite ir patikrinkite siuntėjų ribojimus savo įdiegtoje versijoje. Jei norite, kad grupėje botas atsakytų tik tada, kai į jį kreipiamasi, yra nustatymas telegram.require_mention — tuomet jis atsako į @paminėjimą, atsakymą į jo žinutę, komandą, pavyzdžiui, /command@yourbot, ir jūsų šablonų atitiktis telegram.mention_patterns, o į įprastas grupės žinutes nereaguoja.

Kodėl botas tyli grupėje ir kaip tai ištaisyti?#

Naujuose „Telegram“ botuose privatumo režimas įjungtas pagal numatytuosius nustatymus; „Hermes“ dokumentacijoje nurodoma, kad tai dažniausia nesusipratimų dėl botų grupėse priežastis. Veikiant šiam režimui botas gauna tik žinutes, prasidedančias komanda /, atsakymus į savo žinutes ir sistemos pranešimus. Įprastų grupės žinučių jis tiesiog negauna — „Telegram“ jų jam nesiunčia, ir joks agento nustatymas to neišspręs.

Kaip ištaisyti:

1. Atidarykite @BotFather ir išsiųskite /mybots.
2. Pasirinkite savo botą.
3. Atidarykite „Bot Settings“ → „Group Privacy“ → „Turn off“.
4. Pašalinkite botą iš grupės ir pridėkite jį iš naujo.

Lengva pamiršti ketvirtą žingsnį, tada botas „vis tiek tyli“. „Telegram“ įsimena privatumo nustatymą, galiojusį botui prisijungiant prie grupės, ir jo neatnaujina, kol botas nepašalinamas iš grupės ir nepridedamas iš naujo.

Jei nenorite išjungti privatumo visame „Telegram“, yra antras variantas: padarykite botą grupės administratoriumi. Administratoriai botai gauna visas žinutes bet kokiame privatumo režime.

Dažnos ryšio klaidos ir ką daryti#

Ko dar žmonės klausia apie „Hermes Agent“ „Telegram“?#

Kai būsite pasiruošę, susipažinkite su „Ailoot“.