Агенты

Агент — это бот для ваших клиентов: отвечает на вопросы по вашей базе знаний, пользуется подключёнными MCP-интеграциями (заказы Ozon, CRM Битрикс24 и др.) и зовёт живого оператора, когда не справляется. Конструктор — в кабинете. Платформа бесплатна: вы платите только за токены модели по обычному прайсу Neurly.

Как создать агента за 5 минут

  1. Создайте агента и опишите его задачу обычным языком — кнопка «Развернуть в промпт» соберёт системный промпт за вас.
  2. Добавьте базу знаний: вставьте текст (FAQ, условия доставки, прайс) или загрузите файлы .txt/.md/.csv.
  3. Проверьте агента в песочнице справа от настроек — под каждым ответом виден лог инструментов и стоимость.
  4. Нажмите «Опубликовать» и подключите каналы.

Канал: Telegram

  1. Создайте бота у @BotFather (команда /newbot) и скопируйте токен.
  2. Вставьте токен в разделе «Каналы» агента — вебхук настроится автоматически.
  3. Напишите своему боту /owner КОД (код показан в кабинете) — эскалации будут приходить вам.

Когда агент не справляется или клиент просит человека, бот передаёт диалог вам: присылает причину и сводку разговора, замолкает и пересылает вам новые сообщения клиента. Ответить клиенту: /reply НОМЕР текст (уйдёт от имени бота с пометкой «Оператор»), вернуть бота: /resume НОМЕР.

Как отвечать клиентам без Telegram

Эскалации всегда видны на странице «Диалоги» агента (бейдж «у оператора»). Откройте диалог — там форма ответа оператора и кнопка «Вернуть бота». Клиент в виджете увидит ваш ответ прямо в чате на сайте; клиент в Telegram — сообщением от бота. Telegram-привязка нужна только для мгновенных уведомлений, без неё функциональность та же.

Канал: виджет на сайт

Включите виджет в разделе «Каналы» и вставьте одну строку перед </body>:

<script src="https://neurly.ru/widget.js" data-agent="ВАШ_ТОКЕН" async></script>

Цвет кнопки настраивается атрибутом data-color="#16a34a". Защита баланса: настраиваемый дневной лимит расхода (по умолчанию 100 ₽/день) и не более 20 сообщений в минуту с одного IP.

API

Агента можно вызывать как обычную модель — OpenAI-совместимым запросом:

curl https://neurly.ru/v1/agents/ВАШ-СЛАГ/chat/completions \
  -H "Authorization: Bearer sk-neurly-..." \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "Когда доставите заказ 123?"}]}'

Ответ — стандартный chat.completion плюс блок neurly: conversation_id (передайте его в следующем запросе, чтобы продолжить диалог), cost_rub, iterations, escalated. Историю, инструменты и базу знаний ведёт сервер — присылайте только новое сообщение клиента.

Как агент думает