# معرفة الوكيل

> أضف ما يجيب منه ذكاء وكيل مجيب الاصطناعي واستبدله واحذفه عبر الواجهة البرمجية العامة، وكيف تُحمى قواعد المعرفة المشتركة.

يجيب ذكاء وكيلك الاصطناعي من قواعد معرفته: أسعارك، ومواعيد العمل، وسياساتك، وتفاصيل منتجاتك. عبر الواجهة البرمجية العامة تُبقي هذه المعرفة متزامنة مع النظام الذي تعيش فيه أصلاً، فلا يجيب الوكيل أبداً من قائمة أسعار الأمس. كل ذلك تحت `/v1/agents/{agentId}/knowledge-bases`.

## كيف تصل المعرفة إلى الذكاء الاصطناعي؟

كل قاعدة معرفة نص مُسمّى مرتبط بوكيل أو أكثر. حين تضيف واحدة أو تستبدلها أو تحذفها، يعيد مجيب بناء سياق الذكاء الاصطناعي لكل وكيل يستخدمها في الخلفية، فتعكس الإجابات الجديدة التغيير عادةً خلال دقيقة. راجع [قاعدة المعرفة](/docs/features/knowledge-base) لترى كيف تعمل في لوحة التحكم.

## كيف أضيف معرفة؟

أرسل اسماً ونصاً بـ `POST`. تُربَط بالوكيل ويبدأ الذكاء الاصطناعي في استخدامها.

```bash
curl -X POST https://api.mojeeb.app/v1/agents/YOUR_AGENT_ID/knowledge-bases \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Opening hours", "content": "We are open Sunday to Thursday, 9:00 to 17:00 Cairo time.", "tags": ["hours"] }'
```

لحدود الحجم راجع [مرجع إنشاء قاعدة معرفة](../api-reference/create-knowledge-base). وحجم المعرفة يؤثر في استهلاك الرسائل: حتى 40,000 كلمة من المعرفة النشطة لدى الوكيل يُحتسب كل رد للذكاء الاصطناعي رسالة واحدة، وحتى 80,000 رسالتين، وهكذا. راجع [قاعدة المعرفة](/docs/features/knowledge-base).

## كيف أُبقي قاعدة معرفة محدّثة؟

أرسل `PUT` بالاسم والمحتوى الجديدين لاستبدالهما. أرسل `tags` فقط حين تريد تغييرها.

```bash
curl -X PUT https://api.mojeeb.app/v1/agents/YOUR_AGENT_ID/knowledge-bases/KNOWLEDGE_BASE_ID \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Opening hours", "content": "From November we open on Saturdays too, 10:00 to 14:00." }'
```

المزامنة الليلية من نظامك مناسبة هنا: اقرأ مصدرك، ثم استبدل قاعدة المعرفة المقابلة. تعيد نقطة العرض الأسماء والمعرّفات دون المحتوى، وتعيد [جلب قاعدة معرفة](../api-reference/get-knowledge-base) واحدة بمحتواها.

يعود المحتوى كما حُفظ تماماً، لذا تعود القاعدة التي حُفظت آخر مرة من محرّر لوحة التحكم بصيغة HTML. لتقرّر هل تستبدلها، قارن مصدرك بما أرسلته آخر مرة (كبصمة hash تحتفظ بها)، لا بالمحتوى المُعاد، أو استبدلها في كل مرة ببساطة.

## ماذا يحدث حين تكون قاعدة المعرفة مشتركة؟

قد تخدم قاعدة معرفة واحدة عدة وكلاء، ويصل التغيير إليهم جميعاً. لا يغيّرها المفتاح أو يحذفها إلا إذا كان يستطيع العمل على كل وكيل يستخدمها. وإلا تُعيد الواجهة `403 shared_with_other_agents` ولا يتغيّر شيء. هذا يمنع مفتاحاً أُعدّ لوكيل واحد من إعادة كتابة ما يقوله وكيل آخر.

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

### كيف أوقف استخدام الذكاء الاصطناعي لقاعدة معرفة؟

احذفها. لا تقدّم الواجهة مفتاح تشغيل وإيقاف للمعرفة، لأن الذكاء الاصطناعي يقرأ كل قاعدة معرفة مرتبطة بالوكيل.

### هل أستطيع رفع ملف PDF أو Word؟

ليس عبر الواجهة بعد. ارفع المستندات من لوحة التحكم حيث يستخرج مجيب نصها. تقبل الواجهة النص، وأغلب الأنظمة تصدّره مباشرة.

### لماذا يعود بعض المحتوى بصيغة HTML؟

تعيد الواجهة البرمجية المحتوى كما حُفظ تماماً، وهو ما يقرؤه الذكاء الاصطناعي. المحتوى المُرسَل عبر الواجهة البرمجية، أو المكتوب عند إضافة معرفة في لوحة التحكم، أو المستخرَج من مستند مرفوع، نص عادي. أما القاعدة التي حُفظت آخر مرة من نافذة التعديل في لوحة التحكم فتُخزَّن بصيغة HTML الخاصة بالمحرّر: وسوم الفقرات والقوائم والخط العريض والمائل، مع كتابة رموز مثل علامة العطف ككيانات HTML. أرسل نصاً عادياً. تعرض لوحة التحكم المحتوى كنص منسّق، لذا فالنص الذي يشبه وسم HTML، كعنصر نائب بين قوسين زاويين، لا يظهر هناك ويضيع إن عدّل أحدٌ القاعدة من لوحة التحكم.

### ماذا يحذف الحذف؟

قاعدة المعرفة نفسها، من كل وكيل يستخدمها. ويخضع لقاعدة المعرفة المشتركة نفسها التي يخضع لها الاستبدال.

### متى يستخدم الذكاء الاصطناعي تغييري؟

عادةً خلال دقيقة. تبدأ إعادة البناء فور حفظ التغيير وتجري في الخلفية.