Hermes Agent-ті серверде тәулік бойы қалай іске қосып тұруға болады

Hermes Agent-ті ноутбукке орнатқаннан кейін мынадай сұрақ туындайды: ноутбук жабық кезде Telegram-да кім жауап беріп, таңғы шолуларды дайындайды? Үстел басында агент тек компьютер қосулы тұрғанда ғана жұмыс істейді. Бот үнемі желіде болып, жоспарланған тапсырмалар өздігінен орындалуы үшін агентті серверге көшіру керек.

Төменде Hermes-ті кәдімгі Linux серверіне қалай орнату, gateway-ді қайта жүктелгеннен кейін автоматты түрде іске қосылатын және үздіксіз жұмыс істейтін қызметке қалай айналдыру, сондай-ақ бөтен адамдардың терминалға кіріп кетпеуі үшін қолжетімділікті қалай шектеу керегі түсіндіріледі. Бұл нұсқаулық ресми құжаттамаға сүйенеді.

Егер Hermes-ті әлі орнатпаған болсаңыз, алдымен бұл агенттің не екенін және оны қалай орнату керегін сипаттайтын бөлек шолуды қараңыз. Бұл нұсқаулық агенттің өз компьютеріңізде жұмыс істеп тұрғанын болжап, оны серверге көшіруді ғана қамтиды.

Ailoot-пен жұмыс істеу туралы ақпарат құжаттамада берілген.

Hermes Agent-ті ноутбуктен серверге не үшін көшіру керек?#

Ноутбукта Hermes қақпағы ашық болып, жаныңызда отырған кезде ғана жұмыс істейді. Оны жапсаңыз, бот үнсіз қалады, таңғы шолу келмейді. «Мессенджерде адамдарға жауап беріп, кесте бойынша істерді атқару» сияқты тапсырма үшін бұл жарамайды.

Сервердің айырмашылығы да осында: ол ешқашан ұйқы режиміне өтпейді және басқа ештеңеге тәуелді емес. Оған дәл сол Hermes-ті орнатасыз, сонда ол сізсіз жұмыс істейді: түнгі үште Telegram-да жауап береді, күн сайын таңертең тақырыптарыңыз бойынша жаңалық жинайды және іске қосулар арасындағы сессияларды сақтайды.

Агентке тұрақты тапсырма берген кезде оны көшіру орынды: өзіңізге не командаңызға арналған бот, таңғы шолулар, автоматты жауаптар немесе құжаттармен жүйелі жұмыс. Егер Hermes-ті белгілі бір жоба үшін ғана сынап көріп, қасында отырсаңыз, әзірше сервердің қажеті жоқ; ол тек қосымша қадам болады.

Hermes Agent-ті VPS-ке орнатпас бұрын нені дайындау керек?#

Орнатуды бастамас бұрын үш нәрсені дайындаңыз.

Сервер. Кәдімгі Linux VPS жарайды. Құжаттамада Linux пен WSL2-ге бірінші кезектегі қолдау көрсетілетіні, ал сынақтар Ubuntu-дың соңғы нұсқасында жүргізілетіні дурдсан. Жүйеде glibc, systemd және таныс каталог құрылымы болса, Hermes дұрыс орнатылады. Серверде бұл маңызды, өйткені төменде сипатталған автоматты іске қосу қадамдарының бәрі systemd-ке сүйенеді; ол Ubuntu мен Debian жүйелерінде бірден қолжетімді.

SSH арқылы қол жеткізу. Серверге SSH арқылы терминалдан қосыласыз; онда тінтуір қолданылмайды. Төмендегі командалардың бәрі осы SSH сеансында орындалады. Егер vibe-code жасап, терминалға әлі үйренбеген болсаңыз, алаңдамаңыз: команда аз, әрқайсын толық көшіріп қоя аласыз.

Таңдалған модель. Агент өздігінен ойламайды, ол модельге сұрау жібереді. Сізсіз жұмыс істейтін сервер үшін модельге қол жеткізу мерзімі аяқталмайтыны маңызды. Ең қарапайым жолы — hermes setup --portal командасы арқылы Nous Portal жазылымын пайдалану: кіру OAuth арқылы орындалады, токен автоматты түрде жаңартылады. Өз API кілттеріңіз де жарайды, бірақ есепшотта қаражат барын қадағалаңыз: балансы бос headless агент жай ғана үнсіз қалады. Модельдің контекст терезесінде кемінде 64,000 токен болуы керек, әйтпесе Hermes оны іске қосудан бас тартады. Тізімдегі барлық бұлттық модель осы талапқа сай.

Hermes Agent-ті серверге бір командамен қалай орнатуға болады?#

