Кондуктор
На главную Разобрать свой файл

Разработчикам: Кондуктор перед языковой моделью

Клиент пишет в чат — запрос сначала идёт в Кондуктор. Он за 20–35 мс решает, что делать с обращением: ответить самому, взять готовое из кэша, позвать человека или отдать языковой модели. Языковая модель получает только то, что Кондуктор не смог решить сам, — на этом и экономия.

20–35 мс
решение на сообщение
0,42 ₽
стоит то же сообщение через модель ИИ
0 ₽
стоит решение Кондуктора
0,7
порог уверенности: ниже — спорное, уходит человеку

Что здесь делают

Эта страница — мастерская. Здесь можно посмотреть, скачать, поставить у себя и попробовать: готовые чаты для сайта (свободные, в том числе для коммерции), примеры врезки и живая проба прямо на этой странице.

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

Что внутри нашего движка — не рассказываем: этого достаточно, чтобы им пользовались, и не нужно, чтобы его повторяли. Здесь только то, что нужно для врезки.

1. Один запрос — одно решение

POST https://konduktor.online/api/route
Content-Type: application/json

{"текст": "где мой заказ, третью неделю жду"}

В ответ приходят четыре решения и готовый ответ для покупателя:

{
 "поля": {
 "нужно_отвечать": {"решение": "ДА", "уверенность": 0.93},
 "кто_отвечает": {"решение": "МОДЕЛЬ", "уверенность": 0.81},
 "тема": {"решение": "ДОСТАВКА", "уверенность": 0.88},
 "срочность": {"решение": "НИЗКАЯ", "уверенность": 0.74}
 },
 "решаем_сами": true,
 "спорные": [],
 "время_мс": 27.4,
 "обезличено": false,
 "цена_модели": 0.42
}
Демонстрация механики выбора

Змейка: один ход — одно решение

Змейка показывает формат решения: состояние → признаки → выбор одного действия. Это наглядная демонстрация, а не тест маршрутизации клиентских сообщений и не обещание точности или экономии. В рабочем сценарии вопрос, признаки, порог и действие задаются под вашу задачу.

Та же змейка живьём на нашем сервере — счёт растёт без посетителей: открыть страницу змейки.

Змейка использует чатовый роутер?

Нет. Это отдельная локальная демонстрация механики выбора между вариантами. Метрики чата и тест змейки показаны раздельно, чтобы не выдавать одно за другое.

Значения текущего хода рассчитываются в браузере из состояния поля. Скорость — время функции выбора, а не задержка сервера и не время ответа LLM. Параметры каждого хода показаны в таблице; искусственного потока чата здесь нет.

Что показывает змейка

Меняется состояние — видны конкретные параметры.

Поле задаёт текущую ситуацию. Код формирует допустимые ходы, модель сравнивает их и выбирает направление. В журнале остаются именно решения: ход, цель, расстояние и оценка — не случайные карточки с выдуманными цифрами.

01 / СОСТОЯНИЕ

Где змейка и цель

Положение головы, кубика и занятых клеток читается из текущего поля.

02 / ПАРАМЕТРЫ

Что даст каждый ход

Для варианта считаются: съест ли кубик, сколько останется по кольцу и длина прыжка.

03 / РЕШЕНИЕ

Какой вариант выбран

Показываются выбранное направление, оценка и измеренное время вычисления на этом устройстве.

Отдельный контрольный скрипт прошёл 200 партий по 50 кубиков: всего 10 000 кубиков, 0 столкновений, в среднем 19,84 хода на кубик. Код заранее исключает недопустимые ходы, поэтому ноль столкновений относится к этой конструкции и тесту — это не гарантия для произвольных задач.

2. Что делать по решению

ответ Кондукторачто делает ваш код
МОДЕЛЬответ можно отдать покупателю сразу (готовый ответ лежит в поле ответ); языковую модель не звать
КЭШтакое обращение уже было — берём готовый ответ из кэша, токены не тратим
ЧЕЛОВЕКтакое обращение сразу уходит живому оператору; покупатель слышит «одну минуту, сейчас позову оператора»
НЕТотвечать не нужно (спам, реклама) — в кэш служебных, не тратить ничего
спорныеКондуктор не решает сам: спорное отдавайте языковой модели или человеку — как у вас принято

