Перейти к содержимому
llmagentLLM-Агент Документация

Настройки агента

Имя и инструкции агента, работа с оператором, показ источников, сбор контактов — и как проверить агента в тестовом чате до запуска на клиентах.

Раздел «Настройки» управляет поведением агента и данными организации. Здесь вы задаёте, как агент представляется, каким инструкциям следует, когда зовёт оператора и какие данные собирает у клиента. Настройки разделены на три области — переключатели вверху страницы: «Агент», «Организация» и «Личные».

Область «Агент» относится к текущему активному агенту (он показан в правом верхнем углу кабинета). На вкладке «Общие» доступны:

Имя агента — до 120 символов. Отображается в чатах и каналах; при переименовании бот в Битрикс24 переименовывается автоматически.

Системный промпт — ваша инструкция агенту, до 2000 символов. Определяет роль, тон и правила ответов: кто агент, как обращаться к клиентам, что рекомендовать и чего избегать. Инструкция накладывается поверх базовых правил платформы и действует в каждом ответе; факты для ответов агент при этом берёт из базы знаний и каталога, а не из промпта. Как инструкция встраивается в подготовку ответа — в статье «Как агент готовит ответ».

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

Показывать источники ответов — когда агент отвечает по базе знаний, под ответом появляется ссылка на документ-источник. Три варианта: «Никому», «Сотрудникам» (внутренние чаты — сотрудники, пишущие боту в Битрикс24 или в кабинете), «Всем» (включая клиентов в открытых линиях и каналах).

Информация для сбора — список данных, которые агент запросит у клиента в начале диалога: имя и фамилия, телефон, e-mail, город и любые свои варианты.

Для аккаунтов из Битрикс24 на вкладке «Аватар» можно загрузить картинку бота — PNG, JPG, GIF или WEBP. Она показывается в чатах Битрикс24 от лица бота. При переустановке приложения аватар может вернуться к стандартному — тогда просто загрузите его заново.

Область «Организация» — общие данные аккаунта, действуют на всех агентов:

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

Область «Личные» — профиль (для Битрикс24 показываются имя и признак администратора) и тема кабинета: светлая или тёмная.

Прежде чем выпускать агента на клиентов, проверьте его в разделе «Чат» — он открывается сразу после входа, новый диалог создаёт кнопка «Новый чат» в боковой панели. Агент отвечает здесь ровно с теми же настройками, базой знаний, каталогом и навыками, что и в каналах — что вы видите в тестовом чате, то получат и клиенты.

  1. Сохраните изменения в «Настройках» кнопкой «Сохранить».

  2. Откройте «Новый чат» и задайте 5–10 реальных вопросов клиентов: о товарах, условиях, ценах. Пишите так, как пишут клиенты, — с опечатками и без контекста.

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

  4. Слабый ответ — это сигнал: уточните промпт или дополните базу знаний, затем повторите вопрос в новом чате.