Серверге орнату ноутбукке орнатуға ұқсас, бірақ бір айырмашылығы бар: агентке әдетте браузер қажет емес. Браузерді автоматтандыру көлемді Chromium компонентін де әкеледі. Сондықтан --skip-browser жалаушасы қолданылады.

1. Серверге SSH арқылы қосылыңыз

   ssh root@your-server-address
   

   Бұдан кейінгі барлық команданы осы сеанста, сервердің өзінде орындаңыз.

2. Орнатқышты браузерсіз іске қосыңыз

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

   Скрипт қажетті ортаны жүктеп, hermes командасын орнатады. --skip-browser жалаушасы браузерді автоматтандыруды орнатпайды; графикалық интерфейсі жоқ серверде ол тек орын алар еді. Кейін браузер қажет болса, оны бөлек орнатуға болады.

3. Қабықты қайта іске қосып, модель таңдаңыз

   source ~/.bashrc
   hermes setup --portal
   

   Бірінші жол жаңа PATH мәнін жүктейді, сонда hermes командасы табылады. Екінші жол Nous Portal жүйесіне кіруді ашады: кіруді растаңыз, сонда агентке модель мен қызметтерге жеке-жеке кілтсіз қол жеткізу мүмкіндігі беріледі.

4. Орнатылымды тексеріңіз

   hermes doctor
   

   Команда ненің орнатылғанын, не жетіспейтінін және оны қалай түзету керегін көрсетеді. Жасыл белгілер бәрі дайын екенін білдіреді.

Бот пен кестені қоспас бұрын, тікелей серверде бір қалыпты әңгіменің жұмыс істейтінін тексеріңіз: hermes командасын іске қосып, тексеруге болатын жауабы бар қарапайым тапсырма беріңіз. Құжаттамада кәдімгі әңгіме жұмыс істемей тұрып жаңа функцияларды үсті-үстіне қоспауға нақты кеңес беріледі; бұл орынды ұсыныс.

Hermes-ті тәулік бойы қалай іске қосып тұруға болады?#

Gateway — барлық мессенджерге қосылымдарды ұстап тұратын, сессияларды басқаратын және жоспарланған тапсырмаларды орындайтын Hermes-тің жалғыз фондық процесі. Тәулік бойғы жұмыс соған байланысты. Мақсат — осы процесті өздігінен іске қосып, жұмыс істеп тұратындай ету.

Алдымен gateway-ді баптап, мессенджерді қосыңыз:

hermes gateway setup

Баптау шебері платформалар бойынша бағыттап, бот токені мен қолжетімділік тізімін енгізуге көмектеседі. Telegram-ды қосу қадамдары (BotFather арқылы бот жасау, ID-іңізді табу және токенді енгізу) негізгі орнату нұсқаулығында берілген; оларды мұнда қайталамаймын.

Келесіде жиі ұмытылатын тұсқа келеміз. Егер hermes gateway командасын жай ғана іске қоссаңыз, процесс SSH сеансы ашық тұрғанша ғана жұмыс істейді. Терминалды жапсаңыз, gateway тоқтайды. Оны үздіксіз іске қосып тұру үшін жүйенің басқаруына беру керек. Ол үшін бір команда бар:

hermes gateway install

Бұл gateway-ді қызмет ретінде орнатады: Linux жүйесінде — пайдаланушының systemd қызметі, macOS жүйесінде — launchd арқылы. Жүйе процесті бақылап, ол істен шықса қайта іске қосады.

Серверде көбіне екінші нұсқа қажет болады: машина жүктелгенде, кез келген пайдаланушы жүйеге кірмей тұрып іске қосылатын жүйелік қызмет:

sudo hermes gateway install --system

VPS-ке дәл осы керек: сервер қайта жүктеледі, қызмет өздігінен басталады да, бот қайтадан желіге шығады. Оны мына қарапайым командалармен басқарыңыз:

hermes gateway start     # start
hermes gateway stop      # stop
hermes gateway status    # check status

Жүйелік қызмет үшін осы командаларға sudo мен --system жалаушасын қосыңыз. Оларсыз командалар жүктелгенде басталатын қызметке емес, пайдаланушы қызметіне әсер етеді:

sudo hermes gateway start --system
sudo hermes gateway stop --system
sudo hermes gateway status --system

Linger не үшін қажет және онсыз не бұзылады?#

Бұл — ең жиі кездесетін кедергі: қызметті орнаттыңыз, бірақ түнде бот бәрібір үнсіз қалады. Мұның себебі Linux жүйесіндегі пайдаланушы қызметтерінің жұмыс тәртібінде.

