Как работает NaviBot

У NaviBot три основных слоя:

1. Website widget — видимый ассистент и chat overlay.
2. Кабинет клиента — настройка сайтов, поведения widget, OpenAI, Knowledge sources, integrations и analytics.
3. Backend-мозг — система в стиле 1Desk, которая хранит разговоры, запускает AI replies, уведомляет операторов и владеет server-side данными.

Runtime flow

1. Сайт загружает https://navi.1it.pro/widget.js.
2. Widget создает или возобновляет visitor session.
3. Он собирает безопасный page context: title, видимые секции, links, FAQ-like text и структуру страницы.
4. Посетитель отправляет сообщение.
5. Backend сохраняет сообщение в conversation.
6. Dispatcher проверяет, есть ли у inbox AI agent integration.
7. OpenAI adapter собирает prompt из:
   • site prompt
   • behavior rules
   • live page context
   • выбранных RAG documents
8. Ответ сохраняется и отправляется обратно в widget.

Граница продукта

NaviBot — это лицо на сайте. Backend остается мозгом.

Зона	Ответственный слой
Widget UI	NaviBot
Character и motion	NaviBot
Page context scan	NaviBot widget
Conversations	Backend в стиле 1Desk
OpenAI routing	Backend integration layer
Knowledge sources	NaviBot cabinet + backend RAG
Human handoff	Inbox/operator flow в стиле 1Desk
Analytics	NaviBot events + backend storage

Что подготовить

Перед запуском нужны:

• домен целевого сайта
• website inbox в кабинете
• OpenAI account или managed OPENAI_API_KEY
• первый page map или page context target
• widget embed snippet
• privacy / consent text
• стартовый набор Knowledge sources

Частая проблема

Если widget принимает сообщения, но не отвечает, проверьте, подключен ли OpenAI agent integration к website inbox и есть ли OpenAI key.