Как показать работу AI-агента в Telegram: статусы инструментов, анимации и кнопка Stop
Коротко
- Без обновлений временный черновик исчезает примерно через 30 секунд, поэтому для долгих операций нужен периодический refresh.
- Динамический текст статусов нужно экранировать перед вставкой в HTML: поисковые запросы и заголовки страниц могут содержать символы разметки.
- Для анимации
Telegram рекомендует набор custom emoji AIActions; если бот не может отправлять custom emoji, можно оставить обычные текстовые статусы.
Для этого используется sendRichMessageDraft и блок 
PubMag писал о появлении Rich Messages в Telegram Bot API 10.1.
Готовый результат нужно отправлять отдельным сообщением через sendRichMessage: блок
Автор отдельно обращает внимание на гонки при отмене: позднее событие Stop не должно остановить уже новый запрос пользователя, а завершившийся после отмены инструмент не должен снова обновить старый черновик или отправить финальный ответ. Поэтому запуск привязывается не только к чату, но и к конкретному draft_id.
FAQ
Что произойдёт, если инструмент не поддерживает отмену?
Он может завершить уже начатую операцию даже после Stop. При этом приложение должно не допустить новых обновлений черновика или отправки результата отменённого запуска.
Можно ли использовать sendRichMessageDraft в любом чате?
В описанном примере метод работает в личном чате с ботом.
Читайте также
Telegram Bot API 10.1: революция форматирования- Как ЮMoney учит ИИ отвечать на вопросы к базе данных и проверять собственные ошибки
- Claude 3.5 Sonnet как AI-агент: тест в цикле с реальным исполнением кода
- Rich Messages в Telegram-ботах: сложные сообщения, черновики и ограничения
- Четыре проекта на Kwork, которые автор отклонил, и почему
- Отображение состояния AI-агента через Telegram Rich Message Draft: Для длительных агентных операций Telegram позволяет использовать временный Rich Message Draft с блоком <tg-thinking>, содержимое которого приложение обновляет по мере выполнения инструментов. Такой статус можно строить из событий самого приложения без раскрытия внутренних рассуждений модели.
[Telegram Bot API]
Зарегистрированные пользователи видят только два тезиса.
Зарегистрироваться
ХабрTelegramAI-агентыAgentic AItelegram-botsconversational-uitelegram-bot-api
Telegram позволяет показывать ход работы AI-агента прямо в чате: бот может обновлять временный блок состояния по мере выполнения инструментов, добавлять анимированные иконки и давать пользователю встроенную кнопку Stop.