# AI-агент

Блок «AI-агент» передаёт разговор модели ИИ. Агент сам отвечает контакту по вашей инструкции, помнит диалог и, когда разговор пришёл к итогу, отправляет контакта дальше по сценарию.

Блок нужен там, где ветки с кнопками не хватает: консультация, ответы на частые вопросы, выяснение потребности перед передачей оператору.

## Что нужно для работы

- **Подписка Pro** — чтобы бот отвечал людям в мессенджерах. Что доступно без неё — на странице [Что доступно без Pro](https://support.watbot.ru/billing/without-pro).
- **Пополненный «Баланс для ИИ».** Блок в подписку не входит: каждый ответ агента оплачивается с «Баланса для ИИ» по цене выбранной модели. Цены моделей — на странице [Цены дополнительных услуг](https://support.watbot.ru/billing/services).
- **Выбранная модель** в настройках блока. Без неё блок ничего не отправит.

Расход каждого ответа виден в разделе «Логи» — там он записан с типом «AI-агент».

> [!NOTE]
> При проверке через «Проверить бота» агент тоже обращается к модели, и ответы оплачиваются с «Баланса для ИИ».

## Чем блок отличается от блоков сообщений

- **Текст ответа пишет модель.** Вы задаёте не сообщение, а инструкцию — «Системный промт».
- **Контакт остаётся в блоке и переписывается с агентом.** Каждое новое сообщение контакта — новый ответ агента, пока агент не выберет переход или контакт не уйдёт из блока сам.
- **Кнопок у блока нет.** Переходы блока — это не кнопки для контакта, а ветки сценария, которые выбирает агент.
- **Ответ готовится не мгновенно.** Пока модель думает, сценарий не стоит: контакт может пройти по выходу «Продолжить», а когда ответ готов, вернётся в блок и получит его.
- **У каждого блока своя память.** История разговора хранится отдельно для каждого контакта и каждого блока «AI-агент»: второй агент в том же боте не знает, о чём контакт говорил с первым.

## Настройки

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

![Панель настроек блока «AI-агент»: системный промт, модель и инструменты](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/_images/ai-block.webp?v=1791781230)

Инструкция для агента: кто он, о чём говорит, что должен выяснить и по каким признакам выбирать переход. До 10 000 символов.

В новом блоке уже есть заготовка промта с ролью, правилами и списком переходов — замените её своей.

В промте работают [автоподстановки](https://support.watbot.ru/chatbots/templates): имя контакта, его теги и переменные подставляются заново перед каждым ответом. Доступны только простые функции — какие именно, описано на странице [Где работают автоподстановки](https://support.watbot.ru/chatbots/templates/where).

> [!TIP]
> Опишите в промте границы темы и что делать с вопросом не по теме. Агент без границ ответит на что угодно — от имени вашей компании.

### «Модель»

Модель, которая отвечает контакту. В списке модели сгруппированы по провайдерам, рядом с каждой — цена за входящие и исходящие токены.

Когда модель выбрана, появляется поле **«Рассуждение»** — сколько модель размышляет перед ответом. Набор уровней зависит от модели; значение «Выключено» есть всегда. Если модель не умеет рассуждать, других значений в списке не будет.

### «Инструменты»

Что агенту разрешено делать, кроме ответа текстом. В новом блоке все инструменты выключены.

- **«Текущее время»** — агент может узнать текущие дату и время.
- **«Поиск в интернете»** — агент ищет информацию в интернете. Каждый поиск оплачивается с «Баланса для ИИ» отдельно, сверх токенов модели.
- **«Чтение веб-страниц»** — агент открывает страницу по ссылке и читает её текст.
- **«Поиск в базе знаний»** — агент ищет ответ в ваших документах. Когда переключатель включён, ниже появляется поле **«База знаний»** — выберите в нём одну базу проекта. Пока база не выбрана, поиск не работает.
- **«Поиск в справке платформы»** — агент ищет ответ в справке Watbot и даёт ссылки на её разделы. Пригодится боту, который помогает вашим клиентам разобраться в Watbot: например, если вы настраиваете ботов для других.
- **«Теги контакта»** — агент назначает и снимает теги контакта по ходу разговора. Какие теги ставить и когда — опишите в промте.
- **«Переменные контакта»** — агент записывает и удаляет переменные контакта. Какие переменные заполнять — опишите в промте. Агент работает только с текстовыми переменными: переменные с файлами, картинками, аудио и видео он не меняет.
- **«Создание файлов»** — агент создаёт документы PDF и Word, таблицы Excel, файлы CSV и текстовые, отправляет их контакту и вносит правки в файлы, которые отправил раньше. Когда и какие файлы делать — опишите в промте.

![Инструменты AI-агента: включены текущее время, чтение веб-страниц, поиск в базе знаний, теги и переменные контакта; ниже — поле «База знаний»](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/_images/ai-tools.webp?v=1791781230)

### История диалога

- **«Размер истории сообщений»** — сколько последних сообщений диалога агент видит, когда готовит ответ. Считаются и сообщения контакта, и ответы агента. От 1 до 1000, по умолчанию 10. Чем больше история, тем лучше агент помнит разговор и тем дороже каждый ответ.
- **«Актуальность истории сообщений (дней)»** — сообщения старше этого срока агент не учитывает. 0 — без ограничения по времени.
- **«Сбрасывать историю»** — история очищается перед каждым ответом. Агент видит только последнее сообщение контакта и предыдущих не помнит.

![История диалога: 20 сообщений за 7 дней, «Сбрасывать историю» выключено, «Стримить ответ» включено](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/_images/ai-history.webp?v=1791781230)

### «Стримить ответ»

Ответ появляется в чате по мере того, как модель его пишет. Пока модель молчит — например, ищет в базе знаний, — контакт видит «Думаю…».

Настройка действует в личных чатах Telegram и в [веб-чате](https://support.watbot.ru/chatbots/channels/web). В остальных каналах она ни на что не влияет: ответ приходит целиком, когда готов.

### «Переходы»

Ветки сценария, по которым агент может отправить контакта. Кнопка «Добавить переход» добавляет ветку; её название становится выходом блока на схеме.

Агент видит названия переходов и выбирает один из них, когда итог разговора ясно подходит под ветку. Если ни один переход не подходит, агент не выбирает ничего, и контакт остаётся в блоке. Ответ агента контакт получает в любом случае — сначала ответ, потом переход.

Называйте переходы понятно — «Ноутбуки», «Оператор» — и опишите в промте, когда выбирать каждый.

![Раздел «Переходы»: «Оформить заказ» и «Позвать флориста», ниже — «Ошибка ИИ» и «Любая другая фраза»](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/_images/ai-transitions.webp?v=1791781230)

> [!WARNING]
> Если контакт напишет текст, который совпадает с названием перехода, он пройдёт по этому переходу сразу, без ответа агента.

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

Два переключателя из этого раздела меняют поведение агента:

- **«Ответ цифрами»** — включён по умолчанию. Когда контакт присылает число, оно считается номером перехода: «2» отправит контакта по второму переходу без ответа агента. Если агент задаёт вопросы, на которые отвечают числом — «сколько человек?», «какой размер?», — выключите эту настройку.
- **«Записать ответ в пользовательскую переменную»** — каждое сообщение контакта в этом блоке записывается в указанную переменную, новое поверх прежнего.

## Выходы

- **Переходы** — выходы с названиями, которые вы задали в разделе «Переходы». Срабатывает тот, который выбрал агент, сразу после его ответа.
- **«Любая другая фраза»** — срабатывает, когда контакт пишет в блоке любой текст. Оставьте этот выход без связи: тогда сообщение попадёт к агенту. Если соединить его с другим блоком, следующее сообщение контакта уйдёт туда, и разговора с агентом не получится.
- **«Ошибка ИИ»** — срабатывает, когда ответа не будет:
  - модель недоступна или вернула ошибку;
  - на «Балансе для ИИ» нет средств;
  - средства закончились, пока агент готовил ответ — уже сделанная работа оплачивается, ответ не отправляется;
  - контакт превысил лимит сообщений агенту (см. [Ограничения](https://support.watbot.ru/chatbots/blocks/ai-agent#ограничения)).
- **«Продолжить»** — срабатывает сразу, как только блок получил сообщение и начал готовить ответ. Ответа он не ждёт. Когда ответ готов, контакт возвращается в блок «AI-агент» и получает его. Если выход не соединён, контакт просто ждёт ответа в блоке.

![Блок «AI-агент» на схеме: выходы-переходы, «Ошибка ИИ», «Любая другая фраза» и «Продолжить»](https://support.watbot.ru/_media/ru/01-chatbots/03-blocks/_images/ai-outputs.webp?v=1791781230)

> [!IMPORTANT]
> Соедините «Ошибка ИИ» с обычным сообщением — например, «Сейчас не могу ответить, напишите позже» или с передачей оператору. Без связи контакт при ошибке не получит ничего.

Причина ошибки записывается в «Лог выполнения» блока: «Не удалось получить ответ от модели», «Недостаточно средств на «Балансе для ИИ»» или «Лимит генераций для этого контакта исчерпан».

Если модель в блоке не выбрана или больше не подключена в проекте, тоже срабатывает «Ошибка ИИ», а в логе появляется запись «Модель не установлена» или «Модель не найдена». Если выход «Ошибка ИИ» ни с чем не соединён, блок ничего не отправляет, а контакт идёт по «Продолжить», если этот выход соединён.

## Файлы и картинки от контакта

Агент разбирает не только текст.

- **Картинки** — если выбранная модель принимает изображения. Если не принимает, агент не отвечает, а контакт получает сообщение с просьбой написать вопрос текстом.
- **Документы** — агент читает их содержимое.
- **Голосовые сообщения, аудио и видео** агент не разбирает.

В одном сообщении учитывается до 10 вложений. Картинки больше 5 МБ и документы больше 50 МБ пропускаются.

## Ограничения

- **Один ответ за раз.** Пока агент готовит ответ, новые сообщения этого контакта он не обрабатывает и не запоминает. Контакт при этом проходит по выходу «Продолжить», если он соединён.
- **Лимит на контакта.** Один контакт может получить не больше 20 ответов агента за 10 минут и не больше 200 в сутки во всех блоках «AI-агент» бота. Сверх лимита срабатывает выход «Ошибка ИИ». Лимит защищает ваш «Баланс для ИИ»: ответы оплачиваете вы, а пишет боту кто угодно. При проверке через «Проверить бота» лимит не действует.
- **Файлы.** Агент создаёт не больше 3 файлов за один ответ и не больше 30 файлов в сутки для одного контакта.
- **Связи.** Выходы блока нельзя соединить с другим блоком «AI-агент», а также с блоками «Глобальное меню», «Встроенный бот Телеграм» и «Входящий Webhook».

## Отличия по каналам

| | Telegram | ВКонтакте | MAX | Viber | Веб-чат |
|---|---|---|---|---|---|
| Ответ печатается по мере готовности | да, в личных чатах | нет | нет | нет | да |
| Оформление ответа: жирный текст, списки | да | нет, обычный текст | да | нет, обычный текст | да |

Модель оформляет ответ разметкой. Там, где канал её не поддерживает, контакт получает тот же текст без оформления и без служебных символов.

Файлы, которые создал агент, приходят контакту документами следом за ответом.