Запуск агента и проверка ответов
Как поставить агента в чат-бот, проверить его ответы до запуска и следить за его работой в статистике и журнале.
Перед запуском
- Агент включён: в шапке агента переключатель стоит на «Включён». Новый агент включён сразу, копия — выключена.
- На схеме нет списка «Чтобы агент заработал»: выбраны подключение и модель, описана роль.
- Вы проверили ответы в окне проверки (ниже).
Ставим агента в бота
- Откройте Коммуникации → Чат-боты и нужного бота.
- Добавьте шаг «AI-агент» с панели шагов и соедините его стрелкой с предыдущим шагом.
- Нажмите на шаг и в поле «AI-агент» выберите агента.
- Соедините выходы шага со следующими шагами: «цель достигнута», «менеджеру», «ошибка или лимит».
- Нажмите «Опубликовать».
Подробно о конструкторе — в статье Чат-бот: первое знакомство, о том, когда бот запускается, — в статье Как запускается бот.
Настройки шага
| Поле | Что значит |
|---|---|
| «Первое сообщение» | Уйдёт клиенту при входе в шаг: «Здравствуйте, %username%! Я помогу подобрать услугу». Пусто — агент молча ждёт вопроса. |
| «Сразу ответить на последнее сообщение клиента» | Агент ответит на сообщение, с которого начался бот (если оно пришло за последние 15 минут), а не будет ждать следующего. Полезно, если бот запускается ключевым словом. |
| «Клиент молчит» | Сколько ждать ответа клиента: от «10 минут» до «7 дней» или «Ждать всегда». Если время задано, появится выход «клиент молчит» — например, для напоминания. |
| «Ответов за разговор» | Свой лимит для этого шага. Пусто — как в настройках агента. |
Куда ведут выходы:
- «цель достигнута» — агент выполнил задачу. Дальше удобно создать сделку и уведомить менеджера.
- «менеджеру» — агент решил позвать человека; сотрудникам придёт уведомление.
- «клиент молчит» — клиент не ответил за заданное время.
- «ошибка или лимит» — нейросеть недоступна, агент выключен или исчерпан лимит. Текст ошибки — в переменной
{%agent_error%}.
Неподключённый выход завершает бота. Исключение — ошибка нейросети: если выход «ошибка или лимит» не подключён, клиент получит «Запасной ответ» из настроек агента, а агент будет ждать следующего сообщения. При исчерпанном лимите бот без этого выхода просто завершится.
Как агент отвечает
Клиент пишет — агент начинает думать, а клиент в это время видит «печатает…». Агент читает последние сообщения переписки, базу знаний и отвечает. Если клиент написал несколько сообщений подряд, агент ответит на все одним сообщением. Если нейросеть не уложилась в 110 секунд, ход считается ошибкой («Агент не успел ответить: закончилось время хода»).
Живой разговор важнее: если менеджер ответил клиенту, пока агент думал, агент свой ответ не отправит. А если менеджер поставил ботов на паузу из диалога, агент молчит до конца паузы. Подробнее — в статье Диалоги в команде.
Проверка ответов
Окно проверки. На схеме агента нажмите «Проверить» и пишите как клиент. Проверка идёт по сохранённой версии агента — несохранённые правки в ней не участвуют. Имя клиента для проверки — слева вверху окна, его можно поменять. Переключатель «Интеграции» рядом включает и выключает настоящие вызовы ваших сервисов, «Заново» начинает разговор с начала. Под каждым ответом — модель, время, токены и ссылка «как ответил»: какие фрагменты базы знаний и инструменты понадобились. Путь ответа подсвечивается на схеме. Клиентам ничего не уходит, токены расходуются. Проверочных сообщений — не больше 200 в час на проект.
Тест бота. Кнопка «Тестирование» в конструкторе бота запускает бота по черновику для тестировщика — например, для вас самих: бот напишет вам в мессенджер, а агент ответит по-настоящему. Так видно, как агент работает вместе со сценарием. Подробно — в статье Тестирование, публикация и воронка.
Статистика и журнал
На странице агента две вкладки:
- «Статистика» — за 30 дней: «Ответов клиентам», «Цель достигнута», «Передано менеджеру», «Ошибок», «Токенов» и «Расход», график «Ответы по дням». Ответы, цели и передачи менеджеру считаются только по настоящим разговорам в ботах. Токены, расход и ошибки — вместе с окном проверки и тестом бота: деньги у провайдера тратятся и там.
- «Журнал» — каждый ответ агента: что написал клиент, что ответил агент, чем закончилось, сколько стоило. Фильтры — по исходу («Цель достигнута», «Передан менеджеру», «Ошибка», «Лимит»…) и по источнику: «Только боты» или «Только проверка». Нажмите на запись — откроется «Ход агента» с кнопкой «Диалог». Журнал хранится 30 дней.
На главной странице раздела AI-агенты — сводка за месяц: ответы, токены и объём баз знаний.
Расходы и квоты
- За ответы нейросети вы платите провайдеру напрямую. Чтобы видеть расход в рублях, укажите цены в подключении — см. Подключение нейросети.
- Каждый ответ агента клиенту — это сообщение бота: он расходует суточный лимит сообщений тарифа. Окно проверки и тест бота лимит не тратят.
- Агентов в проекте: на бесплатном тарифе — до 2, на платных — до 50. Подробно — в статье Тариф и лимиты.
Частые вопросы
Агент не отвечает клиентам. Что проверить?
Агент включён и настроен, бот опубликован, клиент дошёл до шага «AI-агент». В журнале агента посмотрите ошибки: чаще всего это баланс у провайдера или неверный ключ. Ещё причина — пауза ботов в диалоге: снимите её кнопкой «Возобновить ботов».
Кто узнает, что агент позвал менеджера?
Сотрудники проекта, у которых включено уведомление «AI-агент передал разговор менеджеру», — по умолчанию оно включено у модераторов и выше. Настроить его можно в меню аккаунта → «Уведомления». Подробно — в статье Уведомления о событиях.
Можно поставить одного агента в несколько ботов?
Да, в любые боты проекта и в любые каналы: ВКонтакте, Telegram и МАКС. Список ботов виден на странице агента в строке «В ботах».