قاعدة المعرفة
قاعدة المعرفة
الغرض
قاعدة المعرفة هي ذاكرة الذكاء الاصطناعي الخاص بك. كل ما تضيفه هنا — الأسئلة الشائعة ومعلومات المنتجات والسياسات والملاحظات الصوتية المُفرّغة والمستندات والمواقع المزحوفة — يصبح متاحًا لوكلاء الذكاء الاصطناعي عند الإجابة على أسئلة العملاء عبر جميع القنوات.
من يمكنه الوصول
| المتطلب | التفاصيل |
|---|---|
| الصلاحية | manage_ai_writer |
| الباقة | Pro أو أعلى (مع حد قاعدة المعرفة) |
| الدور | مدير أو وكيل مع الصلاحية |
المتطلبات المسبقة
- باقة Pro أو أعلى مع تفعيل قاعدة المعرفة
- صلاحية
manage_ai_writer - لاستخدام الذكاء الاصطناعي لـ KB: وكيل ذكاء اصطناعي واحد على الأقل مُهيّأ
نظرة عامة على أنواع المحتوى
يدعم سكاي لايت شات خمسة أنواع من إدخالات قاعدة المعرفة:
| النوع | الأيقونة | الوصف | المعالجة |
|---|---|---|---|
| نص | 📝 | الأسئلة الشائعة والسياسات والتعليمات | فورية |
| مستند | 📄 | PDF، Word، Excel، CSV، TXT | فورية (يستخرج الذكاء الاصطناعي) |
| صوت | 🎤 | التسجيلات الصوتية | فورية (يُفرّغ) |
| كتالوج منتجات | 📦 | المنتجات عبر JSON أو CSV | فورية |
| موقع | 🌐 | صفحات الويب المزحوفة | غير متزامنة (مهمة خلفية) |
الشرح الكامل
إنشاء إدخال نصي
الأفضل لـ: الأسئلة الشائعة والسياسات والتعليمات والمعلومات المنظمة
- انقر + إضافة إدخال
- اختر نص
- املأ الحقول:
- العنوان — اسم وصفي (مثل "سياسة الإرجاع")
- المحتوى — نص المعرفة الفعلي
- الوصف — ملخص موجز (اختياري)
- وصف العمل — كيف يجب على الذكاء الاصطناعي استخدام هذا (اختياري)
- انقر إنشاء
- الإدخال متاح فورًا للذكاء الاصطناعي
مثال على المحتوى:
سياسة الإرجاع
نقدم استردادًا كاملًا لأي منتج يُرجع خلال 30 يومًا من الشراء.
الشروط:
- المنتج يجب أن يكون غير مستخدم وفي تغليفه الأصلي
- الإيصال أو تأكيد الطلب مطلوب
- يُعالج الاسترداد إلى طريقة الدفع الأصلية
- وقت المعالجة: 5-7 أيام عمل
للاستبدال، تواصل مع دعم العملاء برقم طلبك.
رفع المستندات
الأفضل لـ: الأدلة والمواصفات والتقارير وجداول البيانات
- انقر + إضافة إدخال
- اختر مستند
- املأ:
- العنوان — اسم وصفي
- الملفات — ارفع ملفًا واحدًا أو أكثر
- التنسيقات المدعومة:
- PDF (.pdf)
- Word (.doc, .docx)
- Excel (.xlsx, .xls)
- CSV (.csv)
- نص (.txt)
- انقر رفع
- الذكاء الاصطناعي يستخرج ويُنظّم المحتوى تلقائيًا
إضافة ملاحظات صوتية
الأفضل لـ: الشروحات المسجّلة والتعليمات الشفهية والمحتوى الصوتي
- انقر + إضافة إدخال
- اختر صوت
- املأ:
- العنوان — اسم وصفي
- ملف الصوت — ارفع التسجيل
- اللغة — كشف تلقائي أو حدد (ar، en، إلخ)
- التنسيقات المدعومة:
- MP3، WAV، M4A، OGG، WEBM
- الحد الأقصى 10 MB
- انقر رفع
- يُفرّغ الصوت تلقائيًا
- التفريغ يصبح معرفة قابلة للبحث
إنشاء كتالوج منتجات
الأفضل لـ: منتجات التجارة الإلكترونية وعروض الخدمات والمخزون
الخيار أ: إدخال JSON
- انقر + إضافة إدخال
- اختر كتالوج منتجات
- أدخل العنوان
- أضف المنتجات كمصفوفة JSON أو فرديًا:
[
{
"product_name": "قميص كتان",
"product_description": "قميص كتان خفيف ومريح",
"sku": "LS-001",
"price": 49.99,
"currency": "SAR",
"category": "قمصان",
"stock_quantity": 120,
"is_available": true,
"image_url": "https://cdn.example.com/shirt.jpg"
}
]
الخيار ب: رفع CSV
- انقر + إضافة إدخال
- اختر كتالوج منتجات
- أدخل العنوان
- ارفع ملف CSV بأعمدة:
product_nameأوname(مطلوب)descriptionskupricecurrencycategorystockأوstock_quantityimage_url
زحف موقع
الأفضل لـ: مراكز المساعدة ومواقع التوثيق وصفحات الأسئلة الشائعة
- انقر + إضافة إدخال
- اختر موقع
- املأ:
- العنوان — اسم وصفي
- رابط الموقع — الرابط البدء
- رابط خريطة الموقع — اختياري، يسرّع الاكتشاف
- هيّئ إعدادات الزحف:
- زحف الموقع بالكامل — تشغيل/إيقاف
- الحد الأقصى للصفحات — 1 إلى 100 (الافتراضي 10)
- الحد الأقصى للعمق — 1 إلى 5 (الافتراضي 2)
- المسارات المسموحة — زحف هذه المسارات فقط (مثل
/docs,/help) - المسارات المستثناة — تخطي هذه المسارات (مثل
/blog,/careers)
- انقر بدء الزحف
- الزحف يعمل في الخلفية — راقب التقدم في القائمة
Website Products — yourstore.com) مع الأسعار وSKU والصور وروابط الشراء عند توفرها. محتوى المساعدة/عن الشركة يبقى في إدخال الموقع — ولن تحصل على قاعدة معرفة عشوائية لكل منتج. بعد انتهاء الزحف، افتح قاعدة المعرفة وابحث عن الكتالوج الجديد، أو استدعِ GET /api/v1/knowledge-base?type=product_catalog.إدارة الإدخالات
تعديل إدخال
- انقر على صف الإدخال
- عدّل الحقول حسب الحاجة
- انقر حفظ التغييرات
تغيير حالة الإدخال
التبديل بين نشط وغير نشط:
- انقر على الإدخال
- ابحث عن قائمة الحالة المنسدلة
- اختر نشط أو غير نشط
- الإدخالات غير النشطة تُستثنى من ردود الذكاء الاصطناعي
حذف إدخال
- انقر على قائمة ••• في صف الإدخال
- اختر حذف
- أكّد الحذف
العمل مع الأجزاء
الأجزاء هي مقاطع نصية يمكن للذكاء الاصطناعي استخدامها عند الإجابة على الأسئلة. عادةً ما ينشئها سكاي لايت شات تلقائيًا من محتواك؛ ويمكنك أيضًا إدارتها يدويًا.
عرض الأجزاء
- انقر على أي إدخال
- اختر تبويب الأجزاء
- شاهد جميع الأجزاء مع محتواها وحالتها
معلومات الجزء
| الحقل | الوصف |
|---|---|
chunk_index | الموضع في التسلسل (يبدأ من 0) |
content | شريحة النص الفعلية |
char_count | طول الأحرف |
has_embedding | هل الجزء جاهز للبحث بالذكاء الاصطناعي |
context_header | بادئة اختيارية مع الجزء |
إنشاء جزء مخصص
- افتح تبويب أجزاء الإدخال
- انقر + إضافة جزء
- أدخل المحتوى (الحد الأقصى 65,000 حرف)
- انقر حفظ
- يصبح الجزء متاحًا لإجابات الذكاء الاصطناعي بعد المعالجة
تعديل جزء
- ابحث عن الجزء
- انقر تعديل
- عدّل المحتوى
- انقر حفظ
- يُستخدم النص المحدّث في إجابات الذكاء الاصطناعي بعد المعالجة
حذف جزء
- ابحث عن الجزء
- انقر حذف
- أكّد الحذف
- يُزال الجزء من إجابات الذكاء الاصطناعي لهذا الإدخال
قاموس الحقول والعناصر
حقول الإدخال
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
| العنوان | نص | نعم | اسم العرض للإدخال |
| المحتوى | منطقة نص | حسب النوع | نص المعرفة (للنوع النصي فقط) |
| الوصف | نص | لا | ملخص موجز يظهر في القائمة |
| وصف العمل | منطقة نص | لا | تعليمات لكيفية استخدام الذكاء الاصطناعي لهذا |
| الحالة | قائمة منسدلة | لا | نشط أو غير نشط (الافتراضي: نشط) |
حقول رفع المستند
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
| العنوان | نص | نعم | اسم العرض |
| الملفات | رفع ملف | نعم | ملف مستند واحد أو أكثر |
| الوصف | نص | لا | ملخص موجز |
| وصف العمل | منطقة نص | لا | سياق استخدام الذكاء الاصطناعي |
حقول رفع الصوت
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
| العنوان | نص | نعم | اسم العرض |
| ملف الصوت | رفع ملف | نعم | التسجيل الصوتي |
| اللغة | قائمة منسدلة | لا | كود ISO 639-1 أو كشف تلقائي |
| الوصف | نص | لا | ملخص موجز |
حقول كتالوج المنتجات
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
| العنوان | نص | نعم | اسم الكتالوج |
| المنتجات | مصفوفة JSON | * | كائنات المنتجات |
| ملف CSV | رفع ملف | * | CSV ببيانات المنتجات |
*مطلوب واحد على الأقل من المنتجات أو ملف CSV
حقول كائن المنتج
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
| product_name | نص | نعم | اسم المنتج |
| product_description | نص | لا | تفاصيل المنتج |
| sku | نص | لا | وحدة حفظ المخزون |
| price | رقم | لا | قيمة السعر |
| currency | نص | لا | رمز العملة (الافتراضي: USD) |
| category | نص | لا | فئة المنتج |
| stock_quantity | عدد صحيح | لا | المخزون المتاح |
| image_url | نص | لا | رابط صورة المنتج |
| is_available | منطقي | لا | حالة التوفر |
المنتجات المُرجَعة عبر API قاعدة المعرفة تتضمن أيضًا product_attributes وpurchase_url (رابط صفحة المنتج أو الشراء عند توفره — بما في ذلك مزامنة سلة وكتالوجات زحف المواقع).
حقول زحف الموقع
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
| العنوان | نص | نعم | اسم الإدخال |
| رابط الموقع | URL | نعم | رابط البدء |
| رابط خريطة الموقع | URL | لا | خريطة موقع XML لاكتشاف أسرع |
| زحف الموقع بالكامل | مفتاح تبديل | لا | زحف جميع الصفحات المكتشفة |
| الحد الأقصى للصفحات | رقم | لا | 1-100 (الافتراضي: 10) |
| الحد الأقصى للعمق | رقم | لا | 1-5 (الافتراضي: 2) |
| المسارات المسموحة | نص | لا | بادئات مسارات مفصولة بفواصل |
| المسارات المستثناة | نص | لا | مسارات للتخطي مفصولة بفواصل |
الحالات والشارات
حالة الإدخال
| الحالة | الشارة | المعنى |
|---|---|---|
| نشط | 🟢 أخضر | مُضمّن في ردود الذكاء الاصطناعي |
| غير نشط | ⚪ رمادي | مُستثنى من ردود الذكاء الاصطناعي |
حالة المعالجة (المستندات)
| الحالة | المعنى |
|---|---|
pending | في قائمة الانتظار للمعالجة |
processing | الذكاء الاصطناعي يستخرج المحتوى |
completed | تم استخراج المحتوى بنجاح |
failed | فشل الاستخراج — تحقق من الخطأ |
حالة التفريغ (الصوت)
| الحالة | المعنى |
|---|---|
pending | في قائمة الانتظار للتفريغ |
processing | التفريغ جارٍ |
completed | التفريغ ناجح |
failed | فشل التفريغ |
حالة الزحف (الموقع)
| الحالة | المعنى |
|---|---|
pending | المهمة في الانتظار |
crawling | يزحف الصفحات بنشاط |
completed | تم استخراج جميع الصفحات |
partial | بعض الصفحات نجحت وبعضها فشل |
failed | فشل الزحف بالكامل |
الشاشات الفرعية
محدد نوع إضافة الإدخال
┌─────────────────────────────────────────────────────────────────┐
│ إضافة إدخال قاعدة المعرفة [X] │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ما نوع المحتوى الذي تريد إضافته؟ │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 📝 │ │ 📄 │ │ 🎤 │ │
│ │ نص │ │ مستند │ │ صوت │ │
│ │ │ │ │ │ │ │
│ │أسئلة شائعة│ │ PDF, Word │ │ ملف صوتي │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ 📦 │ │ 🌐 │ │
│ │ كتالوج │ │ موقع │ │
│ │ │ │ │ │
│ │ المنتجات │ │ زحف رابط │ │
│ └─────────────┘ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
عرض تقدم الزحف
┌─────────────────────────────────────────────────────────────────┐
│ زحف الموقع: مركز المساعدة [X] │
├─────────────────────────────────────────────────────────────────┤
│ │
│ الرابط: https://help.company.sa │
│ الحالة: يُزحف │
│ │
│ التقدم: ████████████░░░░░░░░░░░░░░░░░░░░░░░░ 24/50 صفحة │
│ 48% مكتمل │
│ │
│ الصفحات المزحوفة: │
│ ✓ / │
│ ✓ /getting-started │
│ ✓ /faq │
│ ✓ /contact │
│ ⋯ 20 صفحة أخرى │
│ → /shipping (يُزحف...) │
│ │
│ [إلغاء الزحف] │
└─────────────────────────────────────────────────────────────────┘
محرر الأجزاء
┌─────────────────────────────────────────────────────────────────┐
│ تعديل الجزء #3 [X] │
├─────────────────────────────────────────────────────────────────┤
│ │
│ المحتوى: │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ يتم إصدار المبالغ المستردة إلى طريقة الدفع الأصلية خلال │ │
│ │ 5-7 أيام عمل بعد استلام وفحص المنتج المُرجع. ستتلقى │ │
│ │ رسالة تأكيد بالبريد الإلكتروني بمجرد معالجة الاسترداد. │ │
│ │ │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ │
│ عدد الأحرف: 234 / 65,000 │
│ │
│ جاهز للبحث بالذكاء الاصطناعي: ✓ نعم │
│ │
│ [إلغاء] [حفظ التغييرات] │
└─────────────────────────────────────────────────────────────────┘
الارتباط بالميزات الأخرى
| الميزة | العلاقة |
|---|---|
| وكلاء الذكاء الاصطناعي | الوكلاء يستخدمون KB لتأسيس الردود |
| صندوق الوارد | ردود الذكاء الاصطناعي مُستنيرة بمحتوى KB |
| مكتبة الوسائط | صور المنتجات يمكن أن تشير لعناصر الوسائط |
| القنوات | KB يُشغّل الردود عبر جميع القنوات |
| الحجوزات | الذكاء الاصطناعي يمكنه الإشارة لسياسات الحجز من KB |
الحدود وسلوك الباقات
حدود الباقة
| الجانب | Test | kickoff | Sky pro | Entreprise |
|---|---|---|---|---|
| إدخالات قاعدة المعرفة | 6 | 10 | 100 | 20 |
| حصة صفحات زحف المواقع | غير محدود | 5 | غير محدود | 50 |
| ملفات مكتبة الوسائط | غير محدود | 20 | 100 | 100 |
حدود المنصة (ثابتة لكل الباقات):
| الجانب | الحد |
|---|---|
| حجم رفع المستند | 20 ميجابايت لكل ملف |
| حجم رفع الصوت | 10 ميجابايت لكل ملف |
max_pages لزحف الموقع (لكل مهمة) | 1–100 (الافتراضي في API: 10) |
max_depth لزحف الموقع (لكل مهمة) | 1–5 (الافتراضي في API: 2) |
لا يوجد حد منفصل بعدد الأجزاء أو بعدد المستندات بخلاف حد إدخالات قاعدة المعرفة.
ماذا يحدث عند الحد
عند الوصول لحد إدخالات قاعدة المعرفة:
- يصبح زر + إضافة إدخال معطّلًا
- يظهر شعار: "تم الوصول لحد قاعدة المعرفة"
- الإدخالات الموجودة لا يزال يمكن تعديلها
- احذف الإدخالات لتحرير مساحة، أو قم بالترقية
استكشاف الأخطاء
فشل معالجة المستند
الأعراض: المستند يظهر حالة "فشل"
الحلول:
- تحقق من أن تنسيق الملف مدعوم
- تأكد من أن الملف غير تالف
- تحقق من أن الملف أقل من 20 MB
- جرب إعادة رفع الملف
- لملفات PDF الممسوحة ضوئيًا، تأكد من جودة OCR جيدة
فشل تفريغ الصوت
الأعراض: إدخال الصوت يظهر حالة "فشل"
الحلول:
- تحقق من أن ملف الصوت غير تالف
- تأكد من أن الملف أقل من 10 MB
- تأكد من أن الصوت يحتوي كلامًا واضحًا
- جرب تحديد اللغة يدويًا
- أعد الرفع بتنسيق مختلف
زحف الموقع عالق
الأعراض: الزحف يظهر "يُزحف" لكن لا تقدم
الحلول:
- انتظر — بعض المواقع بطيئة في الزحف
- تحقق إذا كان الموقع يتطلب مصادقة (غير مدعوم)
- تحقق من أن robots.txt يسمح بالزحف
- جرب تقليل max_pages أو max_depth
- تحقق من أن excluded_paths ليست مقيّدة جدًا
الذكاء الاصطناعي لا يستخدم محتوى KB
الأعراض: الذكاء الاصطناعي لا يشير لمعلومات KB
الحلول:
- تحقق من أن حالة الإدخال "نشط"
- تأكد من أن الأجزاء جاهزة للبحث بالذكاء الاصطناعي (
has_embedding: true) - تأكد من أن محتوى KB ذو صلة بالاستفسار
- تحقق من أن وكيل الذكاء الاصطناعي مُسند ونشط
- تحقق من أن business_description يوفر سياقًا جيدًا
الأجزاء لا تظهر
الأعراض: الإدخال يظهر 0 أجزاء
الحلول:
- انتظر اكتمال المعالجة
- تحقق من حالة المعالجة
- تأكد من أن المحتوى ليس فارغًا
- النص يجب أن يحتوي مادة للتقسيم
- جرب إضافة جزء يدويًا
أفضل الممارسات
تنظيم المحتوى
- استخدم عناوين واضحة ووصفية
- اجمع المعلومات المتعلقة في إدخالات فردية
- أضف أوصاف العمل للسياق
- أبقِ الإدخالات مركزة على مواضيع محددة
كتابة محتوى فعّال
- استخدم لغة طبيعية يمكن للذكاء الاصطناعي إعادة صياغتها
- تضمين تنويعات للأسئلة الشائعة
- كن محددًا مع الأرقام والتواريخ والسياسات
- حدّث المحتوى عند تغير المعلومات
إدارة الكتالوج
- تضمين أوصاف منتجات شاملة
- أبقِ الأسعار والتوفر محدّثة
- استخدم تسمية فئات متسقة
- تضمين روابط الصور عند الإمكان
زحف المواقع
- ابدأ بـ max_pages صغير للاختبار
- استخدم allowed_paths للتركيز على المحتوى ذي الصلة
- استثنِ المدونات والوظائف والصفحات الديناميكية
- أعد الزحف دوريًا للبقاء محدّثًا
- بعد الزحف، راجع كتالوج Website Products التلقائي للمنتجات المنظمة وروابط الشراء
