Работа по разделам

Пошаговый маршрут: Canvas -> System -> Settings -> Test Canvas, AI, System, Settings

Работа по разделам

Пошаговый маршрут: Canvas -> System -> Settings -> Test

Работа по разделам

Ниже показано, как данные двигаются внутри сервиса. Схема простая: она объясняет, почему часть данных видна в базе Supabase постоянно, а другая часть существует только в момент работы бота.

1. 1. Canvas: соберите логику

Добавьте ноды, соедините ветки и задайте базовые ответы/переходы.

Результат

Черновая схема сценария на холсте.

2. 2. System: задайте общие правила

Настройте переменные, клавиатуру, триггеры и системные переключатели.

Результат

Глобальные правила поведения бота.

3. 3. Settings: проверьте подключение

Проверьте токен, режим запуска и параметры бота, затем сохраните изменения.

Результат

Готовая конфигурация для запуска теста.

4. 4. Test и логи: проверка в реальном потоке

Запустите тест, отправьте сообщения в Telegram и проверьте путь выполнения по логам.

Результат

Подтверждённая рабочая ветка сценария.

5. 5. Итерация: точечные правки

Исправьте конкретные узлы по логам и повторите цикл Save -> Test.

Результат

Стабильный сценарий для дальнейшего развития.

Разделы редактора

Canvas, AI, System, Settings

Разделы редактора (где что делать)

Интерфейс разделен на зоны: Canvas (сборка сценария), AI, System (системные функции) и Settings (настройки Telegram). Это сделано для того, чтобы всё лежало на своих местах и не путалось.

Canvas (Холст)

Визуальная сборка workflow

Когда использовать: Когда вы проектируете логику диалога, ветвления, действия и последовательность шагов.

Добавление нод из палитры (по категориям).
Соединение нод связями.
Выбор ноды и открытие настроек.
Copy / Cut / Paste нод (Cmd/Ctrl + C/X/V).
Запуск теста и просмотр логов.
Сохранение изменений перед тестом (Save -> Test).
Проверка связей, чтобы не оставлять “висящие” ноды без выхода.

Результат

Рабочая схема поведения бота (workflow).

AI Assistant

Помощник для сборки и подсказок

Когда использовать: Когда нужно быстро набросать сценарий, получить идею или объяснение логики.

Формулируете задачу простым текстом.
Получаете предложения по структуре или нодам.
Используете ответ как основу, затем проверяете руками в Canvas.
Уточняете сценарий пошагово: сначала входы, затем ветки, потом обработка ошибок.
Переносите итоговые решения в конкретные ноды и параметры вручную.

Результат

Ускорение проектирования, но итоговую логику всё равно проверяете вы.

System (Система)

Логика окружения бота

Когда использовать: Когда настраиваете переменные, триггеры, базовые Telegram-функции, reply keyboard, авто-реакции.

Создание пользовательских переменных.
Просмотр базовых Telegram переменных (user.*).
Настройка reply keyboard (под input).
Настройка авто-реакций и доп. функций.
Создание вариантов reply keyboard и правил переключения по условию.
Проверка триггеров и сопоставление с реальными событиями (text vs callback).
Описание переменных, чтобы команда понимала, где и зачем они используются.

Результат

Системная конфигурация, на которую опирается workflow.

Settings (Настройки)

Конфигурация бота и Telegram

Когда использовать: Когда подключаете токен, проверяете параметры запуска и общие параметры бота.

Ввод/обновление Telegram token.
Проверка параметров запуска.
Проверка статуса и параметров деплоя.
Проверка webhook/polling режима перед запуском теста.
Изменение профиля бота (имя/описание) и синхронизация с Telegram API.
Проверка, что секреты сохранены и не отображаются в открытом виде.

Результат

Бот готов к тесту и запуску с корректными внешними настройками.

Компоненты интерфейса

Ключевые панели и как с ними работать

Компоненты интерфейса редактора и как с ними работать

