Работа с ИИ помощником

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

Как открыть ИИ помощника

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

Режим планирования

Что это: Режим диалога, в котором ИИ помогает вам продумать бизнес-логику бота через вопросы и ответы.

Когда использовать:

• Когда вы только начинаете создавать бота и не уверены в структуре

• Когда нужна помощь в проработке бизнес-логики

• Когда хотите получить экспертные рекомендации по построению сценария

Как работает:

1. Диалог с помощником:

   • Опишите своими словами, что должен делать бот

   • ИИ задаст вам уточняющие вопросы

2. Примеры вопросов от ИИ:

   - "Расскажите подробнее о вашей целевой аудитории?"
   - "Какие данные о клиенте вам нужно собрать?"
   - "Нужна ли интеграция с CRM или другими системами?"
   - "Как должен бот реагировать на разные типы ответов?"

3. Создание плана:

   • Когда ИИ соберёт достаточно информации, он создаст структурированный план сценария

   • План включает:

     • Описание всех узлов

     • Логику переходов

     • Примеры сообщений

     • Рекомендации по переменным

4. Применение плана:

   • План отобразится в чате с кнопкой "Применить план"

   

   • При нажатии на кнопку:

     • Вы автоматически переключитесь в Режим создания

     • ИИ начнёт генерировать сценарий на основе плана

     • Сгенерированный сценарий автоматически загрузится в редактор

Пример диалога:

Вы: Нужен бот для сбора заявок на консультацию
ИИ: Расскажите подробнее о вашей целевой аудитории?
Вы: Это владельцы малого бизнеса, интересующиеся автоматизацией
ИИ: Какие данные нужно собрать в заявке?
Вы: Имя, компанию, телефон, описание задачи
ИИ: Нужна ли интеграция с CRM?
Вы: Да, нужно отправлять в нашу CRM через webhook
ИИ: [создаёт план с узлами приветствия, сбора данных, отправки в CRM]

Режим создания

Что это: Режим прямой генерации сценария бота на основе ваших текстовых запросов.

Когда использовать:

• Когда вы точно знаете, что нужно сделать

• Когда нужно добавить конкретный функционал

Как работает:

1. Прямой запрос:

   • Напишите конкретное описание того, что нужно создать

   • ИИ сразу сгенерирует сценарий

   • Не будет задавать уточняющих вопросов

2. История запросов:

   • Сохраняются последние 20 запросов

3. Примеры промптов:

   Создание с нуля:

   "Создай бота для опроса удовлетворённости клиентов. 
   Нужно спросить оценку от 1 до 5, если меньше 4 - 
   попросить комментарий, сохранить всё в контекст"

   Доработка существующего (в процессе разработки):

   "Добавь после сбора email проверку через HTTP запрос 
   к API валидации. Если email невалидный - попроси ввести заново"

   Добавление AI агента:

   "После приветствия добавь AI агента, который будет 
   отвечать на вопросы о продукте. Используй модель 
   Gemini Flash, промпт: 'Ты эксперт по нашему продукту'"

4. Валидация и автоисправление:

   • ИИ автоматически проверяет сгенерированную конфигурацию

   • Если находит ошибки - пытается исправить их

5. Ручное редактирование:

   • Если автоисправление не помогло, появится диалог

   • Можно вручную отредактировать JSON

   • Встроенная подсветка синтаксиса и проверка ошибок

6. Автоматическая раскладка:

   • После успешной загрузки узлы автоматически раскладываются на холсте

Переключение между режимами

Вверху панели помощника есть две вкладки:

• 💭 Planning - режим планирования

• ⚙️ Creation - режим создания

Рекомендованный workflow:

1. Начните с Planning для проработки идеи

2. Примените план - автоматически переключитесь в Creation

3. Дорабатывайте детали в Creation режиме

4. При необходимости кардинальных изменений - вернитесь в Planning

Работа с ошибками

Автоматическое исправление:

1. ИИ генерирует JSON

2. Система валидирует конфигурацию

3. Если есть ошибки:

   • ИИ получает описание ошибок

   • Пытается исправить (до 3 попыток)

   • Показывает процесс исправления в чате

Ручное редактирование:

• Если автоисправление не помогло

• Появится диалог "Edit JSON Manually"

• Встроенный редактор с подсветкой синтаксиса

• Показывает конкретные ошибки валидации

Типичные ошибки:

• Отсутствующий trigger у кнопок

• Неправильные типы условий

• Отсутствие обязательных полей

• Невалидные URLs для медиа

Лучшие практики при работе с ИИ помощником

Формулировка запросов:

✅ Хорошо:

"Создай бота для записи на консультацию. Нужно собрать 
имя, телефон, удобное время. После сбора отправить 
уведомление менеджеру и сохранить в CRM"

❌ Плохо:

"Сделай бота"

Конкретизируйте детали:

• Какие данные собирать

• Какие условия проверять

• Какие интеграции нужны

• Какие сообщения показывать

Итеративная доработка:

• Не пытайтесь создать всё сразу

• Создайте базовый сценарий

• Потом добавляйте фичи по одной

• Тестируйте после каждого изменения

Проверяйте результат:

• После генерации просмотрите узлы на холсте

• Проверьте логику переходов

• Протестируйте бота в Telegram

• При необходимости попросите ИИ доработать

Ограничения и лимиты

Токены:

• Каждый запрос потребляет токены из лимита вашего тарифного плана

• Сложные сценарии требуют больше токенов

• При достижении лимита появится ошибка

Rate Limits:

• Ограничение на количество запросов в минуту

• При превышении появится ошибка

• Подождите несколько секунд перед следующим запросом

Размер конфигурации:

• Очень сложные боты (>50 узлов) могут генерироваться дольше

• Если генерация обрывается - система предложит продолжить

Качество генерации:

• ИИ лучше работает с конкретными, структурированными запросами

• Чем подробнее описание - тем точнее результат

• Всегда проверяйте и тестируйте сгенерированный сценарий

Примеры использования

Пример 1: Создание бота с нуля (Planning → Creation)

1. Открываем Planning режим

2. Пишем: "Нужен бот для обработки входящих обращений клиентов"

3. Отвечаем на вопросы ИИ о бизнес-логике

4. Применяем созданный план

5. Дорабатываем детали в Creation режиме

Пример 2: Добавление AI агента (Creation)

"После узла приветствия добавь AI агента. 
Используй провайдер Gemini Flash.
Системный промпт: 'Ты помощник магазина электроники'.
Пользовательский промпт: '{{message.text}}'.
Сохрани ответ в переменную ai_response.
Включи режим ожидания ответа"

Пример 3: Добавление условий (Creation)

"Добавь проверку: если в контексте score >= 7, 
отправь сообщение 'Отлично!' и перейди к узлу благодарности,
иначе отправь 'Спасибо за честность' и перейди к узлу уточнений"

Пример 4: Интеграция с API (Creation)

"После сбора email добавь HTTP запрос к 
https://api.example.com/validate-email
Метод POST, отправь {email: '{{context.email}}'}
Сохрани результат в context.validation_result"