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

Как устроен llmagent

Что делает AI-агент, из каких частей состоит продукт и что в каком разделе кабинета настраивается.

llmagent — это AI-агент, который отвечает вашим клиентам в Битрикс24, Telegram и MAX. Ответы он строит не «из головы», а по вашим данным: базе знаний из документов компании и каталогу товаров. Когда вопрос выходит за рамки его компетенции, агент передаёт диалог живому оператору.

Всё управление — в кабинете app.llmagent.ru: вы загружаете знания, подключаете каналы, смотрите переписки и метрики. Писать код не нужно.

У агента три составляющие, и все три вы настраиваете сами:

  • Данные — база знаний (документы, инструкции, FAQ) и каталог товаров (YML-фид). База знаний индексируется векторным поиском, каталог — поисковым индексом по названиям, ценам и категориям.
  • Поведение — имя агента, инструкция (системный промпт), правила работы с оператором и показ источников. Задаётся в «Настройках».
  • Каналы — точки входа, где клиенты пишут агенту: открытые линии Битрикс24, Telegram-бот, MAX-бот.

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

В Битрикс24 агент доступен не только клиентам через открытые линии, но и сотрудникам — напрямую в чате портала с ботом агента.

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

Раздел Зачем нужен
База знаний Документы, по которым агент отвечает: файлы, тексты, ссылки, Google-документы. Подробнее — «База знаний».
Каталог товаров Публичная ссылка на YML-каталог и его индексация, чтобы агент знал цены, наличие и ссылки на карточки. Подробнее — «Каталог товаров».
Каналы Подключение точек входа: открытая линия Битрикс24, Telegram, MAX — и статистика по каждому каналу. Подробнее — «Каналы».
Навыки Дополнительные умения агента — например, саммари диалога или постановка задач из чата в Битрикс24. Подробнее — «Навыки».
Диалоги Реальные переписки клиентов с агентом по всем каналам, включая моменты передачи оператору. Подробнее — «Диалоги и передача оператору».
Аналитика Метрики работы: сообщения и диалоги в разрезе каналов, выгрузка в Excel. Подробнее — «Аналитика».
Настройки Поведение агента (имя, инструкция, оператор, источники ответов), данные организации и личные настройки. Подробнее — «Настройки».
Тарифы / пополнить Текущий тариф, остаток запросов, выставление счетов. Подробнее — «Тарифы».

Порядок и видимость вкладок можно менять под себя: пункт «Управление вкладками» в меню профиля. Раздел «Тарифы / пополнить» всегда остаётся внизу меню.

В одном кабинете может жить несколько агентов — например, отдельный для продаж и отдельный для поддержки. У каждого агента свои база знаний, каталог, каналы и навыки; разделы кабинета всегда показывают данные текущего агента. Переключатель «Текущий агент» находится в правом верхнем углу, там же — «Управление агентами» для создания и удаления. Сколько агентов доступно, зависит от тарифа.

Два способа:

  • Через Битрикс24 — основной путь. Вы устанавливаете приложение из маркетплейса, и кабинет открывается прямо в портале; вход подтверждает сам Битрикс24, пароль не нужен. Как это происходит — в статье «Канал Битрикс24».
  • Самостоятельная регистрация — на app.llmagent.ru по email и паролю, если вы не используете Битрикс24. Агент создаётся сразу при регистрации.

Пройдите быстрый старт — от установки приложения до первого ответа агента клиенту.