В этом разделе описаны главные элементы редактора (кроме самих нод): где их найти, зачем они нужны и как с ними работать.

Панель разделов (слева)

Левая колонка редактора: Canvas / AI Assistant / System / Settings. - Переключение между режимами работы редактора.

Кликайте по иконкам/разделам для смены режима.
Тяните вертикальный разделитель, чтобы менять ширину панели.
Двойной клик по разделителю сбрасывает ширину к дефолтной.
Ширина панели сохраняется в localStorage и восстанавливается при следующем входе.

Частые ошибки

Пытаются искать ноды в System — ноды добавляются только на Canvas.
Сужают панель слишком сильно и думают, что разделы пропали — они просто в compact/hidden режиме.

Палитра нод (на Canvas)

Верхний левый угол холста. - Добавление нод и пресетов в workflow.

Наведение на иконку категории показывает список нод справа.
Клик по категории закрепляет её (pin).
Клик по ноде добавляет её на холст; drag-and-drop тоже работает.
Следите за счётчиками нод и связей внизу палитры.

Частые ошибки

Путают пресет (Text Trigger) с отдельным новым типом ноды — это preset существующей trigger ноды.

Панель настроек ноды

Справа при выборе ноды на Canvas. - Редактирование параметров выбранной ноды.

Выберите ноду на холсте — справа откроются её параметры.
Для сложных нод используйте детальный режим (иконка раскрытия): настройки откроются по центру экрана.
В детальном режиме фон блокируется, чтобы вы не сбились с контекста редактирования.
Проверяйте поля с переменными через подсказки {{ и список переменных.

Частые ошибки

Редактируют не ту ноду — сначала проверьте ID/название в шапке панели.
Ищут runtime-значения в настройках ноды — здесь хранится конфигурация, а не текущее состояние выполнения.

Встроенные подсказки `?`

Рядом с заголовками блоков и важными полями в Canvas / System / Settings. - Быстро объяснить, что делает параметр и как его настроить.

Нажмите ? возле нужного элемента.
Прочитайте краткое описание и пошаговый мини-гайд.
При необходимости откройте полную документацию кнопкой в модальном окне.

Частые ошибки

Пропускают мини-гайды и начинают настраивать сложные параметры “наугад”, что увеличивает время отладки.

Панель логов бота

Нижняя панель на Canvas. - Диагностика поведения workflow во время теста.

Открывайте панель после запуска Test.
Смотрите последовательность событий: входящее сообщение -> выбранный триггер -> ноды -> ошибки/ответы.
Копируйте логи в Text или JSON, если нужно разобрать поведение или отправить в поддержку.

Частые ошибки

Ожидают новые логи без активного теста.
Путают UI-ошибку с runtime-ошибкой — в логах обычно видно источник (runtime, polling, action).

System-панели (Variables / Triggers / Reply Keyboard)

Раздел System. - Управление переменными и системным поведением бота вне конкретной ноды.

Создавайте пользовательские переменные для повторного использования в workflow.
Используйте Reply Keyboard для постоянной клавиатуры под input (глобальной для шагов).
Используйте rules в Reply Keyboard, если хотите разные кнопки по условию/переменной.
Используйте Text Trigger для обработки нажатий reply-кнопок (они отправляют обычный текст).

Частые ошибки

Пытаются ловить reply keyboard через Callback Trigger — это работает только для inline кнопок.

Bot Settings (Telegram token, режимы)

Раздел Settings. - Подключение бота к Telegram и управление режимами запуска.

Заполняйте токен и нужные параметры запуска.
Пустое поле токена при сохранении не должно автоматически очищать уже сохранённый токен (это безопасное поведение).
После изменения параметров всегда делайте Save, затем Test.

Частые ошибки

Меняют настройки и сразу нажимают Test, не сохранив изменения.
Ожидают, что секреты будут видны в открытом виде в UI/БД — они хранятся отдельно и защищены.

Навигация по документации

Переходите по страницам по порядку, как по учебному маршруту.

Быстрый старт Ноды и пресеты