Документация - Crescent ИИ-служба поддержки

Требования

Node.js

18.0 или выше

MySQL

5.7 или выше

Аккаунт Alibaba Cloud

Bailian + Машинный перевод

Установка

1

Шаг 1: Установить зависимости

Дважды щёлкните 安装全部依赖.bat и дождитесь установки всех зависимостей.

安装全部依赖.bat

2

Шаг 2: Запустить проект

Дважды щёлкните 启动项目.bat, чтобы запустить сервер разработки.

启动项目.bat
# http://127.0.0.1:3000

3

Шаг 3: Завершить мастер настройки

Откройте http://127.0.0.1:3000 в браузере. Система проведёт вас через настройку базы данных и создание аккаунта администратора.

Мастер настройки автоматически создаёт SQL-таблицы, настраивает аккаунт администратора и записывает файлы конфигурации — полностью визуально, без ручной работы с базой данных.

Структура базы данных

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

Table	Description
`users`	Аккаунты администраторов и агентов с ролями admin и agent
`clients`	Настройка сайтов — одна запись на интегрированный сайт, хранит Agent ID Alibaba Cloud
`chat_sessions`	Сессии посетителей — записывает IP, устройство, источник перехода и текущий режим обслуживания
`chat_messages`	Сообщения чата — всё содержимое сообщений и типы отправителей (посетитель/агент/ИИ)
`knowledge_base`	Пары вопрос-ответ базы знаний с категорией, ключевыми словами и приоритетом
`knowledge_files`	Файлы, загруженные в базу знаний Alibaba Cloud, и их статус синхронизации
`system_config`	Глобальная конфигурация системы включая ключи API и переводчика

Настройка Alibaba Cloud

Системе нужны два сервиса Alibaba Cloud: Bailian (ИИ-ответы) и Машинный перевод. Войдите в панель администратора, перейдите в Настройки системы и заполните следующее:

ali_api_key API-ключ Bailian

Создаётся в консоли Alibaba Cloud Bailian, используется для вызова агента Q&A.

ali_workspace_id ID рабочего пространства

Виден в правом верхнем углу консоли Bailian, формат ws-xxxxxxxx.

ali_translate_key_id AccessKey ID переводчика

Создаётся в консоли RAM Alibaba Cloud после активации Машинного перевода.

ali_translate_key AccessKey Secret переводчика

В паре с AccessKey ID — сохраните при создании, впоследствии просмотреть невозможно.

Об Agent ID：Каждый интегрированный сайт нуждается в отдельной базе знаний и агенте в Alibaba Cloud Bailian. После создания введите Agent ID и ID базы знаний в разделе Управление сайтами панели администратора.

Интеграция на сайт

После установки встройте окно чата на ваш сайт, чтобы посетители могли начать диалог, не покидая страницу.

Шаг 1: Создать сайт

Войдите в панель администратора, перейдите в Управление сайтами и создайте новый сайт с доменом вашего сайта. Система сгенерирует уникальный код клиента.

Шаг 2: Встроить код

Вставьте следующий фрагмент перед тегом в HTML вашего сайта. Замените YOUR_LOCALE на код языка (например, ru), а YOUR_CLIENT_CODE на код клиента вашего сайта:

<script>
  (function() {
    var btn = document.createElement('a');
    btn.href = 'https://your-domain.com/YOUR_LOCALE/chat?client=YOUR_CLIENT_CODE';
    btn.target = '_blank';
    btn.rel = 'noopener noreferrer';
    btn.title = '联系客服';
    btn.style.cssText = 'position:fixed;bottom:24px;right:24px;width:56px;height:56px;border-radius:50%;background:#2563eb;display:flex;align-items:center;justify-content:center;box-shadow:0 4px 16px rgba(37,99,235,.45);z-index:9999;transition:transform .15s';
    btn.innerHTML = '<svg width="28" height="28" viewBox="0 0 24 24" fill="none" stroke="#fff" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M21 15a2 2 0 0 1-2 2H7l-4 4V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2z"/></svg>';
    btn.onmouseover = function(){ btn.style.transform = 'scale(1.1)'; };
    btn.onmouseout  = function(){ btn.style.transform = 'scale(1)'; };
    document.body.appendChild(btn);
  })();
</script>

Шаг 3: Настроить базу знаний

Создайте базу знаний в Alibaba Cloud Bailian, загрузите деловые документы и создайте агент Q&A. Затем введите Agent ID в Управлении сайтами — ИИ будет автоматически отвечать на вопросы посетителей.