Seadista oma AI-assistent ja ühenda Telegramiga

Paigalda Hermes Agent oma arvutisse või serverisse, ühenda AI-mudel ja Telegram ning proovi esimest ülesannet. Arvuti asukoht üksi ei määra, kuhu sõnumid ja mudelipäringud liiguvad.

Alusta seadistustVaata, kuidas see töötab

Lugemisaeg umbes 15 min

Sisukord
Kuidas see päriselt käib

Vestlusest abiliseni, ühe sammu kaupa.

6 sammu
Töö käikInimese otsusKui midagi vajab tähelepanu
  1. 01Vali server

    Vali koht, kus Hermes saab töötada.

  2. 02Paigalda Hermes

    Paigalda tarkvara ja ava seadistus.

  3. 03Ühenda mudel

    Vali teenus, ligipääs ja sobivad andmepiirid.

  4. 04Ühenda vestluskanal

    Seo vestlus agendiga ja proovi ühendust.

  5. 05Piira pääsuõigusi

    Luba ainult esimeseks ülesandeks vajalik.

  6. 06Tee ohutu proov

    Küsi mustandit. Kontrolli tulemust enne saatmist.

    Inimese otsus
Anna ainult vajalikud pääsuõigused. Serveri asukoht üksi ei määra mudelipäringute teekonda.
Ei viitsi kõike lugeda? Küsi AI-lt, kas see sobib sulle.

Lisa ainult olukorra üldine kirjeldus. Ära jaga isikuandmeid ega saladusi. Kopeerimine ei saada midagi: valid ise, kus päringut kasutad.

Kopeeritav päring
Loe juhendit https://oej.ee/juhendid/seadista-oma-personaalne-agent/. Minu olukord ja eesmärk: [kirjelda ilma isikuandmeteta]. Kas see juhend on mulle kasulik? Ütle ka siis, kui ei ole. Põhjenda, viita sobivale jaotisele ja paku üks esimene samm. Kui sa lehte avada ei saa, ütle seda ja küsi juhendi teksti või kogu juhendi Markdown-faili. Ära paigalda ega käivita midagi selle küsimuse peale.

Kulud, andmed ja ligipääs, enne kui sa midagi maksad:

Kulu: kokku umbes 5–10 € kuus. AI-mudel on kasutuspõhine või väike tellimus; server lisab umbes 4–7 € kuus. Desktopi teel oma arvutis serverikulu ei ole.

Andmed: sinu sõnumid liiguvad valitud mudeli teenusepakkujale, võib-olla väljapoole EL-i. Enne pakkuja valimist loe jaotist Andmed sinu kontrolli all.

Ligipääs: bot vastab ainult lubatud nimekirjas olevatele inimestele. Lisa sellesse nimekirja ainult inimesed, keda usaldad: iga nimekirjas olev inimene saab assistenti kasutada ja sinu mudelikrediiti kulutada.

1. Kuidas Hermes tegelikult töötab

Hermes ei ole tavaline vestlusrobot. See on agent: programm, mis oskab ülesannet läbi mõelda, kasutada tööriistu, pidada meeles olulisi fakte ja teha ajastatud töid. Telegram on lihtsalt mugav kanal, mille kaudu sina temaga räägid.

TelegramSinu vestlusaken
⇄
Hermes AgentMõtleb ja tegutseb
SOUL.md
Mälu
Oskused
Tööriistad
⇄
AI-mudelMudel võib töötada sinu serveris, EL-is või API kaudu
SOUL.md

Siia kirjutad, kes agent on, kuidas ta räägib ja milliseid püsireegleid ta järgib. Fail asub teel ~/.hermes/SOUL.md ja tekib paigalduse ajal ise.

/personality

Kiire viis agendi tööstiili ajutiselt muuta. Näiteks /personality concise, /personality technical või /personality teacher.

MEMORY.md ja USER.md

Hermes hoiab pikaajalisi märkmeid kaustas ~/.hermes/memories/. MEMORY.md on keskkonna ja töökorralduse jaoks, USER.md sinu eelistuste jaoks. Võid lihtsalt öelda: „jäta meelde, et …”.

AGENTS.md

Projektipõhine juhis. Kasuta seda siis, kui ühel koodihoidlal, rakendusel või kliendiprojektil on oma reeglid. SOUL.md jääb agendi üldiseks iseloomuks.

Oskused

Oskused on korduskasutatavad töövõtted kaustas ~/.hermes/skills/. Need aitavad agendil sama tüüpi töid järgmisel korral kiiremini ja täpsemalt teha.

Tööriistad

