Робота ШІ-агента всередині 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: створіть бота через офіційного асистента BotFather у Telegram, який після короткої настановної розмови надає токен бота.
- Discord: створіть додаток у порталі розробників Discord, додайте до нього бота, скопіюйте токен бота, а потім запросіть бота до сервера за допомогою посилання-запрошення з належними правами.
- Slack: створіть додаток на панелі керування API Slack, увімкніть необхідні діапазони дій бота та підписки на події, встановіть додаток у робочому просторі та скопіюйте отриманий токен бота.
Як тільки введено токен та увімкнено канал, агент стає учасником цієї платформи. Повідомлення, надіслані йому безпосередньо або згадані в групі чи сервері, надходять до мовної моделі разом із усією інформацією та контекстом, які вона зібрала, а відповідь повертається через той самий канал. Для людей, які з ним спілкуються, немає помітної різниці порівняно з розмовою з людиною чи звичайним ботом, окрім способу його відповідей.
Одна запущена інстанція не обмежується однією платформою. Один агент може одночасно обслуговувати Telegram, Discord та Slack, користуючись однією пам’яттю та однією моделлю, тому немає потреби копіювати дані для кожної платформи окремо.
Що відбувається за кулісами
Коли повідомлення надходить через будь-який канал, запускається той самий внутрішній процес. Інтеграція каналу, яка його отримала, бере текст, зображення чи голосову записку. Цей вхідний даний надходить до основного механізму міркувань агента, який запускає відповідні дані з попередніх розмов, вирішує, чи потрібні інструменти (пошук у Інтернеті, читання файлу, виконання запланованої задачі), та розробляє план відповіді. Підключений модель формує фактичну відповідь на основі цього плану та контексту, а відповідь надсилається назад через той самий канал, де почалося повідомлення.
Саме цей цикл пояснює, чому агент більше схожий на постійного асистента, а не на безстановий чат-бота. Якщо сьогодні підняти певну тему та згадати її наступного тижня, він буде діяти як людський асистент, який був присутній під час попередньої розмови, без необхідності повторювати кожну деталь.
Додавання навичок з Skill Hub
Після базового спілкування агент стає набагато кориснішим після встановлення необхідних навичок. Навичка – це більш складна схема роботи, на відміну від простого інструменту, яка об’єднує кроки, необхідні для виконання певної задачі, такої як використання певного зовнішнього сервісу, автоматизація регулярних обов’язків чи обробка спеціалізованих запитів.
Навички можна переглядати та встановлювати з відкритого ринку під назвою Skill Hub без необхідності використання коду. У інтерфейсі чи за допомогою короткого командного запиту ви шукаєте за ключовими словами та встановлюєте їх одним дією:
/skill search calendar
/skill install calendar-assistant
Модель ринку означає, що функціонал не є фіксованим під час встановлення. Навички, опубліковані спільнотою або створені під час звичайного спілкування з самим агентом, можна додати в будь-який момент без необхідності повторного встановлення додатку. Людина, яка налаштувала його для неформальних розмов, може через кілька тижнів додати навичку для керування календарем, стиснення документів чи взаємодії з певним API, так само, як ви встановлюєте додаток з магазину.
Вартість та відкритість
Десктопний додаток, фреймворк агента та Skill Hub описуються як безкоштовні та з відкритим кодом. Єдиним постійним витратою є постачальник мовної моделі, до якого ви під’єднуєтесь, оскільки доступ до моделей на кшталт Claude, GPT, Gemini чи DeepSeek через API зазвичай оплачується постачальником залежно від обсягу використання, а не включається до складу програмного забезпечення агента.
Це розрізнення допомагає під час складання бюджету для особистого використання чи невеликої команди. Для цієї платформи немає плати за підписку чи ліцензію, а витрати на використання моделі, які є єдиними, часто можна зменшити або навіть зробити безкоштовними, залежно від постачальника та пробного кредиту чи безкоштовного тарифу, які він пропонує наразі. Відкритий код також означає, що будь-хто може переглянути весь кодовий базис, включаючи спосіб зберігання пам’яті, функціонування інструментів та механізм передачі повідомлень між каналами та моделями, щоб переконатися, як працює програмне забезпечення, перш ніж довірити йому справжні розмови, файли чи заплановані завдання.
Реалістичний перший день
У сукупності перша сесія відбувається ось так. Скачайте та встановіть клієнт для робочого столу; на Mac, за потреби, доведеться коротко пройти процедуру перевірки Gatekeeper. У додатку введіть API-ключ від вашого обраного постачальника моделей, що дозволить вести справжню розмову. Створіть токен бота для Telegram, Discord або Slack та під’єднайте його, щоб агент став доступним через додаток для чату на телефоні чи робочому столі, який вже був відкритий. Надішліть боту перше повідомлення, щоб підтвердити, що все налаштовано правильно. Потім завантажте одну-дві функції з Skill Hub для виконання основних завдань асистента — чи то планування, пошук інформації, робота з файлами чи щось більш специфічне.
Усе це не займає багато часу, і для цього не потрібні навички програмування, адже як підключення до моделі, так і до каналу полягають у простому вставленні ключа чи токена у екран налаштувань, без необхідності редагування коду.
Що ви отримуєте в кінцевому підсумку
Використання ШІ-асистента у чат-додатку, який ви вже використовуєте, значно зменшує кількість перешкод порівняно з його розміщенням у окремій вкладці чи панелі керування. Така налаштовка не коштує нічого для програмного забезпечення, уникає залежності від конкретної моделі та не вимагає складної технічної роботи, окрім завантаження додатку та вставки кількох ключів.
Як тільки він під’єднаний до Telegram, Discord чи Slack та має принаймні одну модель для обробки інформації, у вас з’являється постійний асистент, який пам’ятає контекст, планує багатоетапні завдання та стає все більш здатним з додаванням нових навичок, причому все це працює тихо на обладнанні, яке вже знаходиться у вашому робочому столі.
Пов’язані матеріали
- Практичні нотатки: вашому кодувальному агенту не потрібен більше контексту. Йому потрібна карта. — Покрокове керівництво з Практичних нотаток: вашому кодувальному агенту не потрібен більше контексту. Йому потрібна карта: контракти, перевірки та слоти для вставки коду для команд, які використовують цю схему.
- Практичні нотатки: GUI для бази даних, який також визначає, що дозволено вашому AI-агенту — Покрокове керівництво з Практичних нотаток: GUI для бази даних, який також визначає, що дозволено вашому AI-агенту: контракти, перевірки та слоти для вставки коду для команд, які використовують цю схему.