> For the complete documentation index, see [llms.txt](https://book.microcrm.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.microcrm.online/konstruktor-chat-botov/rabota-s-ii-pomoshnikom.md).
# Работа с ИИ помощником
Редактор ботов имеет встроенного ИИ помощника, который может помочь вам создать или доработать сценарий бота. Помощник работает в двух режимах: **Режим планирования** и **Режим создания**.
#### Как открыть ИИ помощника
В правом верхнем углу редактора найдите кнопку с иконкой **"ИИ помощник"** (мозг). Нажмите на неё, чтобы открыть панель помощника справа.
### Режим планирования
**Что это:** Режим диалога, в котором ИИ помогает вам продумать бизнес-логику бота через вопросы и ответы.
**Когда использовать:**
* Когда вы только начинаете создавать бота и не уверены в структуре
* Когда нужна помощь в проработке бизнес-логики
* Когда хотите получить экспертные рекомендации по построению сценария
**Как работает:**
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"
```