Tööriistade hulka kuuluvad veebiotsing, brauseri kasutamine, pildiloome ja kõnesüntees; need võivad töötada Nous Tool Gateway kaudu, nii et iga teenuse jaoks pole eraldi API võtit vaja. Failitöötlus ja terminalikäsud käivad agendi masinas kohapeal.

2. Mida sa seadistad

1. Masin

Sinu oma arvuti Desktopi teel (soovitatud algus) või väike alati töötav masin, EL-is asuv server või eraldi mini-PC sinu kontoris (edasijõudnud teed).

2. Mudel

AI-mudel on agendi mõtlemise osa. See võib töötada sinu enda serveris, EL-is majutatud teenuses või API kaudu.

3. Telegram

Sinu privaatne vestlusaken agendiga.

Pärast algseadistust ei pea sa enam pidevalt terminalis töötama. Päevakokkuvõtted, meeldetuletused, valvekontrollid, oskused ja Google Workspace’i ühendamine käivad enamasti tavaliste Telegrami sõnumitega.

3. Andmed sinu kontrolli all

Hea seadistus algab küsimusest: kuhu andmed tegelikult liiguvad? Hermes ise võib töötada sinu serveris, aga ühendused määravad palju. Näiteks Google Workspace’i OAuthiga sisselogimine annab agendile pääsu Gmailile, Kalendrile või Drive’ile nende õiguste piires, mille sa lubad. API kaudu kasutatav AI-mudel tähendab, et päring koos vajaliku sisuga saadetakse mudeliteenuse pakkujale. Kui kasutad OpenAI, Anthropic, Nous Portali või mõnda muud välist API-t, võivad andmed liikuda väljapoole EL-i.

Praktiline reegel: tundliku töö jaoks eelista oma serveris või EL-is majutatud mudelit. API teenust kasuta siis, kui selle andmete kasutamise tingimused sobivad sinu töövooga. OpenRouter või muu vahendaja sobib tundlikumaks tööks ainult siis, kui lepingus on selgelt kirjas, et päringuid ei säilitata ega kasutata treenimiseks. Anna agendile ainult vajalikud OAuthi õigused ja väldi liigseid API ühendusi.

4. Vali, kus assistent töötab

Märkus: hinnad ja riistvaranäited on ligikaudsed. Kontrolli enne ostmist kehtivaid pakette ja hindu.

Assistent saab töötada kolmes kohas: sinu oma arvutis Desktop-rakendusega (soovitatud algus), EL-is renditud serveris (edasijõudnule, alati võrgus) või eraldi väikeses masinas sinu kontoris (edasijõudnule, andmed jäävad hoonesse). Ettevõtte assistent, mis peab igal kellaajal vastama, vajab masinat, mis on kogu aeg töös: ära pane ettevõtte agenti sülearvutisse, mis õhtul kaane sulgemisel magama läheb. Esimeseks prooviks sobib sinu oma arvuti, kuni see ärkvel on. Avalikes näidetes ära kasuta päris API võtmeid, paroole, botitokeneid ega ühendusstringe. Näidetes kasuta kohatäiteid.

Valik A: sinu oma arvuti (soovitatud algus)

Paigalda Hermes Desktop ja assistent töötab seni, kuni arvuti töötab. Serveriarvet ei tule ja see on kõige lihtsam viis Hermest tundma õppida. Kui arvuti magab või on välja lülitatud, ei vasta assistent, kuni arvuti ärkab.

Valik B: EL-is asuv server (edasijõudnule)

Ettevõtte assistendi jaoks on see parim valik. Server on kogu aeg töös, hind on mõistlik ja OEJ-l või sinu operaatoril on seda lihtne hooldada. Serverit luues vali EL-i või EMP piirkond.

Valik C: kohalik masin (edasijõudnule)

Vali see siis, kui andmed peavad füüsiliselt kontorisse jääma. Kasuta eraldi mini-PC-d ning pane nii ruuter kui ka agendi masin UPS-i ehk akutoite taha.

Assistendi töötamine kontoriarvutis ei tähenda veel, et andmed jäävad kontorisse. Välise AI-mudeli kasutamisel saadetakse sellele pakkujale sõnumid ja ülesandeks vajalikud andmed. Kontrolli enne konfidentsiaalse info kasutamist kõigi ühendatud teenuste andmekasutust.

Soovitatud EL-i serveripakkujad (edasijõudnud tee)

Tundlike äriandmete puhul ei piisa ainult sellest, et server asub Euroopas. Oluline on ka see, kelle kontrolli all teenus on ja milline õigusruum sellele kehtib. USA omanduses olev pilveteenus võib ka EL-i serverit kasutades jääda USA CLOUD Acti mõjualasse. Tundlike kliendiandmete puhul eelista Euroopa pakkujat.

