# المعرفة وRAG


# المعرفة وRAG

يتيح التوليد المعزَّز بالاسترجاع (RAG) لوكيلك أن يجيب من مستنداتك الخاصة بدلًا من التخمين: عندما يسأل متصل عن شيء، يبحث الوكيل عن المقاطع الأكثر صلة ويجيب منها. يُهيّأ RAG في قسم **Add Knowledge Base** على علامة تبويب **[LLM](./llm)** في منشئ الوكلاء على **/agent/setup** — لا توجد علامة تبويب معرفة منفصلة.

## كيف يعمل RAG هنا

![قاعدة معرفة مع RAG](/img/screenshots/portal/knowledge-base.png)
*قاعدة معرفة: تُقسَّم المستندات إلى مقاطع وتُفهرَس وتُسترجَع أثناء المكالمة، مع تحليل للجودة والتغطية.*

يُبقي RAG الإجابات مؤصَّلة. بدلًا من الاعتماد فقط على ما يعرفه النموذج بالفعل، يسترجع الوكيل محتوى مطابقًا من مستنداتك ويستخدمه للرد. هذا يعني إجابات دقيقة ومحدّثة عن منتجاتك وسياساتك وعملياتك — وردود مختلَقة أقل بكثير.

قبل أن تتمكن من ربط قاعدة معرفة، تحتاج إلى واحدة. ارفع مستنداتك (PDF أو DOCX أو TXT) وأدِرها في [قاعدة المعرفة](../knowledge-base).

## قبل أن تربط

تحتاج إلى قاعدة معرفة بمحتوى فيها قبل أن يفعل RAG أي شيء. الترتيب هو:

1. ارفع مستنداتك وفهرسها في [قاعدة المعرفة](../knowledge-base).
2. على علامة تبويب **Model** (LLM)، شغّل **RAG Enabled** و**اربط** تلك القاعدة بالوكيل.
3. اضبط عتبة التشابه وأعلى-k أدناه.
4. اختبر بأسئلة حقيقية واضبط.

## اربط قاعدة معرفة

على علامة تبويب **Model** (LLM)، شغّل **RAG Enabled** و**اختر** قاعدة المعرفة (أو عدة قواعد) التي تريد لهذا الوكيل أن يستمد منها. بمجرد الربط، يبحث الوكيل فيها تلقائيًا أثناء المكالمات ويستخدم ما يجده للإجابة.

## عتبة التشابه

تضبط **عتبة التشابه** كم يجب أن يطابق مقطع سؤال المتصل عن قرب قبل استخدامه.

- العتبة **الأعلى** تُرجِع المطابقات القوية فقط — أكثر دقة، لكن الوكيل قد لا يجد شيئًا للأسئلة المصاغة بفضفاضة.
- العتبة **الأدنى** أكثر تسامحًا وتُظهِر مزيدًا من المقاطع، على خطر جلب مقاطع أقل صلة.

اضبطها حتى يجد الوكيل محتواك بموثوقية دون جرّ ضوضاء.

## أعلى-k

يضبط **أعلى-k** كم عدد المقاطع الأفضل مطابقة التي يسترجعها الوكيل لكل سؤال.

- أعلى-k **الأصغر** يُبقي الإجابات محكمة ومركّزة على أقرب المطابقات.
- أعلى-k **الأكبر** يمنح الوكيل سياقًا أكثر للعمل معه، مما يساعد للأسئلة العريضة لكنه قد يخفّف الإجابة.

:::tip

ابدأ بقيم محافِظة، ثم اختبر بأسئلة حقيقية في **اختبار الدردشة** على **/agent/chat**. إذا فاتت الوكيل إجابات موجودة بوضوح في مستنداتك، اخفض العتبة أو ارفع أعلى-k قليلًا؛ إذا جرّ محتوى خارج الموضوع، افعل العكس.

:::

## الضبط بنظرة واحدة

عندما لا يجيب الوكيل بالطريقة التي تريدها، يغطّي هذان العَرَضان معظم الحالات:

| العَرَض | السبب المرجّح | جرّب |
| --- | --- | --- |
| يقول الوكيل إنه لا يعرف، لكن الإجابة في مستنداتك | العتبة صارمة جدًا، أو أعلى-k صغير جدًا | اخفض عتبة التشابه، أو ارفع أعلى-k قليلًا |
| يجرّ الوكيل مادة خارج الموضوع أو خاطئة | العتبة فضفاضة جدًا، أو أعلى-k كبير جدًا | ارفع عتبة التشابه، أو اخفض أعلى-k |

غيّر إعدادًا واحدًا في كل مرة وأعد الاختبار، حتى تتمكن من معرفة ما حرّك النتيجة فعلًا.

## الخطوات التالية

- [ارفع المستندات وأدِرها في قاعدة المعرفة](../knowledge-base)
- [امنح الوكيل أدوات وإجراءات MCP](./tools-mcp)
- [هيّئ LLM ووضع خط الأنابيب](./llm)
- [العودة إلى نظرة عامة على الوكلاء](./overview)