Dokumentation - Crescent KI-Kundenservice

Systemanforderungen

Node.js

18.0 oder höher

MySQL

5.7 oder höher

Alibaba Cloud Konto

Bailian + Maschinelle Übersetzung

Installation

1

Schritt 1: Abhängigkeiten installieren

Doppelklicken Sie auf 安装全部依赖.bat und warten Sie, bis alle Abhängigkeiten installiert sind.

安装全部依赖.bat

2

Schritt 2: Projekt starten

Doppelklicken Sie auf 启动项目.bat, um den Entwicklungsserver zu starten.

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

3

Schritt 3: Einrichtungsassistent abschließen

Öffnen Sie http://127.0.0.1:3000 im Browser. Das System führt Sie durch die Datenbankkonfiguration und Admin-Kontoerstellung.

Der Einrichtungsassistent erstellt automatisch SQL-Tabellen, richtet das Admin-Konto ein und schreibt Konfigurationsdateien — vollständig visuell, keine manuelle Datenbankarbeit erforderlich.

Datenbankstruktur

Das System verwendet 7 Tabellen, die automatisch vom Einrichtungsassistenten erstellt werden:

Table	Description
`users`	Admin- und Agentenkonten mit admin- und agent-Rollen
`clients`	Site-Konfiguration — ein Datensatz pro integrierter Website, speichert Alibaba Cloud Agent IDs
`chat_sessions`	Besuchersitzungen — zeichnet IP, Gerät, Referrer und aktuellen Servicemodus auf
`chat_messages`	Chat-Nachrichten — alle Nachrichteninhalte und Absendertypen (Besucher/Agent/KI)
`knowledge_base`	Wissensdatenbank-Q&A-Paare mit Kategorie, Schlüsselwörtern und Priorität
`knowledge_files`	In die Alibaba Cloud Wissensdatenbank hochgeladene Dateien und ihr Synchronisierungsstatus
`system_config`	Globale Systemkonfiguration mit API-Schlüsseln und Übersetzungsschlüsseln

Alibaba Cloud Konfiguration

Das System benötigt zwei Alibaba Cloud Dienste: Bailian (KI-Antworten) und Maschinelle Übersetzung. Melden Sie sich im Admin-Panel an, gehen Sie zu Systemeinstellungen und geben Sie folgendes ein:

ali_api_key Bailian API-Schlüssel

Erstellt in der Alibaba Cloud Bailian-Konsole, wird zum Aufruf des Q&A-Agenten verwendet.

ali_workspace_id Arbeitsbereich-ID

Sichtbar oben rechts in der Bailian-Konsole, Format wie ws-xxxxxxxx.

ali_translate_key_id Übersetzungs-AccessKey ID

Erstellt in der Alibaba Cloud RAM-Konsole nach Aktivierung der Maschinellen Übersetzung.

ali_translate_key Übersetzungs-AccessKey Secret

Zusammen mit der AccessKey ID — bei der Erstellung speichern, danach nicht mehr einsehbar.

Über Agent IDs：Jede integrierte Website benötigt eine eigene Wissensdatenbank und einen Agenten in Alibaba Cloud Bailian. Nach der Erstellung geben Sie die Agent-ID und Wissensdatenbank-ID im Bereich Site-Verwaltung des Admin-Panels ein.

Website-Integration

Nach der Installation binden Sie das Chat-Fenster in Ihre Website ein, damit Besucher ohne Seitenwechsel ein Gespräch beginnen können.

Schritt 1: Site erstellen

Melden Sie sich im Admin-Panel an, gehen Sie zur Site-Verwaltung und erstellen Sie eine neue Site mit Ihrer Website-Domain. Das System generiert einen eindeutigen Client-Code.

Schritt 2: Code einbinden

Fügen Sie den folgenden Code vor dem -Tag in Ihr Website-HTML ein. Ersetzen Sie YOUR_LOCALE durch einen Sprachcode (z.B. de) und YOUR_CLIENT_CODE durch den Client-Code Ihrer 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>

Schritt 3: Wissensdatenbank einrichten

Erstellen Sie eine Wissensdatenbank in Alibaba Cloud Bailian, laden Sie Ihre Geschäftsdokumente hoch und erstellen Sie einen Q&A-Agenten. Geben Sie dann die Agent-ID in der Site-Verwaltung ein — die KI antwortet automatisch auf Besucherfragen.