# Работа с ИИ помощником
Редактор ботов имеет встроенного ИИ помощника, который может помочь вам создать или доработать сценарий бота. Помощник работает в двух режимах: **Режим планирования** и **Режим создания**.
#### Как открыть ИИ помощника
В правом верхнем углу редактора найдите кнопку с иконкой **"ИИ помощник"** (мозг). Нажмите на неё, чтобы открыть панель помощника справа.
### Режим планирования
**Что это:** Режим диалога, в котором ИИ помогает вам продумать бизнес-логику бота через вопросы и ответы.
**Когда использовать:**
* Когда вы только начинаете создавать бота и не уверены в структуре
* Когда нужна помощь в проработке бизнес-логики
* Когда хотите получить экспертные рекомендации по построению сценария
**Как работает:**
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"
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://book.microcrm.online/konstruktor-chat-botov/rabota-s-ii-pomoshnikom.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.