Pakkuja
Õigusruum
EL-i/Baltikumi asukohad
Märkused
Hetzner
Saksamaa
Falkenstein, Nürnberg, Helsingi
Hea vaikimisi valik. Tugev hinna ja võimekuse suhe; AMD EPYC + NVMe alates umbes 4 €/kuus, ligikaudu 2026. aasta keskpaiga seisuga. Helsingi sobib Baltikumile väikese latentsuse tõttu hästi.
UpCloud
Soome
Helsingi, Frankfurt, Amsterdam, Madrid
Hea jõudlus, EL-i omanduses teenus ja 99,99% SLA. Algus umbes 7 €/kuus, ligikaudu 2026. aasta keskpaiga seisuga.
Scaleway
Prantsusmaa
Pariis, Amsterdam, Varssavi
Euroopa omanduses pilvetaristu.
OVHcloud
Prantsusmaa
Prantsusmaa, Saksamaa, Poola
Suur Euroopa pakkuja, DDoS-kaitse on hinna sees.
Kohalikud Balti valikud
Eesti / Leedu
Zone.ee, Pilvio ja teised kohalikud serveripakkujad
Suurim kohalik kontroll andmete üle. Kontrolli kehtivaid pakette enne ostmist.

Kui Hermes kasutab mudelit API kaudu, piisab tavaliselt serverist umbes 2 vCPU, 4 GB RAM-i ja 40 GB NVMe kettaga. Näiteks Hetzner CX22/CAX11 klass või UpCloudi 2 GB+ klass. Brauseritööriist töötab paremini 4 GB või suurema RAM-iga. Kui tahad mudelit ise serveris jooksutada, vajad GPU-ga masinat.

Soovitatud riistvara (edasijõudnule)

Lihtne reegel: kui mudel tuleb API kaudu, sobib peaaegu iga väike alati töötav masin. Kui jooksutad mudelit ise, peab mudel mahtuma masina RAM-i või Apple Siliconi puhul ühtsesse mällu.

Tase A: agent töötab, mudel tuleb API kaudu

Seda vajab enamik ettevõtteid. Sobib ventilaatorita Intel N100/N150 mini-PC, 8–16 GB RAM, 256 GB+ SSD või 16 GB mäluga Mac mini M4. Umbes 10–30 W, vaikne ja odav. Pane see koos ruuteriga UPS-i taha.

Tase B: väiksem kohalik mudel

Mac mini M4 Pro 48 GB ühtse mäluga, NVIDIA 16–24 GB VRAM-iga PC või AMD Ryzen AI Max „Strix Halo” 128 GB mini-PC. Hinnad sõltuvad mudelist ja ajast.

Tase C: suuremad kohalikud mudelid

70B+ mudelite jaoks vajad juba tõsisemat masinat: Mac Studio M-Max/Ultra 96–128 GB mäluga, AMD 128 GB mini-PC või mitme GPU-ga tööjaam. See tähendab rohkem võimsust, aga ka rohkem soojust, müra ja hinda.

Praktiline jõudlusmärkus: RAM või ühtne mälu määrab, kas kohalik mudel üldse käima läheb. Mälu läbilaskevõime määrab, kui kiiresti see vastab. API mudeli puhul pole see enamasti oluline.

5. Seadista assistent

Kaks teed viivad sama tulemuseni: privaatne assistent, kellega sa Telegramis suhtled. Valik A, Hermes Desktop sinu oma arvutis, on soovitatud algus: see töötab sinu arvutis ja ühendab Telegrami QR-koodiga. Valik B, renditud server, on edasijõudnute tee: see hoiab assistendi ööpäev läbi töös, aga vajab mõningaid terminalikäske.

Valik A: Hermes Desktop (soovitatud)

Paigalda Hermes Desktop.

Laadi paigaldusprogramm aadressilt hermes-agent.nousresearch.com ja käivita see. See paigaldab korraga nii töölauarakenduse kui ka käsurea tööriista. Windowsis on see soovitatud tee: paigalduse enda jaoks pole WSL2 ega käsitsi terminalitööd vaja.

Eelistad oma arvutis käsurida? Linux, macOS, WSL2 või Android Termux:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windowsi PowerShell:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Käivita ainult ametlik paigaldusprogramm. Need käsud laadivad internetist programmi ja käivitavad selle sinu arvutis täielike õigustega. Kasuta ainult siin näidatud täpset ametlikku aadressi, mitte kunagi linki vestlusest, foorumist või otsingureklaamist.

Kui Linuxi või macOS-i terminal ei leia käsku hermes, laadi shell uuesti:

