> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wittify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# قاعدة المعرفة

> أعطِ وكيلك المستندات والأسئلة الشائعة والمواقع التي يجب أن يجيب منها. ارفع ملفات، اكتب أسئلة شائعة، أضف روابط ليزحف عليها، وفعّل البحث على الويب عندما تريد للوكيل أن يبحث خارج محتواك.

<div dir="rtl" lang="ar" style={{ direction: "rtl" }}>
  {/* wittify-rtl-wrapper */}

  <Note>
    قاعدة المعرفة هي **الخطوة 4 (هجين)** أو **الخطوة 3 (نصي / صوتي)**. الصفحة فيها أربعة تبويبات: **الملفات** و **الأسئلة الشائعة** و **الروابط** و **البحث**. كل عنصر تضيفه يُحفَظ مباشرة، لا تحتاج للضغط على حفظ مسوّدة في هذه الخطوة.
  </Note>

  ## كيف يستخدم الوكيل قاعدة المعرفة

  عندما يسأل العميل شيئًا، يبحث الوكيل في قاعدة معرفتك عن أكثر القطع صلة (مقاطع من الملفات، أسئلة شائعة مطابقة، صفحات روابط مفهرسة) ويستخدمها لكتابة جوابه. تمرّ العناصر بسلسلة حالات قبل أن تصبح جاهزة: **Pending → Processing → Training → Trained**. فقط العناصر **Trained** تُستخدَم في الإجابة.

  إذا فعّلت **Search**، يستطيع الوكيل أيضًا النظر في الإنترنت العامّة (أو في قائمة نطاقات تحدّدها) عندما لا يطابق محتواك المُدرَّب.

  ## شريط التبويبات

  شريط تبويبات مخصّص في أعلى الصفحة، فيه شارة عدّ لكل تبويب.

  | ماذا فيه                                                                 | التبويب             |
  | ------------------------------------------------------------------------ | ------------------- |
  | تحميلات المستندات (PDF و DOCX و TXT إلخ) برفع من مرحلتين وإجراءات مجمّعة | **الملفات**         |
  | أزواج سؤال-جواب تكتبها، مع استيراد / تصدير CSV                           | **الأسئلة الشائعة** |
  | صفحات ويب يزحف عليها الوكيل ويعيد الزحف على جدول                         | **الروابط**         |
  | مفتاح للسماح بالبحث على الويب العامّة، مع حد اختياري للنطاقات            | **البحث**           |

  كل تبويب يحوي شارة عدّ خاصّة به (مثلاً **12 ملفًا** و **34 سؤالاً** و **8 روابط** و **البحث مفعّل**).

  ## تبويب الملفات

  ### أنواع الملفات المدعومة

  | الامتدادات                   | النوع          |
  | ---------------------------- | -------------- |
  | **PDF** و **DOCX** و **TXT** | المستندات      |
  | **CSV** و **XLSX**           | جداول البيانات |
  | **PNG** و **JPG**            | الصور          |

  | القيمة                    | الحد             |
  | ------------------------- | ---------------- |
  | **10 ميجابايت**           | حجم الملف الواحد |
  | **100 ميجابايت** لكل وكيل | إجمالي التخزين   |

  عندما يمتلئ التخزين، تُعطَّل منطقة السحب-والإفلات ويظهر تحذير أحمر بدل دعوة الرفع.

  ### الرفع من مرحلتين

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

  <Steps>
    <Step title="أفلت أو تصفّح">
      اسحب الملفات على منطقة الرفع، أو اضغط لفتح مُنتقي الملفات. يظهر كل ملف مقبول في القائمة كـ **عنصر نائب معلَّق** (شارة الحالة: **Pending**). الملف الخام يبقى في متصفّحك حتى تؤكّد.
    </Step>

    <Step title="يظهر شريط الملفات المعلَّقة">
      شريط أعلى قائمة الملفات يقول **N ملفًا جديدًا جاهزًا للتدريب**، فيه زرّان: **إلغاء** (يمسح الملفات المعلَّقة) و **رفع وتدريب** (يرسلها للخادم). أسماء الملفات لا تُعرَض في هذا الشريط عمدًا (الأسماء الطويلة تكسر التخطيط). تظهر في قائمة الملفات أسفله.
    </Step>

    <Step title="رفع وتدريب">
      اضغط **رفع وتدريب**. تُرسَل الملفات للخادم في دفعة واحدة. تتحوّل الحالة إلى **Processing** (شارة كهرمانية)، ثم **Training** (شارة زرقاء بنبض)، ثم **Trained** (شارة خضراء) عندما يصبح الوكيل قادرًا على الإجابة منها. عند خطأ تتحوّل الشارة إلى **Failed** (حمراء).
    </Step>
  </Steps>

  ### شارات الحالة

  | المعنى                                   | اللون         | الحالة         |
  | ---------------------------------------- | ------------- | -------------- |
  | عنصر نائب محلي، لم يُرفَع بعد            | رمادي خافت    | **Pending**    |
  | الخادم استلم الملف ويحلّله               | كهرماني + نبض | **Processing** |
  | إضافته إلى فهرس الوكيل                   | أزرق + نبض    | **Training**   |
  | جاهز، يستطيع الوكيل الإجابة من هذا الملف | أخضر          | **Trained**    |
  | حدث خطأ في الخادم                        | أحمر          | **Failed**     |

  يستطلع المعالج الخادم أثناء وجود عناصر في حالات انتقالية (Pending / Processing / Training) فترى تغيّرات الحالة فوريًا دون تحديث.

  ### قائمة الملفات

  جدول قابل للفرز عند وجود ملفات. الأعمدة:

  | سلوك الفرز                                                                                                      | العمود                    |
  | --------------------------------------------------------------------------------------------------------------- | ------------------------- |
  | اختر الكل في الرأس، فردي لكل صف                                                                                 | Checkbox                  |
  | أبجدي                                                                                                           | **File** (الاسم + أيقونة) |
  | حسب أولوية الحالة (Pending > Processing > Training > Failed > Trained)                                          | **Status**                |
  | عددي                                                                                                            | **Size**                  |
  | الأحدث أولًا افتراضيًا. هذا العمود الوحيد الذي تكسر فيه أولوية الحالة التعادل (فيظهر صف معلَّق جديد في الأعلى). | **Uploaded**              |
  | أبجدي حسب الامتداد                                                                                              | **Type**                  |
  | أيقونة سلّة المحذوفات تظهر عند التحويم لكل صف                                                                   | Actions                   |

  اضغط أي رأس عمود للفرز. اضغط مرة أخرى للعكس. عمود الفرز النشط مظلَّل.

  التقسيم يعمل عند 25 صفًا.

  ### الإجراءات المجمّعة

  عند تحديد صفوف، يظهر شريط إجراءات مجمّعة:

  * مربّع **اختر كل ما في هذه الصفحة**
  * **Retrain** , يعيد تشغيل خط الفهرسة على الملفات المختارة
  * **Download** , يحمّل الملفات الأصلية كـ zip
  * **Delete** , يفتح حوار تأكيد، ثم يحذف الملفات المختارة

  الحذف المجمّع يستلزم تأكيدًا، تظهر النافذة بعنوان **هل أنت متأكد؟** مع زر **Delete** أحمر.

  ### الحالة الفارغة

  عندما لا يكون لديك ملفات بعد، يعرض مكان قائمة الملفات بطاقة فارغة بأيقونة ملف مع السطر **No files yet** (وتلميح بالأنواع المدعومة). تتمدّد البطاقة لتملأ المنطقة فلا تبدو الصفحة مكسورة.

  ## تبويب الأسئلة الشائعة

  أزواج سؤال-جواب يستخدمها الوكيل حرفيًا عند ورود سؤال يطابق السؤال.

  ### إضافة أسئلة

  طريقتان:

  1. **اكتبها يدويًا** , اضغط **Add FAQ**، عبّئ **Question** و **Answer**، احفظ. الأسئلة الجديدة تظهر أولًا كبطاقات معلَّقة؛ اضغط **Train all** (أو انتظر التدريب الجماعي) لتتحوّل إلى صفوف جدول مدرَّبة.
  2. **استورد من CSV** , اضغط **Import CSV**، ارفع ملف `.csv` بعمودين: `question, answer`.

  | القيمة                                               | الحد                           |
  | ---------------------------------------------------- | ------------------------------ |
  | **300 حرف**                                          | الحد الأقصى لطول السؤال        |
  | **2,000 حرف**                                        | الحد الأقصى لطول الجواب        |
  | **500**                                              | الحد الأقصى للصفوف لكل استيراد |
  | **UTF-8 with BOM** (حتى تظهر العربية صحيحة في Excel) | ترميز CSV                      |

  ### التعديل والحذف

  | السلوك                                              | الإجراء         |
  | --------------------------------------------------- | --------------- |
  | اضغط أي صف ليتوسّع وعدّل Question / Answer في مكانه | تعديل في الموضع |
  | مربّعات لكل صف، ومربّع تحديد الكل في الرأس          | تحديد جماعي     |
  | نفس حوار التأكيد كالملفات                           | حذف جماعي       |
  | يحمّل الأسئلة المختارة كـ CSV بترميز UTF-8 BOM      | تصدير جماعي     |

  استيراد / تصدير CSV يتمّ ذهابًا وإيابًا بنظافة: تستطيع تصدير أسئلتك، تعديلها في Excel أو Google Sheets، وإعادة استيرادها بدون انحراف ترميز.

  ## تبويب الروابط

  أضِف صفحات ويب عامّة فيزحف عليها الوكيل بجدول، ويفهرس محتواها في قاعدة المعرفة.

  ### إضافة روابط

  اكتب أو الصق رابطًا في الحقل. اضغط **Add URL**. يتحقّق الوكيل من الرابط:

  * يجب أن يبدأ بـ `http://` أو `https://`. البروتوكولات الأخرى (`javascript:` و `data:` و `file:` إلخ) مرفوضة.
  * يجب أن يكون رابطًا عامًّا وقابلًا للوصول.

  بعد الإضافة، يدخل الرابط في نفس سلسلة الحالات كالملفات: **Pending → Indexing → Indexed**، أو **Failed** عند الخطأ.

  ### قائمة الروابط

  | ماذا يعرض                                                | العمود           |
  | -------------------------------------------------------- | ---------------- |
  | الرابط نفسه                                              | **URL**          |
  | نفس أنماط الشارات: Pending و Indexing و Indexed و Failed | **Status**       |
  | عدد الصفحات المفهرسة من ذلك الرابط                       | **Pages**        |
  | الطابع الزمني لآخر زحف                                   | **Last Crawled** |
  | **Recrawl** (يعيد تشغيل الزاحف) و **Delete** (مع تأكيد)  | Actions          |

  ## تبويب البحث

  يسمح للوكيل بالنظر في الإنترنت العامّة (أو في قائمة نطاقات تحدّدها) عندما لا تحوي قاعدة معرفته إجابة.

  ### المفتاح الرئيسي

  مفتاح واحد: **Allow public web search**. عند **التعطيل** يقول الوكيل *لا أعرف هذه المعلومة* إذا لم تغطّها قاعدة المعرفة. عند **التفعيل** تظهر ملاحظة كهرمانية تحذّر من الآثار:

  > *السماح للوكيل بالبحث على الإنترنت العامّة يعني أنه قد يجلب محتوى لم تكتبه. فكّر في تضييقه بقائمة نطاقات أدناه.*

  ### قائمة تقييد النطاقات

  عند تفعيل مفتاح البحث، تظهر قائمة اختيارية بالنطاقات المسموح بها. أضِف نطاقًا واحدًا لكل صف (مثلاً `example.com`). عندما تكون القائمة غير فارغة، يبحث الوكيل في تلك النطاقات فقط. عند فراغها، يغطّي البحث كل الإنترنت العامّة.

  | السلوك                                                                                     | الإجراء    |
  | ------------------------------------------------------------------------------------------ | ---------- |
  | اكتب أو الصق، ثم **Add**. نفس قائمة البروتوكولات المسموحة كالروابط (لا `javascript:` إلخ). | إضافة نطاق |
  | اضغط أيقونة سلّة المحذوفات. تتحدّث القائمة فورًا.                                          | إزالة نطاق |
  | غير مطلوب، كل إضافة / إزالة تُحفَظ فور حدوثها.                                             | حفظ مجمّع  |

  ## كيف يعمل الحفظ في هذه الخطوة

  قاعدة المعرفة هي الخطوة الوحيدة التي **لا تحفظ بشكل مجمّع**. كل عنصر تضيفه (ملف، سؤال شائع، رابط، تقييد نطاق) يُحفَظ فورًا، عنصرًا بعنصر. لذلك زر **حفظ مسوّدة** ليس له تأثير "حفظ KB"، لا يوجد ما يُحفَظ، فقد حُفِظ بالفعل.

  عمليات الحذف تستلزم دائمًا حوار تأكيد بزر **حذف** أحمر.

  ## أسئلة شائعة

  <AccordionGroup>
    <Accordion title="ملفّي عَلِق على Processing.">
      حدّث الصفحة مرة واحدة. استطلاع المعالج أحيانًا يفقد الاتصال على الشبكات البطيئة. إن بقي عالقًا بعد 5 دقائق، أعد تدريب الملف عبر إجراء **Retrain** المجمّع.
    </Accordion>

    <Accordion title="الوكيل لا يستخدم سؤالي الشائع.">
      تحقّقان: (1) حالة السؤال **Trained** (وليس Pending)، (2) صياغة السؤال في الـ FAQ مشابهة لطريقة سؤال العملاء فعلًا. جرّب إضافة سؤال آخر بصياغة معاد صياغتها.
    </Accordion>

    <Accordion title="رفعت PDF حجمه 12 ميجابايت ورُفِض.">
      حدّ الملف الواحد 10 ميجابايت. قسّم PDF إلى أجزاء أصغر، أو اضغط الصور داخله، ثم أعد الرفع.
    </Accordion>

    <Accordion title="استيراد CSV عرض العربية كـ `???`.">
      يجب أن يكون CSV بترميز **UTF-8 with BOM**. افتحه في Excel، صدّره كـ **CSV UTF-8 (Comma delimited)**. أو استخدم **Export CSV** في تبويب الأسئلة الشائعة كقالب، فالملف بترميز BOM.
    </Accordion>

    <Accordion title="رابط أضفته يعرض 'Pages: ,'.">
      عدد الصفحات وطابع آخر زحف أعمدة لم يربطها الخادم بعد. الزحف يحدث، والوكيل يجيب من محتوى الرابط. ستتعبّأ الأعمدة عند ربط الخادم لتلك الحقول.
    </Accordion>

    <Accordion title="هل أستطيع تقييد إجابات الوكيل بملف معيّن؟">
      ليس في هذه الخطوة. يبحث الوكيل عبر كل العناصر المدرَّبة. للتقييد، اكتب في **توجيه النظام** في [إعدادات النص](/ar/Systems/AI-Agents/Wizard/Text-Settings) لتوجيه الوكيل لمواضيع محدّدة.
    </Accordion>

    <Accordion title="مفتاح Search معطّل لكن الوكيل يجيب أشياء لم أرفعها.">
      تمتلك النماذج معرفة عامّة بالعالم منفصلة عن قاعدة معرفتك. المفتاح يتحكّم بـ *البحث على الويب* وليس بما يعرفه النموذج أصلًا. لإجبار الإجابات على الالتزام بالمحتوى، اكتب ذلك في توجيه النظام: *أجب فقط من قاعدة المعرفة المُقدَّمة. إن لم تعرف، قُل ذلك.*
    </Accordion>
  </AccordionGroup>

  ## التالي

  <Card title="الخطوة 5: التذاكر والعملاء المحتملون" icon="ticket" href="/ar/Systems/AI-Agents/Wizard/Tickets-and-Leads">
    اضبط كيف يجمع الوكيل بيانات العملاء، يفتح التذاكر، ويؤهّل العملاء المحتملين. مع إشعارات بالبريد أو Slack أو CRM.
  </Card>
</div>