DOCS / sources

ربط مصادر المعرفة

دلال لا يجيب من ذاكرته. كل جملة في الرد مبنيّة من مصدر موصول، فما لم تصله لا يستطيع قوله — وهذا هو السبب الذي يجعل هذه الصفحة أول ما يُقرأ.

أنواع المصادر

ثلاثة، وهي القيم التي يقبلها الحقل حرفياً:

url: صفحة واحدة تُجلَب وتُقسَّم إلى مقاطع. مقال مركز مساعدة، أو صفحة سياسة.
sitemap: خريطة موقع، فتُجلَب الصفحات المذكورة فيها. الطريق العملي لمركز مساعدة كامل.
file: نصّ ترسله أنت في جسم الطلب. لسياسة لا تنشرها على الإنترنت.

العنوان الذي ترسله يمرّ بحارس الطلبات الصادرة نفسه: https فقط، ولا نطاقات خاصّة، ولا عناوين IPv6 خام، وبمهلة ملزمة. فعنوان يشير إلى داخل شبكتك — أو شبكتنا — يُرفض بـ422 ويقول لماذا.

الإضافة عبر الواجهة

الطلب JSON لا حقول نموذج، والمفتاح في ترويسة Authorization. والجدول الكامل للحقول في مرجع الواجهة — وهو مقروء من العقد نفسه، فلا ينحرف عن السلوك.

curl -X POST https://api.dlal.ai/v1/sources \
  -H "Authorization: Bearer $DLAL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type":"url","uri":"https://help.example.com/shipping"}'

الرد يحمل chunks: عدد المقاطع التي صارت قابلة للاستشهاد. صفرٌ يعني أنّ الصفحة جُلبت ولم يُستخرج منها نصّ — وهو غالباً صفحة تبنيها JavaScript في المتصفّح.

فضّ التعارضات

مصدران يقولان شيئين مختلفين عن الشحن ليسا حالة نادرة؛ هما الحالة الطبيعية بعد ستة أشهر. ودلال لا يرجّح بينهما بالتصويت: الاسترجاع يعيد المقاطع الأقرب دلالياً، وتحت درجة تشابه دنيا لا يُعيد شيئاً أصلاً — فيصعّد بدل أن يخمّن أيّ النسختين أحدث.

هذا قرار تصميم، لا نقص. «الأحدث يفوز» يحتاج تاريخاً موثوقاً لكل مقطع، وأكثر مراكز المساعدة لا تحمله. فالنسخة المتعارضة تُصلَح عندك، والرد يتغيّر في الاستيعاب التالي.

المزامنة

الاستيعاب يقع عند الإضافة، لا في خلفية مجدولة: الطلب يعود بعد أن يصير المصدر قابلاً للاستشهاد فعلاً، فلا نافذة يبدو فيها المصدر مضافاً وهو ليس كذلك. وإعادة الإرسال لنفس العنوان تستوعبه من جديد.

وإن كانت لديك نقطة استقبال webhook مسجّلة، يصلك source_synced بمعرّف المصدر وعدد المقاطع — بلا شيء من محتوى المستند.

القيم المقبولة لحقل type في هذه الصفحة مقروءة من العقد: «url» · «sitemap» · «file».