Documentación - Crescent AI Atención al Cliente

Requisitos

Node.js

18.0 o superior

MySQL

5.7 o superior

Cuenta Alibaba Cloud

Bailian + Traducción automática

Instalación

1

Paso 1: Instalar dependencias

Haga doble clic en 安装全部依赖.bat y espere a que se instalen todas las dependencias.

安装全部依赖.bat

2

Paso 2: Iniciar el proyecto

Haga doble clic en 启动项目.bat para iniciar el servidor de desarrollo.

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

3

Paso 3: Completar el asistente de configuración

Abra http://127.0.0.1:3000 en su navegador. El sistema le guiará a través de la configuración de la base de datos y la creación de la cuenta de administrador.

El asistente de configuración crea automáticamente las tablas SQL, configura la cuenta admin y escribe los archivos de configuración — totalmente visual, sin necesidad de manipular la base de datos manualmente.

Estructura de la base de datos

El sistema usa 7 tablas, todas creadas automáticamente por el asistente de configuración:

Table	Description
`users`	Cuentas de administrador y agentes con roles admin y agent
`clients`	Configuración de sitios — un registro por sitio integrado, almacena los Agent IDs de Alibaba Cloud
`chat_sessions`	Sesiones de visitantes — registra IP, dispositivo, referrer y modo de servicio actual
`chat_messages`	Mensajes de chat — todo el contenido de mensajes y tipos de remitente (visitante/agente/IA)
`knowledge_base`	Pares Q&A de la base de conocimiento con categoría, palabras clave y prioridad
`knowledge_files`	Archivos subidos a la base de conocimiento de Alibaba Cloud y su estado de sincronización
`system_config`	Configuración global del sistema incluyendo claves API y de traducción

Configuración de Alibaba Cloud

El sistema requiere dos servicios de Alibaba Cloud: Bailian (respuestas IA) y Traducción automática. Inicie sesión en el panel de administración, vaya a Configuración del sistema y complete lo siguiente:

ali_api_key Clave API de Bailian

Creada en la consola Alibaba Cloud Bailian, se usa para llamar al Agente Q&A.

ali_workspace_id ID del espacio de trabajo

Visible en la parte superior derecha de la consola Bailian, formato ws-xxxxxxxx.

ali_translate_key_id AccessKey ID de traducción

Creada en la consola RAM de Alibaba Cloud tras activar la Traducción automática.

ali_translate_key AccessKey Secret de traducción

Par del AccessKey ID — guárdelo al crearlo, no se puede ver después.

Acerca de los Agent IDs：Cada sitio integrado necesita su propia base de conocimiento y Agente en Alibaba Cloud Bailian. Tras crearlos, introduzca el Agent ID y el ID de la base de conocimiento en la sección Gestión de sitios del panel admin.

Integración en su sitio web

Una vez instalado, integre la ventana de chat en su sitio para que los visitantes puedan iniciar una conversación sin abandonar la página.

Paso 1: Crear un sitio

Inicie sesión en el panel de administración, vaya a Gestión de sitios y cree un nuevo sitio con el dominio de su web. El sistema genera un código de cliente único.

Paso 2: Insertar el código

Pegue el siguiente fragmento antes de la etiqueta en su HTML. Reemplace YOUR_LOCALE por un código de idioma (ej: es) y YOUR_CLIENT_CODE por el código de cliente de su sitio:

<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>

Paso 3: Configurar la base de conocimiento

Cree una base de conocimiento en Alibaba Cloud Bailian, suba sus documentos de negocio y cree un Agente Q&A. Luego ingrese el Agent ID en Gestión de sitios — la IA responderá automáticamente a las preguntas de los visitantes.