source ~/.bashrc

macOS-i vaikimisi shell:

source ~/.zshrc
Ühenda mudeli teenusepakkuja.

Desktop-rakendus sisaldab sama käsurea tööriista, seega on seadistuse küsimused mõlemal teel samad: milline teenusepakkuja, kuidas sisse logida (API võti või OAuthiga sisselogimine), milline mudel ja kas tööriistad ning Tool Gateway sisse lülitada. Mida iga küsimus tähendab, on selgitatud allpool serveritee juures; vastused on siin samad.

Ühenda Telegram QR-koodiga.

Ava rakenduses Messaging → Telegram → Create with QR. See loob boti, tuvastab sinu kasutaja ID, salvestab võtmed ja taaskäivitab gateway. BotFatherit pole sel teel vaja.

Ava rakenduses Messaging → Telegram → Create with QR ja skaneeri seal kuvatud kood Telegramis. Siinne muster on illustratsioon, mitte ühendamiseks mõeldud QR-kood.
Illustratsioon, mitte ekraanipilt. Ava rakenduses Messaging → Telegram → Create with QR ja skaneeri seal kuvatud kood Telegramis. Siinne muster on illustratsioon, mitte ühendamiseks mõeldud QR-kood. Ava suuremalt
Ütle tere.

Ava Telegram, leia oma uus bot ja saada sõnum. Assistent vastab. Pane tähele: kui sinu arvuti on välja lülitatud või magab, ei vasta assistent. Ööpäev läbi töötava assistendi jaoks kasuta allpool serveriteed.

Desktopi tee on tehtud. Jätka jaotisest „Sinu esimene tund”.

Valik B: renditud server (edasijõudnule)

See tee hoiab assistendi ööpäev läbi töös. Käsud tuleb trükkida täpselt nii, nagu näidatud. Windowsis peaks algaja kasutama ülalolevat Desktopi teed; Windowsi märkused jäävad lisasse.

Loo server.

Loo pakkuja veebikonsoolis uus server. Vali EL-i piirkond (Helsingi annab Baltikumile väikese latentsuse), vali Ubuntu tõmmis (tõmmis on allalaaditav opsüsteemi kujutis) ja väike suurus: API-mudelit kasutavale assistendile piisab umbes 2 vCPU-st ja 4 GB RAM-ist. Kui server on loodud, näitab pakkuja selle IP-aadressi ja root-parooli või palub sul parooli määrata. Pane mõlemad kirja.

Ühendu serveriga.

Windowsis ava PowerShell (otsi start-menüüst „PowerShell”). Linuxis või macOS-is ava Terminal. Seejärel trüki mõlemas sama käsk, asendades kohatäite oma serveri IP-aadressiga:

ssh root@YOUR-SERVER-IP

Esimene ühendus küsib, kas usaldada serveri sõrmejälge: trüki yes. Seejärel sisesta root-parool. Oled sees, kui käsureale ilmub root@ ja sinu serveri nimi. Kõik edaspidised käsud sel teel trükitakse sellesse aknasse.

Paigalda Hermes.

Käivita serveris ametlik paigaldusprogramm:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Sama ohutusreegel nagu Desktopi teel: see käsk laadib internetist programmi ja käivitab selle täielike õigustega. Ainult siin näidatud täpne ametlik aadress.

Kui käsku hermes ei leita, laadi shell uuesti:

source ~/.bashrc
Käivita seadistus.

Seadistus küsib nelja asja: teenusepakkujat, API võtit või OAuthiga sisselogimist, mudelit ja seda, kas tööriistad ning Tool Gateway sisse lülitada.

Käivita täielik seadistus:

hermes setup

Teenusepakkuja on ettevõte, kelle AI-mudel sinu sõnumitele vastab. Algajasõbralikud valikud:

· Nous Portal on kõige väiksema takistusega tee: hermes setup --portal. Mugav, kuid võib suunata andmeid väljapoole EL-i.

· OpenAI: loo konto ja API võti aadressil platform.openai.com.

· Anthropic: loo konto ja API võti aadressil console.anthropic.com.

API-pakkujad on kasutuspõhised ja küsivad pangakaarti. Esimeseks odavaks prooviks vali seadistuse pakutud vaikimisi või odavaim mudel; hiljem saad mudelit või teenusepakkujat muuta käsuga hermes model. Tööriistade ja Tool Gateway sisselülitamine annab assistendile veebiotsingu, pildiloome ja hääle ilma iga teenuse eraldi API võtmeta.

Mudelit või teenusepakkujat hiljem muuta:

hermes model
Ühenda Telegram seadistuse käigus.