3. Схема врезки

клиент пишет в чат
 │
 ├─► Кондуктор /api/route 20–35 мс, 0 ₽
 │ ├── МОДЕЛЬ → ответ покупателю сразу
 │ ├── КЭШ → готовый ответ из своего кэша
 │ ├── ЧЕЛОВЕК → оператор
 │ └── спорное → ваша языковая модель (любая модель ИИ)
 │
 └─► языковая модель получает только спорное: токенов меньше в разы

4. Примеры кода

Python
import json, urllib.request

def решить(текст: str) -> dict:
 запрос = urllib.request.Request(
 "https://konduktor.online/api/route",
 data=json.dumps({"текст": текст}).encode("utf-8"),
 headers={"Content-Type": "application/json", "X-Key": "ваш-ключ"})
 return json.loads(urllib.request.urlopen(запрос, timeout=10).read())

р = решить("где мой заказ, третью неделю жду")
if р["поля"]["кто_отвечает"]["решение"] == "МОДЕЛЬ":
 отправить_покупателю(р["ответ"]) # без языковой модели
elif р["поля"]["кто_отвечает"]["решение"] == "ЧЕЛОВЕК":
 позвать_оператора()
else:
 отправить_в_языковую_модель() # только спорное
curl
curl -s https://konduktor.online/api/route \
 -H "Content-Type: application/json" \
 -H "X-Key: ваш-ключ" \
 -d '{"текст":"верните деньги, иначе подам в суд"}'

JavaScript — браузер или Node

const ответ = await fetch("https://konduktor.online/api/route", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ "текст": текстОбращения })
}).then(r => r.json());

const решение = ответ.сообщение.поля;
if (решение.кто_отвечает.решение === "ЧЕЛОВЕК"
    || решение.кто_отвечает.уверенность < 0.7) {
  передатьОператору(ответ.сообщение);
} else {
  отправитьОтвет(ответ.сообщение.ответ);
}

PHP

