Боты — это Telegram-боты, через которые Pastukhov Agent общается с вами (или вашими сотрудниками) прямо в Telegram. Можно завести любое количество ботов: например, один для ежедневных отчётов, второй — для вопросов по проекту, третий — для команды. У каждого бота своя модель, свой навык, свой системный промпт и свой набор разрешённых пользователей.
Боты управляются из интерфейса — кнопка «Боты» в верхней панели: создание, включение/выключение, перезапуск и перенаправление чата в один клик, без правки файлов. Конфигурация хранится в .pastukhov/bots.yml.
Зачем нужен свой бот
Бот — это самый простой способ дать людям работать с ИИ-агентом: не нужно открывать веб-интерфейс, вводить логин и пароль, разбираться в настройках. Сотрудник просто открывает чат с ботом в Telegram и пишет задачу обычными словами. Что это даёт:
- Несколько ботов под разные задачи — одному боту доверены отчёты, другому — код, третьему — работа с клиентами. У каждого своя модель, навык и правила;
- Ограничение доступа — можно указать, кому именно бот отвечает (по Telegram ID или имени пользователя);
- Без веб-интерфейса — общение через знакомый мессенджер, на телефоне и на компьютере;
- Продолжение диалога — бот помнит текущий чат с агентом: можно уточнить, попросить переделать или задать следующий вопрос — контекст сохраняется;
- Уведомления от задач — бот доставляет результаты автоматических задач (см. Задачи).
Как настроить бота
Откройте диалог «Боты» в верхней панели и нажмите «Создать». Что настраивается:
- Токен бота — выданный у
@BotFather(поддерживается подстановка переменной окружения через$, например$TELEGRAM_BOT_TOKEN); - Название — например, «Отчёты» или «Помощник команды»;
- Модель — из ваших моделей, та же модель ИИ, что и в чатах;
- Навык — навык, который бот загрузит в начале работы (например, навык отчётов или навык поддержки);
- Системный промпт — правила поведения бота: кому адресован, в каком стиле отвечать, какие задачи решать;
- Разрешённые пользователи — Telegram ID, которым бот отвечает. Важно: пока список пуст, бот никому не отвечает — он пришлёт «доступ не настроен», пока вы не добавите хотя бы свой ID;
- Показ деталей — показывать ли вызовы инструментов и размышления модели (для прозрачности) или прятать (для простоты);
- Веб-ссылка — адрес веб-интерфейса, который бот присылает, когда нужно открыть чат подробнее.
Токен задаётся один раз, в списках он показывается замаскированным. Смена модели или токена применяется при следующем перезапуске бота — в интерфейсе есть кнопка перезапуска; остальные настройки (промпт, навык, список пользователей, показ деталей) вступают в силу сразу.
Как пользоваться ботом
В Telegram у бота есть три команды:
/start— показать справку и назначение бота;/new— начать новый чат (сбросить текущий разговор);/commit [сообщение]— закоммитить и отправить изменения проекта (когда бот работает с кодом).
Любое сообщение без команды — это задача для агента: бот отправляет его в чат Pastukhov Agent, агент выполняет работу, а ответ возвращается боту. Первое сообщение в новом чате дополняется системным промптом и навыком бота автоматически.
Бот получает обновления через long polling (долгое опрашивание) — ему не нужен публичный веб-адрес и не нужны открытые порты; соединение идёт из сервера агента к Telegram.
Боты и задачи: готовые сценарии
Бот и задача работают вместе так: задача запускается (по расписанию или по триггеру), скрипт собирает данные, ИИ пишет анализ — и свежий чат задачи автоматически привязывается к вашему боту. Вы получаете результат в Telegram и можете продолжить диалог: спросить подробности, попросить изменить отчёт, поручить следующее действие.
- Утренний дайджест — бот «Отчёты», задача «ежедневно в 09:00 собрать метрики и написать сводку»: получили сводку утром, уточнили вечером «что было с заказами после обеда?»;
- Аварийный сигнал — задача мониторит сайт с триггером «ERROR»: при сбое бот присылает разбор ошибки, и можно прямо там отдать команду «исправь и закоммить»;
- Ночной прогон тестов — задача запускает тесты ночью, при падении ИИ разбирает лог и присылает через бота понятный отчёт с рекомендациями;
- Резервное копирование — задача делает бэкап и молчит, пока всё хорошо; при ошибке будит бота — только в этом случае ИИ пишет, что пошло не так;
- Сборка после деплоя — после развёртывания задача проверяет здоровье приложения и всегда присылает результат боту команды.
Ключевая идея: задача собирает данные и запускает ИИ, бот доставляет результат и позволяет вести диалог. Вместе они превращают агента из инструмента «открыл окно с чатом» в помощника, который сам приходит к вам с готовой работой.
Файл конфигурации
Все боты хранятся в .pastukhov/bots.yml — в том же формате YAML, что и остальная конфигурация проекта. Файл версионируется в Git, поэтому набор ботов переносится между серверами вместе с проектом. Токены при желании можно вынести в переменные окружения синтаксисом $ИМЯ_ПЕРЕМЕННОЙ, чтобы не хранить секреты в репозитории.
Дальше
Чтобы бот присылал результаты автоматических сценариев, настройте связку с задачами — см. Задачи. Выбор моделей для ботов — на странице Модели.