- BrainTools - https://www.braintools.ru -

ИИ-агенты 101: Как за 20 минут собрать своего первого Telegram-бота

Всем привет! 🚀 Я начинаю цикл статей для тех, кто только делает первые шаги в мир ИИ-агентов. Будем разбирать всё максимально просто и наглядно. Если что-то окажется непонятным или вдруг не заработает — смело пишите в комментариях, разберёмся вместе.

Сегодня мы соберём своего первого помощника — Telegram-бота, который с помощью LLM будет отвечать на ваши сообщения.

Ингредиенты

  1. Make.com – no-code / low-code платформа для автоматизации процессов. Аналог популярного n8n, но, по-моему, попонятнее и попроще для новичков, есть бесплатный тариф, много готовых интеграций с внешними сервисами. В целом, все то же самое можно сделать в n8n.

  2. OpenRouter – платформа, через которую можно получить доступ по API к любой популярной LLM, часто по ценам ниже, чем напрямую по вендора. Есть бесплатные tier (например, Grok 4-fast сейчас там бесплатный с некоторыми условиями)

  3. Telegram

Пошаговая инструкция

  1. Вначале создадим бота в Telegram. Для этого найдем Telegram’e специального бота @BotFather и отправим ему команду /newbot .

  2. Он предложит придумать ему имя. Имя должно быть уникальным и в конце содержать суффикс “_bot”. В ответ вы получите токен для работы с этим ботом.

    ИИ-агенты 101: Как за 20 минут собрать своего первого Telegram-бота - 1
  3. Класс! Токен есть, полдела сделано.

  4. Создаем аккаунт на make.com, заходим, нажимаем “Create scenario”.

    ИИ-агенты 101: Как за 20 минут собрать своего первого Telegram-бота - 2

    Смысл: при помощи make.com мы можем настроить сценарий обработки входящих сообщений. То есть мы можем настроить – прием входящих сообщений из Telegram’a, обработку через LLM, и отправку в ответ.

  5. Нажимаем плюс и создаем первый шаг на диаграмме, пишем в поиске Telegram. Внутри Telegram bot ищем модуль “Watch updates“. Вот его и выбираем.

    ИИ-агенты 101: Как за 20 минут собрать своего первого Telegram-бота - 3
  6. В появившемся окне нам предложат выбрать “Web hook” – нажимаем Add, дальше предложат выбрать “Connection” – нажимаем Add. В появившемся окне вводим наш токен от бота. Нажимаем везде “Save“.

    Внимание! Если быстро нажимать Save последовательно в двух окнах, он может поругаться "Validation failed". Просто подождите и нажмите еще раз.

    Внимание [1]! Если быстро нажимать Save последовательно в двух окнах, он может поругаться “Validation failed”. Просто подождите и нажмите еще раз.

    Смысл: Web hook – это способ сообщить Telegram’у, что обо всех новых сообщениях вот этому боту необходимо уведомлять ваш сценарий в Make.com.

  7. Супер! Вы уже подключили своего бота к сценариям Make.com. Давайте сделаем так, чтобы на все входящие сообщения бот вам отвечал приветствием. Для этого добавьте еще один модуль на диаграмму (Telegram->Send message). В настройках этого модуля надо обязательно указать “Chat ID” (куда отправлять) и “Message” (само сообщение). Chat ID мы возьмем из входящего сообщения юзера, а сообщение сгенерируем сами.

    Кстати, чтобы было проще ориентироваться в структуре данных, можно отправить сообщение в боту в телеге, нажать в Make.com “Run once” , и вы увидите данные из этого сообщения. Тогда Chat ID будет полегче идентифицировать.

    ИИ-агенты 101: Как за 20 минут собрать своего первого Telegram-бота - 5
  8. Ну все, супер! Теперь на любое наше сообщение бот будет нам писать “Привет!”.

    ИИ-агенты 101: Как за 20 минут собрать своего первого Telegram-бота - 6
  9. Теперь давайте добавим нашему боту немного интеллекта [2], подключив OpenRouter. Для этого создаем aккаунт на openrouter.com, в настройках создаем себе API ключ.

  10. Добавляем новый блок на make.com между Получением сообщений и Отправкой сообщений (Open Router -> Create a chat Completion). Он также попросит создать “Connection”. Создаем (выбираем простое подключение, не OAuth), вводим свой ключ, сохраняем.

    ИИ-агенты 101: Как за 20 минут собрать своего первого Telegram-бота - 7
  11. Теперь самое важное. Надо настроить промт, который мы отправим в OpenRouter.
    Мы отправим два сообщения: системное сообщение с указаниями для бота, а во втором сообщении мы отправим сообщение нашего пользователя. В качестве модели я выбираю GPT-5, можно выбрать grok-4-fast – он есть в бесплатном доступе (при условии, что вы готовы делиться своим контентом с open router для обучения [3] моделей), но я обратил внимание, что у него как-то не очень со стихами :).

    ИИ-агенты 101: Как за 20 минут собрать своего первого Telegram-бота - 8
  12. Теперь в нашем блоке с отправкой сообщения в Telegram заменяем наш “Привет!” на ответ из OpenRouter (если вы разочек прогоните скрипт через Run Once, то будет проще найти этот ответ в дереве).

    Обратите внимание, что OpenRouter устроен так, что может возвращать несколько сообщений. Поэтому нам надо указать номер сообщения для отправки в Telegram. В нашем случае мы ожидаем только одно сообщение, и вот его номер (1) надо указать в настройках блока.

    ИИ-агенты 101: Как за 20 минут собрать своего первого Telegram-бота - 9
  13. Все готово! Сохраняем сценарий (Ctrl+S или CMD+S), выходим из него, делаем его активным.

    ИИ-агенты 101: Как за 20 минут собрать своего первого Telegram-бота - 10

Наш бот-поэт готов @agentforce_creative_bot.

На запрос пользователя бот генерирует стихотворение из 4-х строк в стиле Пушкина.

На запрос пользователя бот генерирует стихотворение из 4-х строк в стиле Пушкина.

Это очень простая задача, но демонстрирует основную силу LLM и путь для создания агентов – мы можем запрограммировать бота естественным языком.

Например, можете в системном промте написать: “Если пользователь просит стихи в стиле другого поэта, но пиши в стиле этого поэта, в противном случае в стиле Пушкина”.

Напишите, если статья оказалась полезной. Также можете подписаться на мой телеграм канал, где я рассказываю о своих экспериментах с ИИ агентами: @agent_force [4]

Если будет интерес [5], то в следующих статьях можем поговорить о следующих темах:

  1. Как подключить боту память [6], чтобы можно было вести полноценный диалог

  2. Как подключить больше инструментов, так чтобы бот стал полноценным ИИ-агентом

  3. Как добавить внешнюю базу знаний (RAG)

  4. Как развернуть ИИ-агента в своей инфраструктуре

  5. Как улучшить точность агента в узкой задаче (Fine tuning)

Автор: k347905

Источник [7]


Сайт-источник BrainTools: https://www.braintools.ru

Путь до страницы источника: https://www.braintools.ru/article/20062

URLs in this post:

[1] Внимание: http://www.braintools.ru/article/7595

[2] интеллекта: http://www.braintools.ru/article/7605

[3] обучения: http://www.braintools.ru/article/5125

[4] @agent_force: https://t.me/agent_force

[5] интерес: http://www.braintools.ru/article/4220

[6] память: http://www.braintools.ru/article/4140

[7] Источник: https://habr.com/ru/articles/951668/?utm_source=habrahabr&utm_medium=rss&utm_campaign=951668

www.BrainTools.ru

Rambler's Top100