Как добавить ИИ-ответ в сценарий

Пошагово

1. Откройте нужный сценарий: «Сценарии» в боковом меню, затем нажмите на название.
2. На холсте нажмите «+» (или перетащите из панели блоков) и выберите «AI Ответ» (фиолетовый блок с иконкой искры).
3. Соедините ноду входящей связью с предыдущим шагом.
4. Кликните по ноде - справа откроется панель настроек.
5. В поле «Системный промпт» опишите роль и правила. Пример: «Ты - вежливый ассистент поддержки бренда. Отвечай кратко и по делу, не выдумывай цены».
6. Переключатель «Память и база знаний (RAG)» оставьте включенным - ИИ будет отвечать по вашим данным и истории чата.
7. В блоке «База продуктов» выберите «Все продукты» или «Выбранные» (если нужно ограничить контекст конкретными товарами).
8. В блоке «Модель ИИ» выберите нужную из четырех плиток (по умолчанию - «2.5 Flash-Lite»).
9. При необходимости настройте «Температуру» (ползунок), «Длину ответа» и «Контекст».
10. Соедините выход ноды со следующим шагом и опубликуйте сценарий кнопкой «Опубликовать».

Что означают поля

• Системный промпт - постоянная инструкция для ИИ: роль, тон, правила. Обязателен для осмысленных ответов. Поддерживает переменные вида {{имя}}. Не вписывайте сюда цены и факты - для этого есть «База знаний», а цены, тарифы и артикулы ведутся в «Продукты».
• Память и база знаний (RAG) - включено по умолчанию. При включенном тумблере ИИ видит вашу базу знаний, историю чата и профиль контакта. Отключите только если нужен «чистый» ИИ без ваших данных.
• База продуктов: «Все продукты» / «Выбранные» - какие карточки из «Памяти продукта» подмешивать в ответ. «Выбранные» позволяет ограничить контекст конкретными товарами.
• Модель ИИ - четыре варианта (от дешевой к дорогой): 2.5 Flash-Lite, 2.5 Flash, 3.1 Flash-Lite, 3.5 Flash. В панели показывает примерный расход на ответ в токенах.
• Температура - ползунок от 0 до 1 (по умолчанию 0.7). Левее - строже и предсказуемее, правее - разнообразнее. Для поддержки рекомендуется 0.3-0.7.
• Длина ответа - максимум токенов на один ответ (по умолчанию 500 в панели, максимум 4096).
• Контекст - сколько последних сообщений диалога передавать модели (по умолчанию 10, от 1 до 50).

Что ИИ «видит» в каждом запросе

Модель получает следующее по порядку: постоянные инструкции воркспейса (из «Персонализации AI»), примеры ответов (few-shot), стиль общения (Tone of Voice), база знаний о продукте и профиль контакта, системный промпт ноды, последнее сообщение пользователя, история последних N сообщений чата. Пока ИИ готовит ответ, бот отправляет в Telegram статус «печатает...» - пользователь видит, что бот работает, а не завис. Если основная модель вернула пустой ответ или недоступна, система автоматически повторяет запрос на резервной модели - для вас это незаметно, пользователь получает обычный ответ.

Что ставить до и после ноды

До: триггер «Новое сообщение», «Задержка», «Ожидание ответа» или «Условие». Главное - сценарий должен работать в Telegram-канале с ботом, подключенным напрямую по токену. После: «Ожидание ответа» (чтобы дождаться реакции), «Задержку», «Условие» или завершение. У ноды один выход - ответвлений «да/нет» нет. Если нужно ветвление по смыслу ответа - ставьте «AI-условие».

Если не получается

• Бот вообще не отвечает в этой ноде. Проверьте: исчерпан ли месячный бюджет токенов (шапка бокового меню) и подключен ли бот именно по токену Telegram (не иным способом).
• В чат пришло [AI Error] .... ИИ не смог сформировать ответ. Проверьте, не пустой ли системный промпт, и посмотрите текст ошибки в скобках - там есть подсказка.
• Ответы не приходят именно после ноды «Ожидание ответа». Это известная особенность связки «Ожидание ответа» - «AI Ответ». Временно перестройте цепочку: убедитесь, что нода «Ожидание ответа» не стоит прямо перед «AI Ответ», или обратитесь в поддержку.
• ИИ отвечает в общем, не зная о вашем продукте или ценах. Включите тумблер «Память и база знаний (RAG)» и убедитесь, что база знаний заполнена в «Памяти продукта».
• Нельзя выбрать «умную» модель - стоит замок. Эта модель доступна только на тарифе выше, чем у вас сейчас.
• Ответы слишком короткие или обрываются. Увеличьте «Длину ответа»; если ответы однотипные - поднимите «Температуру», если хаотичные - снизьте.

Лимиты и тариф

• Нода «AI Ответ» доступна на всех тарифах, включая Free.
• На Free доступна только модель «2.5 Flash-Lite». Модели «2.5 Flash», «3.1 Flash-Lite», «3.5 Flash» открываются на Pro, Business, Enterprise.
• Каждый ответ расходует месячный бюджет токенов проекта. При исчерпании бюджета бот перестает отвечать через эту ноду до начала следующего месяца или повышения тарифа.
• Максимальная длина ответа - 4096 токенов; максимальный контекст - 50 сообщений.
• Нода работает только с Telegram-ботом, подключенным напрямую по токену.