Документация

Руководство пользователя

Всё необходимое для настройки ИИ-агентов, управления командой и подключения каналов коммуникации.

Создание агента

Агент — это ваш ИИ-помощник. Создайте его за несколько минут и сразу начните принимать обращения.

Пошаговый процесс

1

Откройте рабочее пространство

На главной странице платформы выберите нужное рабочее пространство или создайте новое.
2

Нажмите «Создать агента»

Кнопка находится в правом верхнем углу страницы агентов. Если достигнут лимит тарифа, кнопка будет неактивна.
3

Выберите тип агента

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

Заполните основные параметры

Укажите имя агента, описание и выберите языковую модель. В настройках (Настройки → Общее) можно в любой момент изменить название, описание и системный промпт.
5

Добавьте источники знаний

Перейдите в раздел «Источники» и загрузите документы, текст, ссылки на сайт или Q&A-пары. Чем больше релевантного контента — тем точнее ответы агента.
6

Запустите обучение

Нажмите «Обучить агента». После завершения статус сменится на Active.
7

Протестируйте в Playground

Раздел Playground позволяет пообщаться с агентом до публикации и убедиться в корректности ответов.

После создания агент находится в статусе Warning до тех пор, пока не добавлены источники и не завершено обучение. Агент получает статус Active, когда есть хотя бы один активный канал публикации и диалоги за последние 24 часа.

Пользователи и роли

Управляйте командой: добавляйте коллег и назначайте права в разделе Пространство → Участники.

Admin
  • Создание и настройка агентов
  • Управление источниками
  • Настройка интеграций
  • Просмотр аналитики
  • Управление каналами публикации
  • Добавление и удаление участников
Member
  • Просмотр агентов
  • Просмотр диалогов
  • Работа в Playground
  • Просмотр аналитики
  • Без доступа к биллингу

Добавление участника

1

Откройте Пространство → Участники

В боковом меню рабочего пространства нажмите «Участники».
2

Нажмите «Добавить участника»

Введите e-mail коллеги и выберите роль: Участник или Администратор.
3

Дождитесь регистрации

Коллега получит письмо со ссылкой. После входа в систему он сразу появится в списке участников.

Роль и статус (активен/неактивен) можно изменить в любой момент через меню «⋮» напротив участника. Неактивный участник сохраняется в списке, но теряет доступ к платформе.

Операторы

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

Где настраивать

Все настройки операторов находятся в Пространство → Настройки → Операторы. Настройки автопередачи для конкретного агента — в Агент → Настройки → Общее.

График работы

Укажите рабочие часы и часовой пояс. В нерабочее время агент отправляет сообщение об отсутствии.

Стратегия назначения

Least-busy — новый диалог получает наименее загруженный оператор. Round-robin — по кругу.

Telegram-уведомления

Введите Bot Token и Chat ID, проверьте подключение кнопкой «Тест». Оператор получает уведомление мгновенно.

Email-уведомления

Включите переключатель, чтобы дополнительно отправлять письмо при переводе на оператора.

Автоматический перевод на оператора

В разделе Агент → Тестирование активируйте опцию «Автопередача оператору». Готовый промпт уже установлен по умолчанию, однако при необходимости вы можете отредактировать его, указав конкретные сценарии или триггеры для переключения диалога на человека.

Если клиент: — явно просит поговорить с человеком или оператором, — жалуется и недоволен после второго ответа, — задаёт вопрос, на который у тебя нет ответа — переведи диалог на оператора.

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

Диалоги

Просматривайте историю общения, фильтруйте по статусу и отслеживайте обращения клиентов.

Раздел «Диалоги» доступен для каждого агента: Агент → Диалоги.

Просмотр истории

Каждый диалог содержит полную переписку, метки времени, источник канала (виджет, Telegram, API и т.д.) и использованные инструменты.

Аналитика диалогов

Перейдите в Агент → Аналитика, чтобы увидеть количество диалогов за период, среднюю длину сессии и другие метрики.

Тикеты и заявки

Агент поддержки создаёт тикеты автоматически. Просматривайте их в разделе Агент → Заявки.

Переводы на оператора

В диалоге видна точка переключения: где агент передал управление оператору и по какому условию.

Каналы публикации

Разместите агента там, где находятся ваши клиенты — на сайте, в мессенджерах или через API.

Все каналы настраиваются в разделе Агент → Публикация.

Веб-виджетПопулярный

Чат-кнопка на вашем сайте. Настройте цвет, приветственное сообщение и положение кнопки. Вставьте один тег <script> в HTML-код сайта.

Telegram

Создайте бота через @BotFather, вставьте Bot Token. Клиенты общаются прямо в Telegram — без установки дополнительных приложений.

REST APIДля разработчиков

Встройте агента в своё приложение через HTTP API. Раздел Deploy → API содержит ключ, документацию и примеры запросов.

MAX

Публикация на платформе MAX. Используйте, если ваша аудитория активна в экосистеме VK Business.

Один агент можно опубликовать одновременно в нескольких каналах. Статистика по каждому каналу отображается в разделе Аналитика.

