> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botflow.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# ИИ-оператор

> Персона, база знаний, первое сообщение и ИИ-пуши, модель и бюджет виртуального оператора.

ИИ-оператор ведёт живой диалог с подписчиком вместо человека. Он подключается через блок «ИИ-оператор» в
[конструкторе](/ru/constructor) и общается так же, как обычный оператор в переписке. Общие настройки (персона,
модель, язык, база знаний, бюджет) живут в разделе бота «Настройки ИИ». Задача каждого конкретного диалога
задаётся прямо в ИИ-блоке воронки.

## Как подключить

<Steps>
  <Step title="Включите ИИ-оператора" icon="toggle-on">
    В разделе бота откройте «Настройки ИИ» и включите верхний переключатель. Пока он выключен, блоки
    «ИИ-оператор» в конструкторе не отвечают.
  </Step>

  <Step title="Опишите персону и выберите модель" icon="user">
    В поле «Персона» задайте, кто ведёт диалог и как. Ниже выберите языковую модель, которая будет
    генерировать ответы.
  </Step>

  <Step title="Добавьте ИИ-блок в конструкторе" icon="diagram-project">
    На холсте [конструктора](/ru/constructor) добавьте блок «ИИ-оператор» (один из типов блоков). Во вкладке
    «Задача» опишите, к чему ИИ ведёт диалог в этом блоке.
  </Step>

  <Step title="Настройте переходы" icon="arrow-right">
    Нарисуйте стрелки от ИИ-блока к следующим шагам. Условие на каждой стрелке пишется словами, ИИ сам решает,
    когда оно выполнено.
  </Step>
</Steps>

<Note>
  Настройки ИИ доступны менеджерам и администраторам компании. Роль «оператор» их не видит. Дневной бюджет и
  перевод сообщений включает только администратор компании.
</Note>

## Персона

Персона задаёт, кто ведёт диалог: имя, роль, манера речи, легенда (где работает оператор, что предлагает). Она
влияет на тон и поведение сильнее, чем выбор модели.

* Пишите позитивно, то есть что оператору делать, а не только чего избегать.
* Текст персоны идёт в каждый ответ, поэтому держите его по делу, без лишних абзацев.
* Пример: «Дружелюбный консультант сервиса. Помогает разобраться, отвечает по делу, без канцелярита».

Жёсткие запреты (темы, обещания, действия, которых оператор не делает) выносятся в поле «Ограничения» внутри
«Расширенных настроек». Манера письма (тон, длина фраз, эмоциональность) настраивается там же в «Стиле общения».

## Модель

Модель генерирует ответы. Список открывается поиском по названию: наберите часть имени и выберите модель из
каталога.

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

<Tip>
  Если в каталоге нет ни одной включённой модели, поле переключается на ручной ввод ID модели. ИИ-оператор при
  этом продолжает работать.
</Tip>

## Язык

Раздел «Язык» определяет, на каком языке отвечает оператор. Способ выбора задаётся полем «Как выбирать язык
ответа», по умолчанию стоит «Определять по сообщению».

* **Определять по сообщению.** ИИ отвечает на языке последнего сообщения подписчика. Режим по умолчанию.
* **Всегда один язык.** ИИ всегда отвечает на выбранном языке.
* **Зеркалить язык диалога.** ИИ держит язык, на котором диалог начался.

Отдельно задаётся «Язык по умолчанию»: язык первого сообщения, пока подписчик ещё ничего не написал (например,
когда он входит в воронку по команде, а не текстом). Как только подписчик напишет, ИИ подстроится под его язык
в режимах «Определять по сообщению» и «Зеркалить».

По умолчанию в этом поле стоит «Авто (по подписчику)». Тогда язык первого сообщения выбирается по приоритету:
сначала язык, заданный в настройке, затем язык устройства подписчика, затем общий запасной язык.

<Info>
  Чтобы задать язык первого сообщения жёстко, выберите в «Языке по умолчанию» конкретный язык вместо «Авто (по
  подписчику)».