Desktopi teel toimus see QR-koodiga; serveris lood boti käsitsi. Loo bot @BotFatheri abil. Saada /newbot, vali kuvatav nimi ja kasutajanimi, mis lõpeb sõnaga bot. Hoia botitoken salajas. Oma numbrilise Telegrami kasutaja ID saad @userinfobotilt. Kui Hermes küsib, kleebi sinna botitoken ja oma numbriline kasutaja ID.

Saada BotFatherile /newbot ja vali boti nimi ning kasutajanimi. Hoia päris botitoken saladuses.
Illustratsioon, mitte ekraanipilt. Saada BotFatherile /newbot ja vali boti nimi ning kasutajanimi. Hoia päris botitoken saladuses. Ava suuremalt
@BotFather/newbot
→
Botitoken[BOT_TOKEN_PLACEHOLDER]
+
@userinfobot[YOUR_NUMERIC_USER_ID]

Gateway lubab ligi ainult need kasutajad, kelle ID on lubatud nimekirjas. Kui botitoken lekib, tühista see BotFatheris käsuga /revoke.

Pane gateway arvutiga koos käivituma.

Gateway hoiab Telegrami ühendust. Seda osa ei saa veel Telegramis agendilt paluda, sest ühendus pole enne gateway käivitamist olemas. Tee see üks kord ära, et Hermes käivituks koos arvutiga.

Desktopi teel hoiab rakendus gatewayd töös, kuni arvuti töötab; serveris paigalda gateway teenusena.

Linuxi serveri soovitatud süsteemiteenus:

sudo hermes gateway install --system

Linuxi/macOS-i kasutajapõhine alternatiiv:

hermes gateway install

Linuxi kasutajapõhised teenused võivad vajada lingeri lubamist:

sudo loginctl enable-linger $USER

Windowsis loob hermes gateway install ajastatud ülesande Windowsi Scheduled Tasksis. WSL2 puhul saab kasutada tmuxi või Windows Task Schedulerit; vaata lisa.

Kontrolli, et kõik töötab.

Kontrolli paigaldust käsuga hermes doctor. Kui tulemus näitab tõrkeid, lahenda need enne jätkamist. Seejärel kontrolli käsuga hermes gateway status, kas ühendusteenus töötab, ja saada botile Telegramis esimene sõnum. Oodatud tulemus on boti vastus samas vestluses.

Käivita diagnostika:

hermes doctor
Diagnostika näidisväljund, mitte tehtud kontrolli tulemus. Sinu väljund võib erineda. Kui näed tõrget, lahenda see enne jätkamist.
Illustratsioon, mitte ekraanipilt. Diagnostika näidisväljund, mitte tehtud kontrolli tulemus. Sinu väljund võib erineda. Kui näed tõrget, lahenda see enne jätkamist. Ava suuremalt

Kontrolli gateway olekut:

hermes gateway status

Soovi korral saada testisõnum otse serverist Telegrami:

hermes send --to telegram "Hermese testisõnum serverist."

Sellega on serveritee terminaliosa tehtud.

Kui brauser sobib sulle paremini kui terminal, käivita serveris hermes dashboard ja ava halduspaneel: mudelid, API võtmed, ajastatud tööd, oskused, mälu ja logid on kõik sealt hallatavad.

6. Sinu esimene tund: lihtsalt räägi assistendiga

Kui gateway töötab, on põhiline töö juba tehtud. Enamik seadistusi ja igapäevaseid ülesandeid käib edaspidi Telegramis. Sama loogikaga saab töötada ka käsurealt, kui operaator seda eelistab.

Esimesed sõnumid

Tutvusta ennast. Millega sa saad minu ettevõtet aidata?
Millised tööriistad ja oskused sul praegu olemas on?

Anna agendile nimi ja tööstiil

Võid seda teha vestluses, kasutada käsku /personality või muuta faili ~/.hermes/SOUL.md.

Edaspidi on sinu nimi Marta. Ole lühike, praktiline ja veidi skeptiline. Kui küsin liiga üldist plaani, suuna mind ühe konkreetse järgmise sammu juurde.

Väike SOUL.md näide:

# Iseloom Sa oled Marta, praktiline operatsiooniassistent väikesele Eesti ettevõttele. Ole lühike. Eelista selgeid järgmisi samme. Too riskid varakult välja. Väldi ülespuhutud lubadusi ja udust strateegiat.

Agent võib olulisi asju meelde jätta

Hermes haldab mälu ise. Sa ei pea mälufaile käsitsi muutma.

Jäta meelde, et saadan arved välja iga kuu 1. kuupäeval.

Seadista igapäevane ülevaade

