21 июля 2026

Как собрать AI-агента для Telegram за 15 минут

От создания бота в BotFather до рабочего сценария с LLM-агентом, базой знаний и меню кнопок. Пошаговая инструкция без кода.

Шаг 1. Создайте бота в BotFather

Откройте @BotFather в Telegram, отправьте команду /newbot. BotFather попросит имя бота — это то, что увидят клиенты. Затем username — должен заканчиваться на bot (например, my_shop_support_bot).

BotFather вернёт токен — длинную строку вида 78423...:AAH...xJq. Скопируйте его, он понадобится на следующем шаге. Токен можно отозвать и перевыпустить в любой момент через /revoke.

Совет: сразу задайте описание через /setdescription и аватар через /setuserpic — это делает бота живым.

Шаг 2. Создайте агента в iisy

Откройте my.iisy.ru, нажмите «Новый агент». Придумайте название и описание — описание видно только вам, но помогает не запутаться, когда агентов несколько.

Агент — это рабочее пространство: в нём живёт граф сценария, ресурсы (LLM-профили, базы знаний, внешние запросы), каналы и аналитика. Один агент = один бот = один сценарий.

Шаг 3. Соберите граф

Откройте вкладку «Граф». Вы увидите холст с одним слотом — Start. Это точка входа, сюда попадает каждое сообщение клиента.

Добавьте слоты в таком порядке:

1. Text — «Здравствуйте! Я помогу с вопросами по заказу. Напишите, что вас интересует.»
2. Wait — бот ждёт ответ клиента
3. Agent — LLM-слот с промптом «Ты ассистент магазина. Отвечай кратко, по делу. Если не знаешь ответ — предложи связаться с оператором.»
4. Text — «Чем ещё могу помочь?»
5. Wait — клиент может задать следующий вопрос

Соедините слоты стрелками: Start → Text → Wait → Agent → Text → Wait. Это простой сценарий, но он уже живой: бот отвечает на любой вопрос через нейросеть.

Шаг 4. Подключите LLM-профиль

Откройте вкладку «Ресурсы» → LLM-профили. Создайте профиль: выберите провайдера (Grok или OpenAI), модель (для начала — GPT-4o-mini, быстрая и дешёвая), режим API-ключа. Если у вас свой ключ — вставьте, если нет — используйте платформенный.

Вернитесь в граф, откройте Agent-слот и выберите созданный профиль. Теперь Agent знает, через какую модель отвечать.

Шаг 5. Подключите Telegram

Откройте вкладку «Каналы» → Telegram → «Подключить». Вставьте токен, который вы получили от BotFather на шаге 1. iisy проверит токен и подключит бота.

Вебхук регистрируется автоматически — не нужно настраивать сервер или SSL. Бот сразу начинает принимать сообщения.

Шаг 6. Train и проверка

Перед публикацией — нажмите Train. Это фиксирует текущий граф как рабочую версию. Каналы работают по trained-конфигу, а не по черновику.

Откройте дебаг-виджет прямо в редакторе и протестируйте диалог. Напишите «хочу узнать про доставку» — бот должен ответить через Agent-слот. Напишите «спасибо» — бот должен предложить ещё помощь.

Если что-то не так — правьте граф, нажмите Train снова. Каналы не прерываются: старая версия работает, пока вы не опубликуете новую.

Что дальше

Базовый сценарий готов. Дальше можно:

— Добавить кнопочное меню вместо свободного ввода — клиент выбирает тему из 3-4 вариантов
— Загрузить базу знаний (PDF, Word, текст) — Agent будет искать ответы в ваших документах
— Подключить внешний запрос — бот проверит статус заказа через ваш API
— Добавить голосовые — бот будет распознавать голосовые сообщения через Whisper
— Подключить виджет сайта — тот же сценарий будет работать на вашем сайте

Один граф — все каналы. Изменения в графе применяются одновременно в Telegram, виджете и MAX.