> For the complete documentation index, see [llms.txt](https://docs.lessondelivery.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lessondelivery.com/howto/wiki/ai-nastroiki-bota.md).

# AI-настройки бота

## AI-настройки бота

AI-автоответы помогают боту отвечать на текстовые сообщения подписчиков в чате поддержки. Настройки находятся в панели управления бота на вкладке **AI**.

### Как включить AI-автоответы

1. Откройте нужного бота в панели.
2. Перейдите на вкладку **AI**.
3. Включите переключатель **Включить AI-автоответы**.
4. Заполните настройки ниже и сохраните бота.

После включения бот будет автоматически отвечать на текстовые сообщения подписчиков в чате поддержки. Если AI не сможет ответить из-за лимита, таймаута или ошибки сервиса, бот отправит сообщение при сбое.

### OpenRouter API key

В поле **OpenRouter API key** можно указать собственный ключ OpenRouter вида `sk-or-v1-...`.

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

Собственный ключ полезен, если нужно больше контроля над лимитами, расходами и доступными моделями.

### Модель OpenRouter

В поле **Модель OpenRouter** можно указать конкретную модель, например:

```
deepseek/deepseek-r1:free
```

Если поле оставить пустым, платформа подберет модель автоматически из доступных бесплатных моделей или использует модель по умолчанию, заданную администратором платформы.

### Системный промпт

**Системный промпт** — это инструкция для AI: как отвечать, в каком стиле, какую роль выполнять и какие ограничения соблюдать.

Пример:

```
Ты ассистент онлайн-школы. Отвечай дружелюбно и коротко. Помогай ученику разобраться с курсом, оплатой и доступом к урокам. Если вопрос требует участия человека, предложи дождаться оператора.
```

На платном тарифе можно задать собственный системный промпт для конкретного бота. На бесплатном тарифе используется общий промпт платформы, поэтому поле промпта недоступно для редактирования.

### Сообщение при сбое AI

Поле **Сообщение при сбое AI** используется, когда AI не смог ответить: например, закончился лимит запросов, OpenRouter не отвечает или произошел таймаут.

Пример:

```
Спасибо за сообщение! Сейчас не удалось подготовить автоматический ответ. Оператор скоро подключится и поможет вам.
```

Если оставить поле пустым, будет использоваться стандартный текст.

### Контекст курса в ответах AI

Переключатель **Контекст курса в ответах AI** включен по умолчанию.

Когда он включен, AI получает дополнительный контекст:

* описание бота;
* материалы текущего курса, которые подписчик видит до оплаты;
* если текущего курса нет — короткий список доступных курсов.

AI не получает закрытые материалы после этапа оплаты. Это помогает отвечать на вопросы вроде «о чем курс?», «что будет в первых уроках?» или «как начать обучение?», не раскрывая платный контент.

Отключайте контекст курса, если бот должен отвечать только по общей инструкции из системного промпта.

### Бесплатный и платный тариф

На бесплатном тарифе AI может включаться глобально администратором платформы для всех бесплатных ботов. Владелец бота может отключить AI у себя.

На платном тарифе владелец включает AI самостоятельно в настройках своего бота. Также на платном тарифе доступен собственный системный промпт.

### Что проверить после настройки

1. Напишите боту как обычный подписчик.
2. Задайте простой вопрос по курсу или поддержке.
3. Проверьте, что ответ соответствует тону и ограничениям системного промпта.
4. Если ответ слишком длинный, неточный или не в том стиле, уточните системный промпт.
5. Если бот молчит при ошибках AI, заполните сообщение при сбое.

Лучше начинать с короткого промпта и постепенно уточнять его по реальным вопросам подписчиков.