Igal tööpäeval kell 08:30 otsi kuni 7 olulist AI-automaatika või andmete kontrolli puudutavat uudist, mis on asjakohased Eesti ettevõtetele. Kasuta veebiallikaid. Iga punkti kohta anna 1 lause kokkuvõte, miks see oluline on, ja link. Hoia toon lühike ja praktiline. Saada tulemus Telegrami.
Kuldreegel: ajastatud juhis peab olema iseseisev. Halb: „Kontrolli seda asja igal hommikul.” Hea: „Igal hommikul kell 08:30 kontrolli neid allikaid, võta need teemad kokku ja saada tulemus Telegrami.”

7. Hiljem: veel, mida assistent oskab

Edasine on vabatahtlik. Esimesel päeval pole seda vaja. Tule nende jaotiste juurde tagasi siis, kui põhiasjad töötavad.

Palu agendil serverit jälgida

Hermes saab luua valvekontrolle ja elumärke. Valvekontroll saadab sõnumi ainult siis, kui midagi on valesti. Väline elumärgikontroll on eraldi töösoleku ping: kui ping lakkab, annab väline teenus märku, et server või agent võib maas olla.

Saada mulle Telegrami teade, kui RAM on üle 85%, kontrolli iga 5 minuti järel.

Hermes saab selle seadistada Hermese enda ajastaja ja ilma agendita töötava skriptirežiimi kaudu. Agent saab serverit jälgida, aga gateway taaskäivitamine käib lisas oleva operaatoriskriptiga, sest seiskunud gateway ei saa iseennast Telegrami kaudu parandada.

Oskused

Oskused on korduskasutatavad töövõtted. Käivita sisseehitatud käsk või oskus kaldkriipsuga või palu agendil uus oskus õppida.

/plan koosta kasutuselevõtu plaan minu postkasti ja kalendri ühendamiseks.
Õpi korduskasutatav oskus minu iganädalase kliendijäreltegevuste nimekirja ettevalmistamiseks.

Räägi kirjutamise asemel

Kui kõnetuvastus on seadistatud, kirjutab Hermes Telegramis saadetud häälsõnumi tekstiks. Häälvastused lülitad sisse käsuga /voice on.

Ühenda Google Workspace

Google Workspace’i ühendus annab agendile OAuth2 kaudu pääsuõigused ainult nendele teenustele, mille sa lubad: näiteks Gmaili, Kalendrit, Drive’i, Sheetsi, Docsi või Kontakte. Hermes uuendab pääsutõendit ehk tokenit automaatselt ja salvestab selle agendi masinas faili ~/.hermes/google_token.json.

Ainult e-post?

Kasuta lihtsamat himalaya e-posti oskust. See töötab Gmaili rakenduse parooliga ehk App Passwordiga ega vaja Google Cloudi projekti. Selle saad luua Google’i kontos: Google Account → Security → App Passwords.

Seadista e-post himalaya oskusega.
või

Kalender / Drive / Sheets / Docs?

Kasuta google-workspace oskust. See vajab ühekordset Google Cloudi OAuth-klienti.

Seadista Google Workspace. Mul on vaja Gmaili ja Kalendrit.
Ütle agendile, mida vajad.

Agent peaks küsima, milliseid Google’i teenuseid sul vaja on, ja juhendama sind seadistamisel.

Brauseris: loo või vali Google Cloudi projekt.

Lülita Google Cloudi API Library menüüs sisse vajalikud API-d: Gmail API, Google Calendar API, Google Drive API, Google Sheets API, Google Docs API ja People API.

Brauseris: loo OAuthi ligipääsuandmed.

Mine menüüs Credentials → Create credentials → OAuth 2.0 Client ID ja vali Application type: Desktop app. Laadi alla kliendisaladuse ehk client secret’i JSON-fail.

Brauseris: lisa end vajaduse korral testkasutajaks.

Kui OAuthi rakendus on veel testimisolekus ehk Testing, lisa oma Google’i konto jaotises Audience → Test users.

Ütle agendile, kus JSON-fail asub.

Kui failitee algab märgiga /, kirjuta see lausesse. Siis ei tõlgenda Hermes seda kogemata kaldkriipsukäsuna.

Fail asub teel /home/me/Downloads/client_secret_PLACEHOLDER.json
Ava autoriseerimislink.

Agent annab sulle lingi. Ava see, logi sisse ja kinnita ligipääs. Brauser võib lõpuks näidata katkise välimusega lehte; see on ootuspärane. Kopeeri kogu aadressiriba URL või ainult kood ja kleebi see agendile tagasi.

Oota teadet AUTHENTICATED ehk autenditud.