</Info>

В режиме «Всегда один язык» появляется переключатель «Знает только этот язык». С ним сообщения на других языках
оператор не понимает и реагирует растерянно, как живой человек, который этих языков не знает.

## Задача блока и переходы

Персона, модель и язык общие для всего бота. Задача у каждого ИИ-блока своя, она задаётся в конструкторе.
«ИИ-оператор» стоит в конструкторе рядом с другими типами блоков: «Стартовое условие», «Состояние диалога» и
«Fallback».

* **Задача блока.** Во вкладке «Задача» опишите, к чему ИИ ведёт диалог именно здесь. Например: довести до
  оплаты, ответить на вопросы о тарифе, снять возражения и подвести к заявке.
* **Переходы.** Стрелки от ИИ-блока задают, куда двигаться дальше. На стрелке в поле «Условие перехода (ИИ
  решает)» пишется условие словами, например «клиент подтвердил, что готов внести депозит». ИИ оценивает его по
  ответам собеседника. Пустое условие работает как запасной переход.

## Сообщения по инициативе ИИ

ИИ может писать не только в ответ, но и сам. Это два разных случая, оба настраиваются в ИИ-блоке: первое
сообщение при входе в блок и ИИ-пуши замолчавшему подписчику.

### Первое сообщение при входе

Во вкладке «Задача» есть переключатель «Писать первым при входе».

* **Включён.** ИИ сам открывает диалог, когда подписчик входит в блок.
* **Выключен.** ИИ ждёт первого сообщения подписчика и только потом отвечает.

Язык этого первого сообщения берётся из «Языка по умолчанию» (см. раздел выше).

### ИИ-пуши

Если подписчик замолчал, ИИ может сам вернуть его в диалог. Во вкладке «Пуши» ИИ-блока в поле «Тип
напоминаний» выберите «ИИ сам решает когда и что писать». ИИ сам подбирает момент и формулировку. Текст не
берётся из шаблонов: ИИ составляет его из контекста переписки и того, что уже знает о подписчике. Частоту
задают три поля:

* **Максимум напоминаний.** Сколько раз ИИ напомнит о себе (от 1 до 10).
* **Не чаще, чем раз в (мин).** Не чаще одного напоминания за столько минут.
* **Не реже, чем раз в (мин).** Не реже одного напоминания за столько минут.

ИИ прекращает напоминания, как только подписчик ответил, перешёл дальше или исчерпан лимит. Тем, кто
заблокировал бота, напоминания не уходят.

<Note>
  В обычных (не ИИ) блоках напоминания тоже есть, но там это «Заданные сообщения по таймеру»: готовая цепочка
  сообщений с задержками от входа в блок. Подробнее в разделе [Конструктор](/ru/constructor).
</Note>

## База знаний

База знаний нужна, чтобы ИИ отвечал по вашим материалам, а не выдумывал. Добавляйте условия, ответы на частые
вопросы, правила выводов, описание оффера и бонусов.

<Steps>
  <Step title="Добавьте материал" icon="plus">
    Нажмите «Добавить», укажите название (необязательно) и вставьте текст материала. Поддерживается любой язык.
  </Step>

  <Step title="Дождитесь индексации" icon="hourglass">
    Материал получает статус «Индексация», затем «Готов». В статусе «Готов» показано, на сколько фрагментов он
    разбит.
  </Step>

  <Step title="ИИ отвечает по материалам" icon="comments">
    Материалы превращаются в поиск по смыслу. На вопрос подписчика ИИ находит подходящий фрагмент и отвечает по
    нему, а не из общих знаний.
  </Step>
</Steps>

На бота можно добавить до 200 материалов. Материал можно отредактировать или удалить в любой момент, после
правки он переиндексируется заново.

<Tip>
  База знаний работает при включённом ИИ-операторе. Если она временно недоступна, добавление и правка материалов
  вернутся автоматически, список при этом остаётся виден.
