Demo: AI-ассистент на лендинге schemix.ru

Пошаговый runbook для запуска первого встраиваемого виджета чата — AI-ассистента по базе знаний Schemix. Соответствует подэтапу WG.4 из плана TASK_WIDGET.

1. База знаний Schemix

Цель: одна Knowledge Base с содержимым каталога docs/.

1. Админка → Базы знаний → «Новая база». Название: Документация Schemix.
2. Провайдер эмбеддингов — встроенный rubert-tiny2 (или любой активный из раздела AI-провайдеры).
3. Загрузить все файлы из docs/**/*.md:
4. docs/index.md
5. docs/getting-started/*.md
6. docs/guide/*.md
7. docs/admin/*.md
8. docs/api/*.md
9. docs/partner/*.md
10. Дождаться индексации (статус ready на каждом документе).

2. Web-чат канал

Цель: канал типа webchat, к которому привяжется виджет.

1. Админка → Каналы → «Добавить канал».
2. Тип: Web-чат (HTTP). Токен не требуется.
3. webhook_url можно оставить пустым — для виджета он не используется.
4. Привязать дефолтный процесс после шага 3.

3. Процесс AI-ассистента

Цель: Start Event (webchat) → AI Chat → End Event.

1. Процессы → «Новый процесс». Название: Schemix AI Assistant.
2. В визуальном редакторе добавить узлы:
3. Start Event — тип триггера: webchat, дефолтный канал: созданный на шаге 2.

4. AI Chat со следующими настройками:

   • System prompt:

   Ты — AI-ассистент платформы Schemix. Отвечай на вопросы посетителей сайта, используя базу знаний. Будь дружелюбным и кратким. Если не знаешь ответ — предложи оставить контакт для связи с менеджером.

   • Knowledge base: Документация Schemix (из шага 1).
   • Эскалация: Предложить оставить email.
   • End Event.
   • Соединить рёбрами, опубликовать (status = published).
   • Вернуться в Каналы, в Web-чат канале выбрать этот процесс как default_definition.

4. Виджет

1. Админка → Виджеты → «Новый виджет».
2. Заполнить:
3. Название: Лендинг schemix.ru
4. Канал: Web-чат из шага 2
5. Разрешённые домены: https://schemix.ru, https://www.schemix.ru
6. Цвет: #f97316
7. Положение: bottom-right
8. Заголовок: Спросите Schemix AI
9. Сохранить. В карточке появятся widget_token и готовый <script>-snippet.

5. Подключение на лендинге

В schemix-landing/index.html перед </body> уже добавлен тег с плейсхолдером. Перед деплоем заменить wt_REPLACE_ME на выданный в админке widget_token:

<script
  src="https://app.schemix.ru/widget/schemix-chat.js"
  data-token="wt_REPLACE_ME"
  data-theme-primary="#f97316"
  data-theme-position="bottom-right"
  data-theme-title="Спросите Schemix AI"
></script>

6. Проверка

1. Открыть https://schemix.ru — в правом нижнем углу появляется пузырёк чата.
2. Кликнуть → появляется окно с заголовком «Спросите Schemix AI».
3. Написать вопрос, например «Что такое AI Chat?».
4. В админке Schemix → Обращения появляется новое обращение с типом канала webchat и текстом вопроса.
5. AI отвечает в окне в течение нескольких секунд (ответ приходит через polling каждые 2 секунды).

Быстрое восстановление

• Если на лендинге не появляется пузырёк — проверить в DevTools: /widget/<token>/init должен вернуть 200 с session_token.
• 403 → allowed_origins в админке виджета не покрывает текущий Origin.
• 404 → виджет выключен (is_active = false) или токен неверный.
• 401 на /message → сессия истекла дольше часа; виджет сам перезапустит /init после очистки sessionStorage (SchemixWidget.reset()).