التوثيق - هلال AI لخدمة العملاء

المتطلبات

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 IDs من 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، يُستخدم لاستدعاء وكيل الأسئلة والأجوبة.

ali_workspace_id معرّف مساحة العمل

مرئي في أعلى يمين وحدة تحكم Bailian، بتنسيق ws-xxxxxxxx.

ali_translate_key_id AccessKey ID للترجمة

يُنشأ في وحدة تحكم RAM لـ Alibaba Cloud بعد تفعيل خدمة الترجمة الآلية.

ali_translate_key AccessKey Secret للترجمة

مقترن بـ AccessKey ID — احفظه عند الإنشاء، لا يمكن عرضه لاحقاً.

حول Agent IDs：يحتاج كل موقع مدمج إلى قاعدة معرفة وعميل منفصلَين في Alibaba Cloud Bailian. بعد الإنشاء، أدخل Agent ID ومعرّف قاعدة المعرفة في قسم إدارة المواقع بلوحة الإدارة.

التكامل مع موقعك

بعد التثبيت، ادمج نافذة الدردشة في موقعك ليتمكن الزوار من بدء محادثة دون مغادرة الصفحة.

الخطوة 1: إنشاء موقع

سجّل الدخول إلى لوحة الإدارة وانتقل إلى إدارة المواقع وأنشئ موقعاً جديداً بنطاق موقعك. سيُنشئ النظام رمز عميل فريداً.

الخطوة 2: تضمين الكود

الصق المقتطف أدناه قبل وسم في HTML موقعك. استبدل YOUR_LOCALE برمز اللغة (مثلاً ar) و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 وارفع مستنداتك التجارية وأنشئ وكيل أسئلة وأجوبة. ثم أدخل Agent ID في إدارة المواقع — سيجيب الذكاء الاصطناعي تلقائياً على أسئلة الزوار.