<?php
$запрос = curl_init("https://konduktor.online/api/route");
curl_setopt_array($запрос, [
  CURLOPT_POST => true,
  CURLOPT_HTTPHEADER => ["Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(["текст" => $обращение], JSON_UNESCAPED_UNICODE),
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT => 10,
]);
$ответ = json_decode(curl_exec($запрос), true);
$решение = $ответ["сообщение"]["поля"]["кто_отвечает"];

if ($решение["решение"] === "ЧЕЛОВЕК" || $решение["уверенность"] < 0.7) {
    передать_оператору($ответ["сообщение"]);
} else {
    отправить_ответ($ответ["сообщение"]["ответ"]);
}

Что возвращает служба

Ответ — обычный JSON: решение по обращению и уверенность к нему. Разбирайте по полю поля, по нему же принимается решение с порогом на вашей стороне.

{
  "сообщение": {
    "текст": "Здравствуйте, когда придёт мой заказ? Заказ 12345",
    "кто": "ЧЕЛОВЕК", "сам": false, "мс": 27.3,
    "поля": {
      "нужно_отвечать": {"решение": "ДА",       "уверенность": 0.838},
      "кто_отвечает":   {"решение": "ЧЕЛОВЕК",  "уверенность": 0.656},
      "тема":           {"решение": "ДОСТАВКА", "уверенность": 0.599},
      "срочность":      {"решение": "ВЫСОКАЯ",  "уверенность": 0.678}
    },
    "ответ": "Одну минуту, сейчас позову оператора.",
    "магазину": "Тема: доставка, срочность: высокая. Магазину: назвать срок и номер отправления."
  },
  "счёт": {"всего": 10648, "сам": 6701, "человеку": 3827, "кэш": 120, "средний_мс": 54.7}
}

Как проверить, не врезаясь в свой чат

Два способа, оба без правки вашего проекта. Первый: страница «Разобрать свой файл» — выгрузка до 1 000 сообщений разбирается бесплатно, на выходе таблица с решениями. Второй: тот же адрес /api/route, но на своём тестовом тексте — можно звать из консоли или Postman.

Ошибки и частые промахи

{"ошибка": "пустое сообщение"}

Так отвечает служба, если текст пустой или поле названо неверно. Поле называется текст — не «сообщение», не «text», не «message»: при чужом имени служба видит пустую строку и отвечает отказом. Это самая частая ошибка при первой врезке.

Ответ всегда разбирайте по поля, а не по верхнему кто: верхнее поле — итог для быстрого показа, а поля.кто_отвечает.уверенность — то, по чему принимается решение с порогом.

5. Что нужно для подключения

шагкто делает
ключ и адрес для вашего магазинамы выдаём, ключ привязан к вашему домену
порог уверенности (по умолчанию 0,7)вы: выше порог — больше уходит человеку, ниже — больше решает модель
свой кэш готовых ответоввы или мы: Кондуктор берёт ответы оттуда, когда обращение повторяется
свои правила (деньги, суд — всегда человек)вы: правила задаются на вашей стороне, модель их не перебивает

Чаты для сайта: что поставить и чем встроить

Обычный вопрос: посетитель не хочет звонить и не хочет заполнять форму — ему нужно написать. Здесь собраны бесплатные варианты и то, чем они по-настоящему различаются.

Первое и главное: выглядит у всех почти одинаково. Разница не в картинке, а в двух вещах — где живут данные и кто отвечает. Поэтому сначала три типовые компоновки, потом сравнение вариантов.

Кнопка в углусамый частый вид: круглая кнопка, по клику раскрывается панель переписки
Полоса снизупросьба написать стоит на виду всегда: тонкая полоса внизу экрана
Кнопка «перезвоните»не чат, а обратный звонок: имя и телефон, менеджер звонит сам

Схемы нарисованы нами, чтобы показать разницу в компоновке: чужой графики на странице нет.

Бесплатные варианты и где живут данные

вариантбесплатногде данныекому подходит
ВКонтакте
«Сообщения сообщества»
бесплатноРоссиямагазин, который и так ведёт сообщество ВК
Telegram
кнопка-ссылка на t.me
бесплатноваш каналаудитория уже в Telegram, чужой скрипт не нужен
Chatwoot
на своём сервере
бесплатно (лицензия MIT)ваш серверкогда важны свои данные и полный контроль
LiveHelperChat
на своём сервере
бесплатно (лицензия Apache-2.0)ваш сервернужен готовый кабинет оператора
Наш вариант
Кондуктор + чат
чат любой из списка, Кондуктор — по работе под вассервер в Россиинужно, чтобы отвечал сам, а не ждал оператора

Код вставки

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

Telegram — обычной кнопкой-ссылкой, без чужого скрипта вообще:

<a class="кнопка-в-телеграм" href="https://t.me/ВАШ_КАНАЛ"
   target="_blank" rel="noopener">Написать в Telegram</a>

ВКонтакте виджет сообщений ставится через их Open API или SuperAppKit SDK — код выдаётся в кабинете сообщества, там же выбирается вид.

Готовый чат из раздела «Скачать» ставится своей строкой — заметьте тип скрипта, иначе браузер его не выполнит:

<script type="module" src="/chat/deep-chat.bundle.js"></script>
<deep-chat id="чат" style="height:420px"></deep-chat>
<script type="module">
  await customElements.whenDefined("deep-chat");
  const чат = document.getElementById("чат");
  чат.demo = false;                       // иначе компонент отвечает своим примером
  чат.connect = { handler: async ({ messages }, сигналы) => {
    const текст = messages.filter(м => м.role === "user").pop().text;
    const ответ = await fetch("/api/route", {
      method: "POST", headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ "текст": текст })
    }).then(r => r.json());
    сигналы.onResponse({ text: ответ.сообщение.ответ });
  } };
</script>

Проверять чат надо на телефоне: на маленьком экране виджет закрывает кнопки и мешает читать. Ставьте его так, чтобы он не перекрывал форму заявки.

Чем отличается наш вариант

Любой из этих чатов — только канал: сообщение приходит, и его кто-то должен прочитать. Мы ставим перед ним Кондуктора: он отвечает сам, а спорное и денежное превращает в заявку и отправляет оператору или владельцу. Чат при этом можно взять бесплатный из списка выше — платить за сам чат не нужно.