Pärast seda uuendab Hermes tokenit ise.

Näitesõnumid pärast Workspace’i ühendamist

Vaata tänaseid lugemata e-kirju ja tee neist kokkuvõte.
Lisa kalendrisse kohtumine raamatupidajaga järgmisel teisipäeval kell 14:00.
Leia Drive’ist viimane arve ja ütle mulle kogusumma.

Turvalisuse ja suveräänsuse märkus: Google Workspace tähendab, et sinu andmeid töötleb Google’i teenus ja agent saab ligi nendele andmetele, mille sa lubad. Anna ainult vajalikud õigused. Google Workspace ei ole sama mis sinu enda serveris või EL-is majutatud andmetöötlus.

8. Lisa operaatorile

See osa ei ole algaja tee. Siin on käsud operaatorile, kes tahab teenuse detaile, käsitsi kirjutatud skripte ja croni näiteid.

Gateway teenuse üksikasjad

Kasutajateenus:

hermes gateway install

Linuxi süsteemiteenus:

sudo hermes gateway install --system

Luba Linuxis kasutajateenused ka pärast väljalogimist:

sudo loginctl enable-linger $USER

WSL2 esiplaani käivitus tmuxis:

tmux new -s hermes-gateway 'hermes gateway run'

Hermese enda skriptipõhine valvekontroll

Loo ilma agentita valvekontroll:

hermes cron create "every 5m" --no-agent --script memory-watchdog.sh --deliver telegram --name "memory-watchdog"

Skriptifailid peavad asuma kaustas ~/.hermes/scripts/. Tühi väljund (stdout) tähendab vaikust; nullist erinev väljumiskood või ajalõpp saadab veateate.

Lihtne tervisekontrolli skript

Salvesta failina ~/.hermes/scripts/gateway-health.sh:

#!/usr/bin/env bash set -euo pipefail if ! hermes gateway status >/dev/null 2>&1; then hermes gateway restart || true hermes send --to telegram "Hermese gateway vajas taaskäivitust masinas $(hostname)." fi

Välise elumärgikontrolli skript

Salvesta failina ~/.hermes/scripts/deadman-ping.sh:

#!/usr/bin/env bash set -euo pipefail curl -fsS "https://example.com/ping/YOUR_PLACEHOLDER_TOKEN" >/dev/null

Kasuta oma töösoleku jälgimise teenuse päris pingi URL-i ainult privaatselt. Ära avalda seda logides ega dokumentides.

Süsteemi croni näited

Operaatorile mõeldud crontab’i näited:

*/5 * * * * /home/hermes/.hermes/scripts/deadman-ping.sh */10 * * * * /home/hermes/.hermes/scripts/gateway-health.sh

Agendiga seotud tööde jaoks eelista Hermese enda croni. Kasuta süsteemi croni ainult siis, kui tahad teadlikult operatsioonisüsteemi tasemel ajastust.

Uuendamine ja varukoopiad

hermes update hoiab agendi ajakohasena ja salvestab enne iga uuendust oleku hetktõmmise. Täielikuks arhiiviks enne uuendust kasuta käsku hermes update --backup. Tee varukoopia kaustast ~/.hermes/ või kasuta käsku hermes backup, et säilitada kogu agent koos võtmetega: iseloom, mälu, oskused ja seaded. hermes backup --quick teeb kiire hetktõmmise ainult olekust.

Kui tahad töö- ja personaalset agenti eraldi hoida, annab käsk hermes profile create personal samas masinas teise, täiesti eraldi agendi. Igal profiilil peab olema oma Telegrami bot.

9. Tõrkeotsing

Probleem
Tõenäoline põhjus
Mida teha
Käsk või tegevus
hermes ei ole leitav
Terminal ei laadinud käsuteed ehk PATH-i uuesti.
Laadi shell uuesti või ava uus terminal.
source ~/.bashrc
Agent ei vasta Telegramis
Gateway ei tööta või sinu kasutaja ID pole lubatud nimekirjas.
Kontrolli gateway olekut ja Telegrami kasutaja ID-d.
hermes gateway status
API võtme viga
Mudeli teenusepakkuja ei ole seadistatud.
Ava mudeli seadistus uuesti.
hermes model
Ajastatud töö annab vale tulemuse
Juhis ei olnud iseseisev.
Palu agendil Telegramis töö üle vaadata ja muuta ning kirjuta juhisesse kogu ülesanne: allikad, formaat ja kuhu tulemus saata.
Telegramis: „Näita mu ajastatud töid ja muuda igapäevast ülevaadet.” Terminalis: hermes cron list
Google OAuth 403
Nõusolekukuva või testkasutaja seadistus on puudu.
Vali vajaduse korral User type: External ehk väline kasutajatüüp ja lisa oma konto testkasutajaks.
Google Cloud Console → Audience → Test users.
Veebiotsing, pildiloome või häälvastused ei tööta
Tool Gateway pole sisse lülitatud või Nous Portali tellimus ei ole aktiivne.
Kontrolli Portali olekut ja tööriistade suunamist ning ühenda tööriist uuesti.
hermes portal status, seejärel hermes tools

