Единое руководство по комплексу

Обучающая статья Smart Support Bot и Smart Support Manager

Обе программы неразрывно связаны: в Smart Support Manager на Windows вы готовите каталоги и скриншоты, устанавливаете сервисы по SSH, а Smart Support Bot обслуживает клиентов в Telegram.

Страница продукта Скачать комплект (ZIP) Частые вопросы и ошибки Ко всем руководствам

Архитектура совместной работы

Smart Support Manager (Windows): открывается на http://127.0.0.1:8766, анализирует файлы продуктов, создаёт каталоги, привязывает фото и управляет сервером по SSH.
Smart Support Bot (Linux VPS): работает в /opt/smart-support и читает опубликованные файлы из /opt/smart-support/products/<id>/.
Единый цикл: никаких ручных правок JSON на сервере — всё синхронизируется напрямую из веб-интерфейса.

Оптимальный порядок настройки

1. Подключение: запустите Start-Smart-Support-Manager.bat и задайте SSH и AI в Settings.
2. Контент: добавьте продукт в Products, соберите и опубликуйте в Catalog, загрузите и привяжите фото в Upload Queue / Media / Catalog photos.
3. Запуск: установите сервисы в Install bot, проверьте /start и Ask AI в Telegram, контролируйте события в History.

1. Дашборд, индикаторы подключения и обзор (Dashboard)

Веб-интерфейс открывается по адресу http://127.0.0.1:8766. Вкладка Dashboard показывает живой статус всех компонентов:

Три индикатора сверху: Server (SSH), Expert + AI (движок каталога) и Expert + bot + AI (связь с ботом).
Переключатель 4 языков: переключение интерфейса между فارسی, English, Русский и 中文.
Счётчики и дорожная карта: число активных продуктов, очередь загрузки и 5-шаговая схема работы.

Совет: каталоги можно готовить локально, а публиковать сразу после зелёного статуса Server.

2. Регистрация продуктов и источников знаний (Products)

Во вкладке Products настраиваются продукты, по которым бот будет консультировать пользователей:

ID и отображаемое имя: задайте уникальный Product ID (например config-builder) и название.
Источники документов (Sources): укажите файлы или папки (TXT, MD, JSON, CSV, HTML, PDF, DOCX, Go, Python).
Папка фото и путь на сервере: выберите папку скриншотов; хранилище на VPS всегда фиксировано в /opt/smart-support/products/<id>.
Переключатель On / Off: временно скрывайте продукт в боте без удаления данных.

3. Генерация AI-каталога, редактирование и публикация (Catalog)

Вкладка Catalog превращает документацию в структурированную базу знаний для Telegram:

Автосборка AI: сгенерируйте заголовок, краткое/полное описание и список функций выбранного продукта.
Ручная доработка: поправьте формулировки и добавьте или удалите отдельные пункты функций.
Публикация (Use catalog in bot): нажмите Use catalog in bot для отправки на VPS или Stop using catalog для снятия с публикации.

Изоляция знаний: ответы AI привязаны строго к выбранному продукту.

4. Очередь загрузки, медиатека и фото каталога (Upload Queue / Media / Catalog photos)

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

Upload Queue: добавляйте изображения (даже вне основной папки) и запускайте Process waiting для надёжной поочерёдной отправки по SSH.
Media: просмотр всех фото продукта и автоматическое AI-сопоставление с пунктами каталога.
Catalog photos: проверка привязанных скриншотов, предпросмотр в полный экран (Esc закрывает), возврат в Media или удаление с сервера.

Правило отправки: бот отправляет в Telegram только подтверждённые фото из Catalog photos.

5. Установка бота на VPS в один клик и настройки (Install bot и Settings)

Развёртывание бота и сервиса Expert выполняется без ручного написания systemd-файлов:

Вкладка Install bot: укажите IP/порт SSH, логин, локальную папку Smart Support Bot и токен от @BotFather.
Выбор Polling или Webhook: Polling работает без домена, а Webhook подключается через ваш HTTPS-прокси (порт 8080).
3 шага установки: последовательно нажмите Install bot, Install Expert и Activate bot and Expert.
Settings и Stop all: задайте параметры SSH, Bot AI (endpoint, модель, API key), синхронизацию Expert и кнопку аварийной остановки Stop all.

Защита ключей: пароли SSH шифруются локально, а токены бота защищены правами доступа .env.

6. Работа в Telegram, журнал History и Contact

После активации пользователи получают удобный интерфейс в Telegram, а администратор — полный аудит:

Сценарий пользователя: /start или /lang открывают 4 языка; разделы каталога открываются с фото; кнопка Ask AI отвечает строго по выбранному продукту. Доступны /menu и /help.
Команды админа в Telegram: /agents, /active_agent, /failover, /safety_status и /catalog_scan в личном чате администратора.
Журнал History: фиксирует время (UTC), изменённый файл, действие (publish_catalog_to_bot и др.), сервер и статус ok / FAILED.
Страница Contact: официальные ссылки Black Fox Group и команда быстрой установки PowerShell.

Совет: для мгновенного обновления каталога на сервере используйте /catalog_scan в чате админа.

7. Частые вопросы и диагностика (FAQ)

Проблема или вопрос	Вероятная причина	Решение
Изменения каталога не видны в Telegram	Текст сохранён только локально или продукт выключен.	Включите продукт (`On`) в `Products` и нажмите `Use catalog in bot` в `Catalog`.
Бот присылает текст без скриншотов	Фото ещё не привязаны к пунктам в Catalog photos.	Загрузите файлы через `Upload Queue` и привяжите к функциям в `Media` / `Catalog photos`.
Webhook не получает обновления	HTTPS reverse proxy не перенаправляет трафик на порт 8080.	Выберите `Polling — no webhook` в `Install bot` или проверьте SSL-прокси.
Статус Server остаётся красным	Неверные IP, порт SSH, логин, пароль или путь к ключу.	Исправьте данные в `Settings`, нажмите `Save`, затем `Connect`.
Ошибка или таймаут AI	Неверный OpenAI-совместимый endpoint, модель или API key.	Проверьте параметры AI в `Settings` и нажмите `Connect to AI`.
Можно ли вести несколько разных продуктов?	Да, каждый продукт изолирован по своему ID.	Создайте отдельный `Product ID` в `Products` — базы знаний не пересекаются.

Страница продукта Открыть на GitHub Ко всем руководствам