Вопросы разработчика

Кондуктор сам пишет ответы клиенту?

Нет. Его работа — решить, что делать с обращением: ответить готовым из кэша, отдать человеку, позвать языковую модель. Готовый текст ответа приходит в поле ответ, но генерация — задача подключённой модели, если вы её включаете.

Нужен ли SDK или библиотека?

Нет, и это намеренно: обычный HTTP/JSON работает из любого языка — Python, PHP, JavaScript, Go, 1С. Ничего ставить не нужно, кроме умения отправить POST.

Сколько стоит вызов?

Решение Кондуктора считается на нашем сервере и стоит 0 ₽ за вызов. Плата появляется только если решение ушло языковой модели — тогда считается её стоимость, и это видно в счёте.

Можно ли поставить Кондуктора на свой сервер?

Модель маленькая (1,4 МБ) и работает на обычном процессоре, но сейчас врезка идёт по нашему адресу. Своя установка — отдельная договорённость, обсуждается голосом: обещать «поставим куда угодно» заранее не будем.

Обязательные поля и частые промахи?

Обязательное поле одно — текст. Если назвать его иначе (сообщение, text, message), служба ответит {"ошибка": "пустое сообщение"}: она видит пустую строку. Смотрите разбор ошибок выше.

Что с персональными данными?

Текст обезличивается до обработки: телефоны, почты и номера документов заменяются метками. Серверы в России, персональные данные за пределы РФ не уходят. Для потока сообщений магазина мы не запрашиваем ФИО и адреса — модели решений они не нужны.

Как понять, что врезка получилась?

Прогоните сто своих сообщений через /api/route и посмотрите долю кто_отвечает = ЧЕЛОВЕК. Если она выше, чем вы ожидали, — поднимайте порог или задавайте правила на своей стороне: это настройка, а не дефект.

Скачать

Копии лежат у нас — искать по GitHub не нужно. Лицензия рядом с файлом: отдаём как есть, внутрь не лезем, поэтому и лицензии соблюдены.

файлчто эторазмерлицензиявзять
deep-chat.bundle.jsокно чата: пузыри, поле ввода, индикатор «печатает»; подключается к любому вашему адресу387 КБMIT — коммерция разрешенаскачать · лицензия
deep-chat.jsта же библиотека, но сборка для проектов со сборщиком (npm/ESM)766 КБMITскачать
intergram.jsчат, связанный с Telegram: посетитель пишет на сайте, сообщение падает вам в мессенджер24 КБMPL-2.0 — коммерция разрешенаскачать · лицензия

Если нужен целый кабинет поддержки

Это не файлы, а серверные программы: ставятся на свой сервер, виджет чата идёт в комплекте. Лицензии позволяют коммерческое использование.

программалицензиячем интересна
ChatwootMIT (ядро)кабинеты операторов, каналы, история — самый известный свободный аналог платных чатов
LiveHelperChatApache-2.0живой чат на PHP: ставится на обычный хостинг, без сложной инфраструктуры
Rocket.ChatMIT (ядро)целая система общения, чат на сайт — один из каналов

Попробовать здесь же

Ниже — демо-режим: стенд в том же виде, что увидит покупатель. Пишите как покупатель, нажимайте отправить и смотрите: что ответит Кондуктор, кто отвечает — он сам, оператор или готовый ответ магазина из кэша — и сколько времени заняло решение. Слева чат покупателя, справа настройки, которыми разработчик этот чат крутит: скорость ответа, подписи, служебная строка. Всё считается нашим живым адресом — тем же, который вы получите при подключении.

Чат покупателяответы приходят от нашей службы

6. Проверка на своём объёме

Прежде чем врезаться в боевой чат, прогоните свой массив обращений на странице «Разобрать свой файл»: первый объём до 1 000 сообщений — бесплатно, на выходе таблица решений. Так видно, сколько обращений Кондуктор возьмёт на себя и сколько останется языковой модели.

152-ФЗ соблюдаем. Текст обезличивается до обработки: телефоны, почты и номера документов заменяются метками. Серверы в России, персональные данные за пределы РФ не уходят. Для потока сообщений магазина мы не запрашиваем ФИО и адреса — они не нужны модели решений.