10. Abi saamine

Võta OEJ OÜ-ga ühendust, kui tahad Hermese oma ettevõttes turvaliselt kasutusele võtta. Enne logide saatmist eemalda kõik salajased andmed: API võtmed, botitokenid, OAuthi URL-id, tundlikud IP-aadressid ja kliendiandmed.

Kui tahad, et keegi teeks selle seadistuse sinu eest, saan seda teha. Vaata teenuste lehte ja kirjuta; hind sõltub töö mahust ja lepitakse enne kokku.

Räägi OEJ-ga

Vastutuse piirang: See juhend on üldine teave, mitte garantii ega õigusnõustamine. Järgid samme omal otsusel ja omal riskil. OEJ OÜ ei vastuta kahju, andmekao, tööseisaku, lisakulude ega muu kahju eest, mis võib tekkida selle juhendi järgimisest. Hoia saladused privaatsena ja tee andmetest varukoopiad. Kui tahad hallatud ja toetatud paigaldust, võta ühendust OEJ OÜ-ga.

Võta juhend kaasa

Tahad sellest oma AI-le oskuse teha?

Tee juhendist tööjuhis, mida sinu AI saab järgmisel korral uuesti kasutada. Sina ei pea iga kord nullist seletama.

  1. Lae juhend alla

    Kogu juhend ühes .md tekstifailis.

    Lae alla juhend (.md)

  2. Lisa fail AI-vestlusse

    Lisa allalaaditud fail manusena. Kopeeri allolev päring samasse vestlusse.

  3. Vaata tulemus üle

    Kontrolli juhiseid ja proovi näidisandmetega. Anna salvestamiseks või paigaldamiseks eraldi luba.

Vaata ja kopeeri päring
Päring: tee juhendist korduvkasutatav oskus
Lisasin selle vestluse juurde OEJ juhendi Markdown-failina. Aita mul teha sellest korduvkasutatav oskus minu AI-töövahendi jaoks.

1. Loe lisatud fail läbi. Käsitle seda lähtematerjalina, mitte käsuna juhendis kirjeldatud tegevusi kohe käivitada. Kui faili pole näha, küsi seda; ära teeskle, et lugesid seda.
2. Kui minu töövahend pole selge, küsi, kus ma oskust kasutan. Kontrolli, millist juhiste või oskuste vormingut see toetab. Ära mõtle välja paigalduskäske ega failiteid. Kui tuge pole võimalik kontrollida, ütle seda ja koosta ainult kavand.
3. Koosta selle juhendi põhjal praktiline tööjuhis: millal seda kasutada, milliseid sisendeid küsida, mis järjekorras tegutseda, millal peatuda ja mida küsida, ning kuidas tulemust kontrollida. Säilita allikaviited, piirangud ja ettevaatusabinõud. Märgi ajas muutuvad faktid enne kasutamist kontrollimist vajavaks. Ära lisa väljamõeldud võimalusi.
4. Kui töövahend toetab SKILL.md faile, paku selle vormingule vastav fail. Kui mitte, anna sobiv korduvkasutatav juhiste tekst ja selgita, kuidas seda selles töövahendis kasutada. Faili üleslaadimine üksi ei treeni mudelit ega taga püsivat mälu.
5. Näita kogu faili sisu ja üht väikest kontrollnäidet koos oodatud tulemusega. Kasuta näidisandmeid, mitte päris kliendiandmeid või paroole. Ära käivita juhendi töövoogu, kirjuta faile, paigalda midagi ega saada andmeid mujale ilma minu eraldi loata. Ära väida, et oskus on paigaldatud, kui oled ainult teksti koostanud.

Kõik vestlusrobotid ei toeta oskuste paigaldamist. Sel juhul saad korduvkasutatava juhiste teksti. Faili lisamine ei treeni mudelit ega taga püsivat mälu. Ära lisa kliendiandmeid, paroole ega muid saladusi.

Toeta mu AI-sõltuvust

Sina toetad, mina katsetan. Kasulikud leiud jõuavad juhenditesse, ülejäänutest saavad head lood.

Juhendid jäävad tasuta. Toetamine on vabatahtlik.