</Tip>

## ИИ остаётся человеком

Оператор ведёт себя как живой сотрудник и никогда не намекает, что это ИИ.

* Подписчик не видит признаков автоматизации: ни «я бот», ни «я ИИ», ни служебных фраз. Оператор всегда
  отвечает, что он настоящий человек.
* Когда нужен живой человек (сложный случай или подписчик долго не двигается к цели), диалог тихо переводится
  на ручной и попадает к оператору в [Мессенджер](/ru/messenger) (в меню бота этот раздел называется
  «Сообщения»). Подписчик ничего не замечает, никаких объявлений о передаче не происходит.
* Настройка «Перевод на ручной после N реплик в блоке» (в «Расширенных настройках», секция «Генерация»)
  ограничивает, сколько кругов ИИ ведёт сам, прежде чем передать оператору. Значение 0 снимает ограничение.

## Бюджет

Расход на ответы ИИ ограничивается дневными бюджетами и балансом компании.

* **Дневной бюджет AI (этот бот).** Максимум списаний за AI-ответы конкретного бота в день. При достижении
  лимита ИИ молчит до полуночи (UTC) и продолжает на следующий день. Пустое поле означает без лимита. Карточка
  показывает, сколько уже потрачено сегодня из лимита.
* **Дневной бюджет AI (вся компания).** Общий лимит на все боты компании, задаётся в
  [настройках компании](/ru/settings). Лимит бота и лимит компании действуют одновременно: срабатывает тот,
  который достигнут раньше.
* **Баланс.** Общий расход также ограничен балансом компании, подробности в разделе [Биллинг](/ru/billing).

<Warning>
  Дневной бюджет и перевод сообщений меняет только администратор компании. Менеджер видит остальные настройки
  ИИ, но не бюджет.
</Warning>

## Дополнительно

В карточках ниже и под «Расширенными настройками» собраны точечные параметры.

<Columns cols={2}>
  <Card title="Память о собеседнике" icon="brain">
    ИИ запоминает немного устойчивых фактов о человеке (чего хочет, что смущает, ограничения) и учитывает их в
    следующих разговорах. Экспериментально, по умолчанию выключено, немного увеличивает расход.
  </Card>

  <Card title="Распознавание медиа" icon="image">
    Фото воспринимается как вложение: ИИ описывает картинку и текст на ней. Голосовые, аудио, видео и
    видеосообщения пока не распознаются, поддержка появится позже.
  </Card>

  <Card title="Перевод сообщений" icon="language">
    Оператор переводит сообщения диалога на язык оператора и показывает превью исходящего на языке подписчика.
    Включает администратор компании, нужен включённый ИИ-оператор.
  </Card>

  <Card title="Генерация" icon="sliders">
    Тонкая настройка ответа: стиль (пресеты «По умолчанию», «Живее», «Строже» или «Свой» для ручной настройки),
    эмодзи и длина. Обычно достаточно выбрать стиль.
  </Card>

  <Card title="Живость набора" icon="keyboard">
    Задержки и разбивка ответа на несколько сообщений, чтобы переписка выглядела человеческой: пауза перед
    ответом, паузы между сообщениями и число сообщений в одном ответе.
  </Card>
</Columns>

## Смежные разделы

<Columns cols={2}>
  <Card title="Конструктор" icon="diagram-project" href="/ru/constructor">
    Где живёт ИИ-блок: задача, стрелки перехода, напоминания.
  </Card>

  <Card title="Мессенджер" icon="comments" href="/ru/messenger">
    Куда попадает диалог, переведённый на живого оператора.
  </Card>

  <Card title="Биллинг" icon="wallet" href="/ru/billing">
    Баланс и списания за ответы ИИ.
  </Card>

  <Card title="Настройки" icon="gear" href="/ru/settings">
    Дневной бюджет AI на всю компанию.
  </Card>
</Columns>