AI-агент#

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

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

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

• Подписка Pro — чтобы бот отвечал людям в мессенджерах. Что доступно без неё — на странице Что доступно без Pro.
• Пополненный «Баланс для ИИ». Блок в подписку не входит: каждый ответ агента оплачивается с «Баланса для ИИ» по цене выбранной модели. Цены моделей — на странице Цены дополнительных услуг.
• Выбранная модель в настройках блока. Без неё блок ничего не отправит.

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

Заметка

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

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

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

Настройки#

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

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

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

В промте работают автоподстановки: имя контакта, его теги и переменные подставляются заново перед каждым ответом. Доступны только простые функции — какие именно, описано на странице Где работают автоподстановки.

Совет

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

«Модель»#

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

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

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

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

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

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

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

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

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

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

«Переходы»#

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

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

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

Внимание

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

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

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

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

Выходы#

• Переходы — выходы с названиями, которые вы задали в разделе «Переходы». Срабатывает тот, который выбрал агент, сразу после его ответа.
• «Любая другая фраза» — срабатывает, когда контакт пишет в блоке любой текст. Оставьте этот выход без связи: тогда сообщение попадёт к агенту. Если соединить его с другим блоком, следующее сообщение контакта уйдёт туда, и разговора с агентом не получится.
• «Ошибка ИИ» — срабатывает, когда ответа не будет:
  • модель недоступна или вернула ошибку;
  • на «Балансе для ИИ» нет средств;
  • средства закончились, пока агент готовил ответ — уже сделанная работа оплачивается, ответ не отправляется;
  • контакт превысил лимит сообщений агенту (см. Ограничения).
• «Продолжить» — срабатывает сразу, как только блок получил сообщение и начал готовить ответ. Ответа он не ждёт. Когда ответ готов, контакт возвращается в блок «AI-агент» и получает его. Если выход не соединён, контакт просто ждёт ответа в блоке.

Важно

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

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

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

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

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

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

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

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

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

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

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

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