Возможности¶
Каналы взаимодействия¶
| Канал | Описание |
|---|---|
| Виджет на сайте | Встраиваемый чат (Preact, WebSocket). Живой диалог с AI в реальном времени |
| Telegram-бот | Приём обращений, отправка ответов и уведомлений |
| WebSocket | Real-time обновления диалогов, инцидентов, тикетов |
AI-бот¶
- Единственный интерфейс общения с клиентом. Операторов нет
- Полностью раздельные диалоги для B2B (партнёры) и B2C (жители): разные промпты, базы знаний, доступные команды
- Декомпозиция обращений: классификация, определение intent, оценка сложности, сбор недостающей информации
- Двухэтапный вызов команд: AI генерирует команду → Action Engine выполняет → результат обратно в AI → человекочитаемый ответ
- Проверка прав клиента перед каждым действием (тип клиента, уровень доступа, привязка к устройствам, rate limits)
- Кнопки категорий при старте диалога + кнопки обратной связи после ответа
Инцидент-менеджмент¶
- Автоматическое создание инцидента, когда AI не справляется
- Маршрутизация по типу: knowledge_gap и bad_answer → AI-тренеру, physical и system_error → техспециалисту
- SLA инцидентов: от 5 минут (critical) до 48 часов (low)
- Кластеризация: похожие инциденты группируются, критичность растёт с количеством
- Автоалерты при всплесках обращений
- Тренд-детектор: раннее обнаружение массовых проблем
- Экстренный путь (urgent path): блокировка доступа, безопасность → мгновенное уведомление дежурному
Тикеты¶
- Создаются из инцидентов автоматически (при критическом уровне) или вручную техспециалистом
- SLA по приоритету
- Автозакрытие: AI отправляет клиенту ответ → клиент подтверждает → закрыто
- Человек никогда не пишет клиенту. Только решает проблему и нажимает "готово"
База знаний (KB)¶
- Три типа записей: статьи (инструкции), Q&A-пары (вопрос → ответ), записи (факты, правила)
- Разделение по scope: citizen (B2C), partner (B2B), all (оба)
- Pinned-записи: всегда в контексте AI (правила аварий, текущие проблемы)
- Версионирование: откат одним кликом
- RAG pipeline: pinned + vector search → prompt assembly → LLM → ответ
Action Engine¶
- Выполнение команд на реальном оборудовании и внутренних системах
- Коннекторы: GraphQL (устройства), Astral (видео), GIS (компании), Mobile (ключи)
- Каждое действие: rate limits, проверка прав, опциональное подтверждение
- Настройка через админку, без деплоя
Статистика и аналитика¶
- Автоматическая категоризация каждого обращения (категория, подкатегория, тип клиента, канал, результат, адрес, устройство)
- Дашборд руководства: по партнёрам (drill-down до обращения), по адресам, по моделям, тренды, качество AI
- Комбинируемые фильтры, CSV-экспорт, плановые отчёты на email
- Разграничение доступа по ролям
Безопасность¶
- 152-ФЗ: данные на территории РФ, шифрование, удаление по запросу
- Защита от prompt injection: изолированный Action Engine, валидация параметров, подтверждение деструктивных операций
- Защита от галлюцинаций: guardrails в промпте, привязка к модели устройства, confidence threshold
- Мультипровайдерность с fallback при сбоях
Стек технологий¶
| Слой | Технологии |
|---|---|
| Backend | Go (chi), PostgreSQL + pgvector, Redis, NATS, MinIO |
| Frontend | Next.js, React, TypeScript, Tailwind CSS, Zustand |
| AI | Абстракция провайдеров: OpenAI, Claude, Gemini, YandexGPT, self-hosted |
| Инфраструктура | Docker, nginx, GitHub Actions CI/CD, Grafana + Prometheus + Loki |