Документация › Проект и бот › Продвинутые настройки
Продвинутые настройки бота
Помимо промпта, поведение бота тонко настраивается: как он разбивает ответы, ждёт ли, пока клиент допишет, в какие часы работает, как реагирует на оператора, что делает со спамом. Эта статья — карта всех рычагов.
⏱ 11 мин · 👤 для владельца · 🟢 live
За 30 секунд:
- Бот «печатает по частям», ждёт, пока клиент допишет, может работать по расписанию, уступать оператору, защищаться от спама.
- Всё это — настройки проекта (
agent_config), у каждой есть разумное значение по умолчанию.- Трогай по необходимости: дефолты подобраны так, чтобы работало «из коробки».
Ответы: разбивка и темп
| Настройка | По умолчанию | Что делает |
|---|---|---|
split_messages | вкл | разбивать длинный ответ на несколько коротких сообщений |
split_delay_seconds | 2 сек | пауза между частями (эффект печатания) |
split_threshold | 300 симв. | с какой длины начинать разбивать |
split_max_length | 500 симв. | макс. длина одной части |
split_max_parts | 5 | макс. число частей |
💡 Разбивка делает бота «живее» — клиент видит несколько коротких реплик вместо стены текста. Подробнее про механику — JSON-ответ бота.
Буферизация: дождаться, пока клиент допишет
Клиенты часто пишут мысль несколькими сообщениями подряд («Здравствуйте» / «хочу записаться» / «на завтра»). Чтобы бот не отвечал на каждое по отдельности, есть буфер:
| Настройка | По умолчанию | Что делает |
|---|---|---|
buffer_delay_seconds | 1 сек | сколько ждать новых сообщений перед ответом |
buffer_delay_media_seconds | 5 сек | доп. ожидание для медиа (фото/голос) |
Бот ждёт паузы в наборе и отвечает на всё разом — как живой человек.
Перехват оператором
| Настройка | По умолчанию | Что делает |
|---|---|---|
pause_on_operator | вкл | ставить ИИ на паузу, когда оператор пишет в чат |
ignore_first_operator_message | выкл | не паузить на первом сообщении оператора |
exception_phrases | — | фразы-исключения, после которых пауза не ставится |
auto_resume_enabled + auto_resume_* | выкл | авто-возврат ИИ через N дней/часов/минут оператора |
resume_message | «Добрый день!» | что бот пишет при авто-возврате |
Подробно про перехват — Диалоги.
Расписание работы (рабочие часы)
| Настройка | По умолчанию | Что делает |
|---|---|---|
schedule_enabled | выкл | включить рабочие часы |
schedule | Пн–Пт 09:00–20:00, Сб 09:00–18:00, Вс выкл | график по дням |
timezone | Asia/Almaty | пояс для расписания |
offline_message | дежурный текст | автоответ вне рабочих часов |
Вне рабочих часов бот не тратит токены: сохраняет сообщение клиента (оператор увидит его в CRM) и один раз на диалог шлёт автоответ «сейчас нерабочее время».
Память диалога
| Настройка | По умолчанию | Что делает |
|---|---|---|
history_message_limit | 30 | сколько последних сообщений бот «помнит» |
history_time_limit | 2 недели | за какой период берётся история |
Защита от спама
| Настройка | По умолчанию | Что делает |
|---|---|---|
spam_protection_enabled | выкл | включить лимиты |
spam_message_limit / spam_duration_seconds | 5 / 60 сек | сколько сообщений за окно допустимо |
spam_daily_limit | 100 | макс. сообщений в день от одного |
spam_response_message | «Пожалуйста, подождите…» | ответ при срабатывании |
Распознавание медиа
| Настройка | По умолчанию | Что делает |
|---|---|---|
recognize_audio | вкл | расшифровывать голосовые |
recognize_images | вкл | «видеть» картинки |
recognize_pdf | вкл | читать PDF |
recognize_documents | вкл | читать документы (DOCX и т.п.) |
⚠️ Распознавание голоса и картинок тратит баланс (это отдельная обработка). Если не нужно — выключи. См. Сколько стоит сообщение.
Запись на приём (календарь)
Если используешь Google Календарь, бот учитывает: calendar_slot_duration (длительность приёма, 60 мин), calendar_days_ahead (на сколько дней вперёд показывать, 7), рабочие часы и дни записи, calendar_min_notice_minutes (за сколько минимум записывать, 60).
💬 Простыми словами
Думай об этих настройках как о «характере» бота помимо промпта. Можно сделать так, чтобы он отвечал короткими репликами, как в живом чате, а не стеной текста. Можно научить его не торопиться с ответом, пока клиент дописывает мысль в несколько сообщений. Можно задать рабочие часы — и ночью он будет вежливо отвечать «мы на связи с утра», не тратя при этом деньги. Можно настроить, чтобы он уступал, как только в чат заходишь ты, и сам возвращался к работе через заданное время.
Хорошая новость: всё это уже настроено по уму «из коробки». Лезть туда стоит, только когда хочешь что-то конкретное — например, включить рабочие часы или защиту от спама. Остальное спокойно оставляй как есть.
Дальше: → Обзор каналов
Связано: Системный промпт · Выбор модели · Дожимы · Диалоги
Не получилось? → Бот не отвечает