Пайдаланушының systemd қызметі әдепкіде сеансқа байланған. SSH арқылы қосылғанда пайдаланушы менеджері іске қосылып, қызмет жұмыс істейді. Жүйеден шыққанда, жүйе пайдаланушыны белсенді емес деп санайды да, gateway-ді қоса алғанда, оның қызметтерін тоқтатады. Жүйеге кіріп-шығып жүретін сервер үшін бұл — сәтсіздік: сіз SSH-та отырған кезде ғана бот желіде болады.

Мұны linger режимімен түзетуге болады. Ол жүйеге пайдаланушы кірмеген кезде де пайдаланушы менеджерін іске қосып тұруға мүмкіндік береді:

sudo loginctl enable-linger username

Осы командадан кейін пайдаланушы қызметі өздігінен жұмыс істеп, сіздің кіруіңізді күтпей-ақ сервер жүктелгенде іске қосылады. Linger болмаса, бұрынғы жағдай қайталанады: SSH-тан шыққанда gateway тоқтап, сервер жүктелгенде іске қосылмайды. Құжаттамада бұл нақты айтылған.

Hermes-ті серверде Docker арқылы автоматты қайта іске қосумен қалай жүргізуге болады?#

Docker — агентті серверде жұмыс істетудің тағы бір жолы. Бұл контейнерлерді бұрыннан қолданып жүрсеңіз немесе агентті негізгі жүйеден оқшаулағыңыз келсе, әсіресе ыңғайлы. Оны бір рет docker run ... setup командасымен баптап, содан кейін контейнерді фондық режимде іске қосыңыз:

docker run -d \
  --name hermes \
  --restart unless-stopped \
  -v ~/.hermes:/opt/data \
  -p 8642:8642 \
  nousresearch/hermes-agent gateway run

Тәулік бойғы жұмысқа жауап беретін жолдар мынаны істейді:

• -d — контейнер фондық режимде жұмыс істейді және терминалды ашық ұстамайды.
• --restart unless-stopped — Docker сервер қайта жүктелгеннен немесе контейнер істен шыққаннан кейін оны қайта іске қосады. Қолмен тоқтатылған контейнерді ғана қайта іске қоспайды.
• -v ~/.hermes:/opt/data — баптаулар, кілттер, сессиялар мен жады контейнердің сыртында, серверде сақталып, контейнерді қайта жасағаннан кейін де жоғалмайды.

Кескін тағы бір қорғаныс қабатын қосады: gateway процесі s6 бақылаушысы арқылы іске қосылады. Gateway істен шықса, контейнердің өзін тоқтатпай, бірнеше секунд ішінде процесс қайта іске қосылады. Бұл қосарланған қорғаныс: Docker контейнерді сыртынан жұмыс істетеді, ал s6 ішіндегі процесті бақылайды.

Docker тәсілінің бір айырмашылығын есте сақтаңыз: мұндай орнатылымдар hermes update командасымен жаңартылмайды. Docker-де жаңарту үшін кескінді жаңасымен ауыстыру керек: соңғы нұсқасын жүктеп алып, контейнерді қайта жасаңыз.

Бәрі жұмыс істейтінін және қайта жүктеуге төзетінін қалай тексеруге болады?#

Пайдаланушы қызметінің күйі мен журналдарын былай тексеріңіз:

hermes gateway status
journalctl --user -u hermes-gateway -f

VPS үшін ұсынылған system қызметінде орнына жүйелік ауқымды қолданыңыз:

sudo hermes gateway status --system
sudo journalctl -u hermes-gateway -f

Бірінші пәрмен таңдалған қызметті, екіншісі сол ауқым журналын тексереді. Unit атаулары әдепкі ~/.hermes орнатылымына қатысты. Басқа Hermes home жұрнақты unit атауын қолдануы мүмкін: status шығысынан дәл атауды алыңыз. System орнатылымын сынағанда user unit-ті бақыламаңыз. Hermes журналдары ~/.hermes/logs/ ішінде сақталады және құпия деректер олардан автоматты түрде бүркемеленеді, сондықтан оларды қолдау қызметіне жіберуге болады.

Енді серверді қайта жүктеп, агенттің өздігінен қайта іске қосылғанын тексеріңіз. Бұл — сервердің негізгі сынағы, оны көбіне ұмытып кетеді:

sudo reboot

Сервер қайта ашылғанда SSH арқылы қосылыңыз. System орнатылымында sudo hermes gateway status --system пен жүйелік журналды, linger бар user орнатылымында hermes gateway status пен user журналын тексеріңіз. Кейін Telegram ботыңызға хабарлама жіберіңіз. Ол сіздің араласуыңызсыз жауап берсе, автоматты іске қосу дұрыс бапталған. Мақсат та осы еді.