Обучение агента

Качество ответов напрямую зависит от базы знаний. Добавьте источники — и агент будет отвечать на основе ваших данных.

Типы источников

Файлы

PDF, DOCX, TXT, CSV — загружайте документы, инструкции, каталоги товаров, прайсы.

Текст

Вставьте текст напрямую — например, FAQ, описание компании или регламент.

Сайт

Укажите URL — агент проиндексирует страницы вашего сайта автоматически.

Q&A

Добавьте пары «вопрос — ответ». Идеально для типичных обращений в поддержку.

Процесс обучения

1

Агент → Обучение — добавьте источники

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

Запустите обучение

Нажмите кнопку «Обучить агента». Процесс занимает от нескольких секунд до нескольких минут в зависимости от объёма данных.
3

Дождитесь статуса «Обучен»

Страница обновится автоматически. Если статус Требуется переобучение — добавились новые источники, запустите обучение повторно.
4

Проверьте в Playground

Задайте несколько вопросов из вашей тематики. Если ответы неточные — дополните источники или уточните промпт.

При обновлении материалов (новый прайс, изменение условий) обязательно переобучите агента — иначе он будет отвечать по устаревшим данным. Иконка предупреждения на карточке агента сигнализирует о необходимости переобучения.

Интеграции

Свяжите агента с CRM, платёжными системами и другими сервисами, чтобы автоматизировать бизнес-процессы.

Доступные интеграции

Настройка: Агент → Настройки → Интеграции

Bitrix24AmoCRMRetailCRMYookassaRobokassaYandex Trackerи др

Как подключить (пример: Bitrix24)

1

Получите Webhook URL в Битрикс24

Перейдите в Битрикс24 → Приложения → Вебхуки → Добавить входящий вебхук.
2

Откройте настройки интеграции

Агент → Настройки → Интеграции → Битрикс24 → Настроить.
3

Вставьте URL и сохраните

После сохранения статус интеграции изменится на Активна.
4

Настройте действия агента

В разделе Агент → Действия создайте действие: например, «Создать лид» или «Создать сделку» — и укажите, при каких условиях агент должно его выполнять.

Интеграции с CRM работают через Действия. Убедитесь, что у пользователя Битрикс24/AmoCRM, чей вебхук вы используете, есть права на создание лидов и сделок.

Защита персональных данных

AgentQ автоматически маскирует чувствительные данные клиентов перед отправкой языковой модели — в соответствии с 152-ФЗ.

Какие данные защищаются

EMAILадрес электронной почты
PHONEномер телефона
FULL_NAMEполное имя (ФИО)
ADDRESSпочтовый адрес
PASSPORTсерия и номер паспорта
INNИНН физического лица
SNILSномер СНИЛС
CARD_NUMBERномер банковской карты

Как включить

1

Перейдите в настройки агента

Агент → Тестирование — найдите блок «Защита персональных данных».
2

Включите защиту и выберите типы

Активируйте переключатель и отметьте типы данных, которые нужно маскировать. Например, для службы поддержки достаточно EMAIL + PHONE.
3

Сохраните изменения

Маскировка начнёт работать немедленно, без переобучения агента. Данные заменяются токеном (например, [EMAIL]) до отправки в модель.

Типы агентов

Каждый тип оптимизирован под конкретный бизнес-сценарий и открывает соответствующие разделы и интеграции.

Все типы используют одинаковые базовые разделы: Тестирование, Обучение, Аналитика, Публикация, Действия, Настройки. Ниже описаны только отличия каждого типа.

Агент поддержки

support

Сценарии

  • Ответы на вопросы по продукту
  • Приём и трекинг тикетов
  • Эскалация на оператора
  • И другие возможности

Потоки (flows)

  • support

Уникальные настройки

  • Создание тикетов
  • Автоперевод на оператора
  • Уведомления оператора

Агент продаж

sales

Сценарии

  • Квалификация входящих лидов
  • Презентация продуктов/услуг
  • Запись на встречу / отправка КП
  • Создание сделок в CRM

Потоки (flows)

  • sales_services

Уникальные настройки

  • Создание лидов / сделок в CRM
  • Настройка полей для сбора данных
  • Интеграция с CRM
  • Управление каталогом услуг

Агент записи

booking

Сценарии

  • Запись на приём, консультацию
  • Управление слотами и расписанием
  • Напоминания клиентам
  • Назначение сотрудника

Потоки (flows)

  • booking

Уникальные настройки

  • Управление услугами
  • Расписание сотрудников
  • Журнал записей
  • Интеграции

Агент интернет-магазина

ecommerce

Сценарии

  • Помощь с выбором товара
  • Управление корзиной
  • Оформление и оплата заказа
  • Статус и история заказов

Потоки (flows)

  • sales_products

Уникальные настройки

  • Каталог товаров и корзина
  • Интеграция с CRM
  • Платёжные системы
  • Отслеживание заказов

Не нашли ответ? Наш ИИ-консультант готов помочь — нажмите на кнопку чата в правом нижнем углу.

Вернуться на главную