Documentation - Crescent AI Service Client

Prérequis

Node.js

18.0 ou supérieur

MySQL

5.7 ou supérieur

Compte Alibaba Cloud

Bailian + Traduction automatique

Installation

1

Étape 1 : Installer les dépendances

Double-cliquez sur 安装全部依赖.bat et attendez que toutes les dépendances soient installées.

安装全部依赖.bat

2

Étape 2 : Démarrer le projet

Double-cliquez sur 启动项目.bat pour lancer le serveur de développement.

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

3

Étape 3 : Compléter l'assistant de configuration

Ouvrez http://127.0.0.1:3000 dans votre navigateur. Le système vous guidera pour la configuration de la base de données et la création du compte administrateur.

L'assistant d'installation crée automatiquement les tables SQL, configure le compte admin et écrit les fichiers de configuration — entièrement visuel, aucune manipulation manuelle de la base de données requise.

Structure de la base de données

Le système utilise 7 tables, toutes créées automatiquement par l'assistant d'installation :

Table	Description
`users`	Comptes admin et agents avec les rôles admin et agent
`clients`	Configuration des sites — un enregistrement par site intégré, stocke les Agent IDs Alibaba Cloud
`chat_sessions`	Sessions visiteurs — enregistre IP, appareil, référent et mode de service actuel
`chat_messages`	Messages de chat — tout le contenu des messages et types d'expéditeurs (visiteur/agent/IA)
`knowledge_base`	Paires Q&R de la base de connaissances avec catégorie, mots-clés et priorité
`knowledge_files`	Fichiers téléchargés vers la base de connaissances Alibaba Cloud et leur statut de synchronisation
`system_config`	Configuration globale du système incluant les clés API et de traduction

Configuration Alibaba Cloud

Le système nécessite deux services Alibaba Cloud : Bailian (réponses IA) et Traduction automatique. Connectez-vous au panneau d'administration, allez dans Paramètres système et renseignez les éléments suivants :

ali_api_key Clé API Bailian

Créée dans la console Alibaba Cloud Bailian, utilisée pour appeler l'agent Q&R.

ali_workspace_id ID de l'espace de travail

Visible en haut à droite de la console Bailian, format ws-xxxxxxxx.

ali_translate_key_id AccessKey ID de traduction

Créé dans la console RAM Alibaba Cloud après activation de la Traduction automatique.

ali_translate_key AccessKey Secret de traduction

Associé à l'AccessKey ID — à sauvegarder lors de la création, ne peut plus être consulté ensuite.

À propos des Agent IDs：Chaque site intégré nécessite sa propre base de connaissances et son propre agent dans Alibaba Cloud Bailian. Après création, entrez l'Agent ID et l'ID de la base de connaissances dans la section Gestion des sites du panneau admin.

Intégration sur votre site

Une fois installé, intégrez la fenêtre de chat sur votre site pour que les visiteurs puissent démarrer une conversation sans quitter la page.

Étape 1 : Créer un site

Connectez-vous au panneau d'administration, allez dans Gestion des sites et créez un nouveau site avec votre domaine. Le système génère un code client unique.

Étape 2 : Intégrer le code

Collez le snippet ci-dessous avant la balise dans votre HTML. Remplacez YOUR_LOCALE par un code de langue (ex: fr) et YOUR_CLIENT_CODE par le code client de votre site :

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

Étape 3 : Configurer la base de connaissances

Créez une base de connaissances dans Alibaba Cloud Bailian, téléchargez vos documents métier et créez un agent Q&R. Saisissez ensuite l'Agent ID dans la Gestion des sites — l'IA répondra automatiquement aux questions des visiteurs.