Әңгімеңіз жоғалып кете ме деп уайымдаудың қажеті жоқ. Hermes сессияларды дискіге жазып, gateway қайта іске қосылса да сақтайды. Оған қоса, gateway жауап жіберіп жатқан сәтте істен шықса, тапсырманы қайта орындаудың орнына, қалпына келгеннен кейін сол жауапты жеткізеді. Бұл тәулік бойы жұмыс істейтін бот үшін маңызды: күтпеген қайта іске қосылу әңгімені бұзбайды.

Серверде терминалға қол жеткізетін агентті қалай қауіпсіз етуге болады?#

Сервердегі агент — сіз қадағаламайтын кезде жұмыс істейтін, терминалға қол жеткізе алатын бағдарлама. Алдымен мына үш баптауды тексеріңіз.

Ботқа қол жеткізу жабық. Әдепкіде gateway тек қол жеткізу тізіміндегі адамдарға немесе жеке хабарламада код арқылы байланыстыруды аяқтаған адамдарға жауап береді. Терминалға қол жеткізетін бот үшін бұл — дұрыс баптау: ботқа жазған кездейсоқ адам ештеңе істей алмайды. Тізім сандық ID арқылы беріледі, мысалы, Telegram үшін:

TELEGRAM_ALLOWED_USERS=123456789,987654321

Қауіпті командаларды растау. Бір нәрсені жоймас бұрын агент рұқсат сұрайды. Растауды өшіретін YOLO режимі бар; сізсіз жұмыс істейтін серверде оны қоспаған дұрыс. Растау сұраулары қайтымсыз әрекет сіз білмей орындалмауы үшін қажет.

Толық оқшаулауға арналған sandbox. Агенттің сервердің негізгі жүйесін физикалық түрде көре алмауын қаласаңыз, оның командаларын Docker контейнерінде іске қосыңыз:

hermes config set terminal.backend docker

Сонда агент терминалда істейтіннің бәрі оқшауланған sandbox ішінде орындалып, жұмыс істеп тұрған серверге жете алмайды. Агентке өздігінен әрекет ету еркіндігін бергенде бұл — орынды қорғаныс.

Бот үнсіз қалса немесе gateway істен шықса не істеу керек?#

Бот жауап бермей қалса, мына ретпен тексеріңіз. Алдымен орнатылған ауқымды тексеріңіз: system қызметіне sudo hermes gateway status --system пен жүйелік журнал, user қызметіне hermes gateway status пен user журналы. Gateway жұмыс істеп тұрса, бірақ хабарламалар өтпесе, мәселе әдетте платформа баптауында болады: бот токені қате немесе адам қол жеткізу тізімінде жоқ. Сол Hermes home ішінде hermes gateway setup қайта орындап, таңдалған қызметті system үшін hermes gateway status --system, user үшін hermes gateway status арқылы қараңыз. Сәтті setup дұрыс gateway орындалып тұрғанын дәлелдемейді.

Модель бос не оғаш жауап қайтарса, оны hermes model арқылы тексеріп, провайдер мен кіру күйін растаңыз. «Бәрі бұзылды» деген күйден жұмыс тәртібіне қайтаруға көмектесетін жалпы қалпына келтіру реті: hermes doctor, hermes model, hermes setup, кейін system орнатылымына hermes gateway status --system не user орнатылымына hermes gateway status.

Процесс мүлдем істен шықпай-ақ тұрып қалатын сирек, бірақ жағымсыз жағдайға тағы бір кеңес. systemd қызметінде бақылау таймері бар: ~/.hermes/config.yaml файлына мына жолды қосып, қызметті қайта орнатыңыз.

gateway:
  systemd_watchdog_seconds: 120

# VPS system қызметі: бастапқы орнатылымдағы сол Hermes home.
sudo hermes gateway install --system --force
sudo hermes gateway status --system

User қызметіне тек сол ауқымды hermes gateway install --force арқылы қайта жасап, hermes gateway status тексеріңіз. Бір ауқымды таңдаңыз; бір gateway жөндеу үшін екеуін де орнатпаңыз.

Содан кейін gateway жүйеге жүйелі түрде «мен жұмыс істеп тұрмын» деген белгі жібереді, ал белгілер тоқтаса, systemd процесті автоматты түрде қайта іске қосады. Бұл тек systemd бар Linux жүйесінде және процесс қатып қалған жағдайда ғана жұмыс істейді. Бақылау таймері сервер мен мессенджер арасындағы кәдімгі желі үзілуіне әсер етпейді.

Hermes Agent-ті серверде қолдану туралы тағы не сұрайды?#

Ailoot туралы біліңіз.