Где змейка и цель
Положение головы, кубика и занятых клеток читается из текущего поля.
Клиент пишет в чат — запрос сначала идёт в Кондуктор. Он за 20–35 мс решает, что делать с обращением: ответить самому, взять готовое из кэша, позвать человека или отдать языковой модели. Языковая модель получает только то, что Кондуктор не смог решить сам, — на этом и экономия.
Эта страница — мастерская. Здесь можно посмотреть, скачать, поставить у себя и попробовать: готовые чаты для сайта (свободные, в том числе для коммерции), примеры врезки и живая проба прямо на этой странице.
Начните с раздела «Чаты для сайта» — там варианты со схемами, лицензиями и кодом вставки. Файлы лежат у нас: скачать, распаковать, поставить. Если чат нужен вместе с автоответом — посмотрите «Попробовать здесь же»: там живой стенд.
Что внутри нашего движка — не рассказываем: этого достаточно, чтобы им пользовались, и не нужно, чтобы его повторяли. Здесь только то, что нужно для врезки.
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. Параметры каждого хода показаны в таблице; искусственного потока чата здесь нет.
Поле задаёт текущую ситуацию. Код формирует допустимые ходы, модель сравнивает их и выбирает направление. В журнале остаются именно решения: ход, цель, расстояние и оценка — не случайные карточки с выдуманными цифрами.
Положение головы, кубика и занятых клеток читается из текущего поля.
Для варианта считаются: съест ли кубик, сколько останется по кольцу и длина прыжка.
Показываются выбранное направление, оценка и измеренное время вычисления на этом устройстве.
Отдельный контрольный скрипт прошёл 200 партий по 50 кубиков: всего 10 000 кубиков, 0 столкновений, в среднем 19,84 хода на кубик. Код заранее исключает недопустимые ходы, поэтому ноль столкновений относится к этой конструкции и тесту — это не гарантия для произвольных задач.
| ответ Кондуктора | что делает ваш код |
|---|---|
| МОДЕЛЬ | ответ можно отдать покупателю сразу (готовый ответ лежит в поле ответ); языковую модель не звать |
| КЭШ | такое обращение уже было — берём готовый ответ из кэша, токены не тратим |
| ЧЕЛОВЕК | такое обращение сразу уходит живому оператору; покупатель слышит «одну минуту, сейчас позову оператора» |
| НЕТ | отвечать не нужно (спам, реклама) — в кэш служебных, не тратить ничего |
| спорные | Кондуктор не решает сам: спорное отдавайте языковой модели или человеку — как у вас принято |
клиент пишет в чат │ ├─► Кондуктор /api/route 20–35 мс, 0 ₽ │ ├── МОДЕЛЬ → ответ покупателю сразу │ ├── КЭШ → готовый ответ из своего кэша │ ├── ЧЕЛОВЕК → оператор │ └── спорное → ваша языковая модель (любая модель ИИ) │ └─► языковая модель получает только спорное: токенов меньше в разы
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 -s https://konduktor.online/api/route \
-H "Content-Type: application/json" \
-H "X-Key: ваш-ключ" \
-d '{"текст":"верните деньги, иначе подам в суд"}'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
$запрос = 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»: при чужом имени служба видит пустую строку и отвечает отказом. Это самая частая ошибка при первой врезке.
Ответ всегда разбирайте по поля, а не по верхнему кто: верхнее поле — итог для быстрого показа, а поля.кто_отвечает.уверенность — то, по чему принимается решение с порогом.
| шаг | кто делает |
|---|---|
| ключ и адрес для вашего магазина | мы выдаём, ключ привязан к вашему домену |
| порог уверенности (по умолчанию 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>
Проверять чат надо на телефоне: на маленьком экране виджет закрывает кнопки и мешает читать. Ставьте его так, чтобы он не перекрывал форму заявки.
Любой из этих чатов — только канал: сообщение приходит, и его кто-то должен прочитать. Мы ставим перед ним Кондуктора: он отвечает сам, а спорное и денежное превращает в заявку и отправляет оператору или владельцу. Чат при этом можно взять бесплатный из списка выше — платить за сам чат не нужно.
Нет. Его работа — решить, что делать с обращением: ответить готовым из кэша, отдать человеку, позвать языковую модель. Готовый текст ответа приходит в поле ответ, но генерация — задача подключённой модели, если вы её включаете.
Нет, и это намеренно: обычный 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 — коммерция разрешена | скачать · лицензия |
Это не файлы, а серверные программы: ставятся на свой сервер, виджет чата идёт в комплекте. Лицензии позволяют коммерческое использование.
| программа | лицензия | чем интересна |
|---|---|---|
| Chatwoot | MIT (ядро) | кабинеты операторов, каналы, история — самый известный свободный аналог платных чатов |
| LiveHelperChat | Apache-2.0 | живой чат на PHP: ставится на обычный хостинг, без сложной инфраструктуры |
| Rocket.Chat | MIT (ядро) | целая система общения, чат на сайт — один из каналов |
Ниже — демо-режим: стенд в том же виде, что увидит покупатель. Пишите как покупатель, нажимайте отправить и смотрите: что ответит Кондуктор, кто отвечает — он сам, оператор или готовый ответ магазина из кэша — и сколько времени заняло решение. Слева чат покупателя, справа настройки, которыми разработчик этот чат крутит: скорость ответа, подписи, служебная строка. Всё считается нашим живым адресом — тем же, который вы получите при подключении.
Прежде чем врезаться в боевой чат, прогоните свой массив обращений на странице «Разобрать свой файл»: первый объём до 1 000 сообщений — бесплатно, на выходе таблица решений. Так видно, сколько обращений Кондуктор возьмёт на себя и сколько останется языковой модели.