AI-агент у Telegram, Discord і Slack з CowAgent
Наладжваем CowAgent, бясплатнага агента з адкрытым кодам, у Telegram, Discord ці Slack: усталяванне на камп’ютар, ключы мадэляў, токены ботаў, памяць, навыкі і кошт працы.
Програмы для чатавання — гэта тое месца, дзе ужо жыве багато людзей. Telegram, Discord і Slack перадаюць паведамленні, парады прыемоў і все больш працы. Тады чаму асістэнт на базе ШЫ павінен кожны раз, калі ён патрэбен, вымагаць ўтрымоўкі ў прыгледзачы, яшчо адну програму і новы чат?
Болей прыродны варыянт — гэта калі асістэнт знаходзіцца там, дзе ужо ведзецца праца. Уявіце сабе постаяннага асістэнта ў вашых існуючых платформах для чатавання, які прымеў паведамленні, зберагае кантэкст, памятае пакананыя раней пераказы, плануе задачы і выканае ўсё гэта без дапамогі окалічнай інтэрфейсу.
CowAgent — адзін з праектаў на адкрытым кодзе, які выкананыя такую задачу. Ён бесплатны, працюе на вашам камп’ютары або невялікам серверы і падключаецца да Telegram, Discord чыста Slack. Пасля наладкі ён стае помочнікам, які завжды працюе і да якога можна дасягнуць праз тыя ж каналы, якія вы вжываеце ўсё дзень. Наладка простая, але за кулісамі відбываецца чырвоны калектар задач. Розумеючы, як агент ведае розмовы з гэтымі платформамі, керуе дыялогамі, зберагае інформацыю і ператварае поведамленні на дзеянні, стае набагато простае адналежна налаштаваць яго.
Чаму лепшая самостоятэльна запускаць агента, чым вжываць хоставаны чатбот
Чат-бот у вікні браузера падзей для рэдкіх запытанняў. Але ён стае недастатнім, калі мета пераходзіць з простага запытання на адрабаткі трывалай робы. Вікно браузера не памятае тое, што было ў празылеце, як толькі продукт не зберагае історыю дзе-небудзь. Ён не знаходзіцца ў групавым чаце і не чакае, калі яго хтось памінуць. Ёго нельга запланаваць на публікацыю ранніх падсумкаў або запускаць за дапамогою паведамлення колегі ў раннія гадзіны.
Агент, які працуе без перэрыву на апараты, якія вы кантролюеце, і якія падключэныя безпосерэдна да платформы для перадачы паведамленняў, паводзіцца інакш. Ён застаецца онлайн, як маленькі сервер або фонавая служба. Ён зберагае інформацыю з памяці між сесіямі, у звязку з чым кожны раз не пачынае з нуля. Вы можэце з’явіцца да яго з свага тэлефона праз прыстрой для чату, які ужо ў вас ачынуты, без неабяжнасці інсталавацыі чаго-небудзь новага і без неабяжнасці запам’ятаваць дадатковы логін. А так як програма ў відкрытым кодзе, спосаб, якім яна зберагае размовы і прыме рашэнні, не захаваны ў закрытый сістэме.
Што такое CowAgent
Праект апісвае ся як бесплатны, адкрытыя-кода агент, які выконвае тры задачы, якіх не можа выконаць просты бот для запытанняў і адказаў. Ён плануе задачы і не проста адпавядае на адны паведамленне ізольавана. Ён выкарыстоўвае інструменты, таму можа чытаць файлы, запускаць каманды, шукаць у інтэрнэце чы ўзываць званыя службы, выходзячы за межы простага стварэння тэксту. А ён памятае пакульнія размовы, прынесае кантэкст і не спрыяе кожнаму паведамленню як да чагось абсалютна новага.
Пад гэтымі можлівасцямі знаходзіцца гнучкы слой для з’яўлення з мовнымі мадэлямі. Ён не прыўязаны да аднаго прадаўцы. Вы можэце нацэніць яго на Claude, GPT, Gemini, DeepSeek чы ўсьмох адносна дзесяці іншых, задаўшы ключ API для таго, які вам паспадабляецца. Гэта мае значэнне, таму што якасць, цена і доступнасць модэляў постаўляюцься постаўна, а інструмент, прыўязаны да аднаго прадаўцы, шыбка старэе. Спрыяе карыстоўванню модэля як заменныя часткі тое, што агент застаецца корыстным незалежна ад таго, які прадаўцы ў той момент ёсць лідэрам.
Першы крок: завантажыце кліент для рабочага стола
Найшырэйшы спосаб прыступу — гэта кліент для рабочага стола для macOS і Windows. На адзінцын з інсталляцыяй чыстаю з лініі каманд, версія для рабочага стола аб’яднвае частку, якая адпрацоўвае у спадній часты, ў самай прыкладнай, таму не трэба налажваць околачыцый серверны працэс, прычыму ўсё запрацюе. Завантажэнне і інсталляцыя — гэта весь першы крок, такі ж, як і для будзь-яй прыкладнай для рабочага стола.
Download link: https://cowagent.ai/download/
У Windows гэта зазвычай значыць запуск інсталяра. У macOS гэта зазвычай значыць ператасовванне прыкладнення ў папку Applications або запуск пакета, падпісанага.
Другі крок: абы працаваць з Gatekeeper у macOS
Пользоватэры Mac должны спакоўвацца на паведамленне пра апошні запуск. Gatekeeper, вбудованая сістэма пераканання macOS, шукае прыкладненні, падпісаныя і нотарыяваныя зарэгістраваным распрацоўшчыкам Apple. Праекты з відкрытым кодам, распространяваныя не праз Mac App Store, часта ствараюць проблемы, таму што падпіс і нотарыяванне трэбуюць адказкі распрацоўшчыка Apple і дадатковай наладкі, якой багато праектаў спяльноты не выканалі.
Эта паведамленне не значыць, што сама прыкладка зламаная чы або небяпечная. Яна означае, што macOS не можа параболіць распрацоўшчыка праз ланцуг падпісаў Apple. Ёнколі хочаце продыржыць, клікніце правай кнопкай або клавішай Control на іконцы, выберыце опцыю «Ачыць» з меню заместо двойнага клікання і падтвердзіце. Чырэз гэта гэта прыкладка будзе працаваць, а рэшта настаўкі безпекі сістэмы застануцца некалічанымі. Кожны, хто ўважны, можа прачытаць код праекта пры інсталяванні, адколі весь агент ёсць публічным.
Трэці крок: падключыце прадаўца мовных модэляў
Калі прыкладка будзе ачынена, падключыце прынеймна аднаго прадаўца модэляў з ключам API. Саме ключ забезпечвае інтэлект: планаванне, логіка і стварэнне адпаведзей выконваюцца чырэз той модэль, на які ён натыкаецца, тады як CowAgent керуе памяцю, выкарыстоўваннем інструментаў, планаваннем задач і звязкамі з платформамі чату.
Серэд падрэбных прадаўцоў — Claude, GPT, Gemini і DeepSeek, а таксама ўсьмох дзесятак іншых. Кожнам з іх патрэбны свае ключы, якія можна атрымаць з консолі распрацоўшчыка або панелі кантролю прадаўцы. Процэс ў всіх месцах схожы, хоць дэталі можа разлічыцца: трэба стварыць аблік, знайсці раздзіл з API або ключамі распрацоўшчыка, стварыць ключ і зберагчы яго ў безпечным месцы, адтаколькі большасць прадаўцоў паказвае цэлы ключ толькі адной раз.
У CowAgent ключ уводзіцца на экран налаштаванняў модэля, зазвычай пад раздзелам «Настройкі» або «Консоль». Канцэптуальна запіс выглядае як у прыкладзе ніжэй, хоць інтэрфейс ёсць графічным і няма можлівасці рэдагаваць файлы вручную:
provider: claude
api_key: sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Паколькі падтрымліваець можа працаваць паралельна, вы можэце пад’яжыць больш аднаго модэлю і выбраць, калькі з ягох будуць адпавядаць за адпаведзіць у чаце, калькі — за розумеўце адпраўленых зображэнняў, а калькі — для іншых цэлаў. Гэта стаўкаеся для прымітнага паўтарнага аналізу працы модэлю, або калі у вас вялікі запас крэдытавання у калькіх падтрымлівацяў і вы не хачаце, каб яны былі вымараны.
Чэтырты ўздзеў: пад’яжыце платформу для чатаў
Калі модэль пад’яжаны, асістэнт вядома можа весты дыялог, але справжняя корыста крыўцяцца з можлівасці доступу да яго праз дапытовы прыстаўку, а не праз спецыяльны інтэрфейс. Telegram, Discord і Slack всі следуюць аднаму патэрану, падобнаму да налаштавання модэлю: трэба стварыць токен API на той платформе, а потым увесты яго ў налаштаванні відпаведнага каналу ў CowAgent.
- Telegram: створыце бота празь чарговаг асістэнта Telegram – BotFather, які пасля кароткаг кансалтатавання ў Telegram выдае токэн бота.
- Discord: створыце прыемліванне ў портале распрацоўшчыкаў Discord, дадаце да яго бота, скопіюйце токэн бота, а пасля запрасіце бота ў сервер праз лінк запрасу з неабходнымі правамі.
- Slack: створыце прыемліванне на панелі керування Slack API, увялічыце неабходныя дыяпазоны дзеянняў бота і падпіску на запуск запаведзянняў, установіце прыемліванне ў рабочы прастор і скопіюйце отрыманы токэн бота.
Калі токен быў увведзены і канал увімкнуты, агент стае членам той платформы. Паведамленні, адправлены яму безпасяродна, або згаданы ў групе чы рэсурсе, прабіваюць да мовнага модэлю разам з усімі вядомасцямі і кантэкстам, якія ён збірае, а адпаведзь вяртаецца праз той самы канал. Для людзей, якія з ям размовляюць, немае відных разлікоў у параўнананні з размовай з людзкім кантактам чы звычным ботам, за выключэннем спосабу якім ён адпавядае.
Одна працюючая інстанцыя не обмежваецца адной платформай. Адны агент можа аддаўаць службы Telegram, Discord і Slack адночасна, дзеўячы адну вядомасць і адны модэль, таму няма прычыны копіюваць даныя для кожной платформы.
Што відбываецца за кулісамі
Калі прыходзіць паведамленне праз будзь-які канал, запускаецца той самы внутрэшні працэс. Сістэма інтэграцыі канала, якая яго прыме, абрабатвае тэкст, адпраўку чы ўсное заўважэнне. Гэты вхідны даны прабівае да основнага механізма аналізу агента, які запоўнюееся рэлевантнымі данымі з пакульшых размов, выявляе, чы трэба вікорыстоўваць інструменты (пошук у інтэрнэце, чытанне файла, запуск запланаванага задання), і стварае план адпаведзі. Прыўязаны мадэль пішае фактычную адпаведзь на аднойчынку з гэтым планам і кантэкстам, а адпаведзь прабываецца назад праз той самы канал, дзе пачалося паведамленне.
Самэ гэта цыкл яшчэ больш пераканвае, што агент — не проста чат-бот без стану, а актуальны асістэнт. Які бы тэмы вы не паклалі сёньдзе, і як бы вы да яе не звярнуліся наступнай недзе, ён працуе як людзкі асістэнт, які быў пры пакульшай розмове, і не трэба павтараць кожную дэталь.
Дадаванне навыкаў з Skill Hub
Пасуючы простым размовам, агент стае набагато корыстнейшым пасля установкі неабяжных навыкаў. Навык — гэта вышэйшы рэжым работы, на адзін крок ад простага інструмента, які аб’еднвае неабяжныя крокі для выпання конкрэтнай задачы, такой як вікорыстоўванне певнай зовнішней службы, автаматызацыя рэгулярных завадзяў чы обработка спецыялізаванага тыпу запітаў.
Навыкі можна пераглядаць і устанавляць з адкрытага рынку пад назвай Skill Hub, пры чым не трэба вводзіць коду. У інтэрфейсе чы за дапамогою короткага каманды вы шукаеце за ключавым словам і устанавляеце навык адразу ж адной дзеяннем:
/skill search calendar
/skill install calendar-assistant
Мадэль рынку значыць, што можлівасці не ўсталяваныя пад час інсталяцыі. Навыкі, публікуемыя спяльнай адукацыёй, або створаныя праз звычную размову з самым агентам, можна дадаць у будзь-які момент без перынсталявання прыкладнення. Людзі, які наладзілі яго для неформальных размов, могу дадаць навык за калькольнікі тыдні пазней для керавання календарэм, стварэння апусніка дакументаў або ведчы размову з конкрэтным API, так сама, як вы інсталявалі бы прыкладнення з магазіна.
Косц і адкрытасць
Дэсктопнае прыкладнення, фрэймворк агента і Skill Hub абоўшчы опісваюцца як безкоштовныя і з адкрытым кодам. Џыдзеньны косц — гэта толькі прадаўцу модэля языка, які вы падключаеце, таму што доступ да API такіх модэляў, як Claude, GPT, Gemini або DeepSeek, зазвычай выкладзіцца прадаўцам за прыменэнне, а не ўключаецца ў програмнае забезпечэння агента.
Такое раззявленне дапомагае пад час планавання бюджэту для персональнага або малага каманднага распаду. Для гэтага фрэймворка няма платы за абонамент чыста ліцэнзы, а вартасць выкарыстоўвання модэлю, якая ёсць едынай стаўкай, часта можа застацца нізкай чыста нават бесплатной, залежна ад прадаўцы і ад прызначанага крэдыту на прыбліжнае выкарыстоўванне чыста бесплатнага рывня, які ён зараз прысвячае. Адкрыты код таксама значыць, што весь кодавы базіс, уключаючы спосаб зберагання памяці, спосаб запуску інструментаў і спосаб перадачы паведамленняў межы каналаў і модэляў, можа быць адзірваны кожным, хто хоча пераканацца, калікі програма можа зрабіць, прытым як толькі пачнуць паверляць ёй рэальныя размовы, файлы чыста запланаваныя задачы.
Рэалістычны першы дзень
У сукупнасці першая сесія працюе так: запускаецеся завантажэнне і установка кліента для рабочага стола, пры неабяжнасці на Mac можа знадобіцца працаваць з папламою Gatekeeper. У прыемніку вводзіцца API-клуч ад выбранага прадаўца модэля, што дазволяе адбывацца рэальным дыялогам. Ствараецца токен бота для Telegram, Discord чыта Slack і ён падключаецца, чым агент стае доступным з тэлефона чыта прыемніка для чату, які ужо быў ачынены. Надсылаецца першыяе паведамленне боту, каб паўнастаяць, што усё налажана правільна. Пасля чаго з Skill Hub установляецца адна чыта две навыкі, якія будуць вікорыстоўваныя асістэнтам для ведучых задач — будзь то планаванне, аналіз, кераванне файламі чыта іншыя болей спецыялізаваныя задачы.
Усё гэта не займае многа часу, і для гэтага не трэба вокальных навыкаў, таму што як падключэнне да модэля, так і падключэнне да каналу заключаюцца у простам вставленні клуча чыта токена ў экран налашоўкаў, без неабяжнай правкі коду.
Што вы атрымуеце
Установка дапаможніка AI ў прыемнік чату, які вы ужо вжываеце, зменшае значную колькасць пераканстанняў у працэ, у пораўнанні з тым, калі яго застаўляюць у окрэмай вікніцы або панелі керування. Такая наладка не каштуе нічога для програмы, ухілваецца ад прыкрэплення да конкрэтнага модэлю і не выклікае складных тэхнічных задач, кроме завантажэння прыемніка і вставкі калякоў ключоў.
Калі ён будзе паўязаны з Telegram, Discord або Slack і будзе матыць хоць адні модэль для аналізу, у вас будзе стойкі дапаможнік, які памятае кантэкст, плануе багатоэтапныя задачы і становіцца ўсё бол спроможным па меры дадавання новых навыкаў, пры чым усё гэта працюе тыха на апаратнай частцы, якая ужо знаходзіцца на вашым столе.
Спаднія статыі
- Практычныя прыміткі: вашэму агенту для кодавання не трэба больш кантэксту. Йому трэба карта. — Практычныя прыміткі: вашэму агенту для кодавання не трэба больш кантэксту. Йому трэба карта: контракты, перакрыццяі і слоты для коду для команд, якія вікорыстоўваюць гэты патэрн.
- Практычныя прыміткі: GUI для базы дадзеных, якая таксама керуе тым, што дозволена вашаму агенту AI — Практычныя прыміткі: GUI для базы дадзеных, якая таксама керуе тым, што дозволена вашаму агенту AI: контракты, перакрыццяі і слоты для коду для команд, якія вікорыстоўваюць гэты патэрн.