بعد النجاح الذي حققته منهجيتنا البحثية في تطبيق "الكتاب"، والتي قدمت حلاً لمشكلة "الهلوسة" (Hallucination) في النماذج اللغوية الكبيرة عند التعامل مع نصوص القرآن، قمنا بتحويل هذه الورقة البحثية إلى واجهة برمجية (API) متاحة للمطورين. تهدف هذه المقالة إلى شرح الهندسة الخلفية لـ AlKetab API، وكيف قمنا بتغيير دور الذكاء الاصطناعي من "مولّد للنصوص" (Generator) إلى "محسن للاستعلامات" (Query Optimizer) لضمان (Zero-Hallucination) مع الحفاظ على مرونة اللغة الطبيعية.
لا تحب قراءة المقالات، لا مشكلة ابدأ فورا: AlKetab API
في هذا الدليل، نستعرض كيف قمنا بتغليف هذه المنهجية البحثية في أدوات برمجية تتيح لك نقل هذه الميزة لتطبيقك في دقائق.
1. المنهجية: سد الفجوة بين النماذج اللغوية والنص القطعي
تكمن الإشكالية الكبرى في استخدام الـ LLMs مع القرآن في طبيعتها الاحتمالية (Probabilistic). لذا، قمنا ببناء AlKetab API لتعمل كطبقة وسيطة تستخدم "فهم" الذكاء الاصطناعي، لكنها تعتمد في "الإجابة" على أدوات بحث حتمية (Deterministic Tools).
واجهة الموقع الرئيسية توضح المبدأ الأساسي: أول محرك بحث قرآني "Zero-Hallucination". النظام لا يقوم بتوليد الآيات، بل يقوم باسترجاعها من فهرس موثق بناءً على فهم القصد.
2. أدوات البحث المعززة (Tool-Augmented Search)
بدلاً من الاعتماد على البحث النصي البسيط، قمنا بتزويد الـ API بمجموعة من الأدوات التي تحاكي طريقة بحث العلماء، والتي يمكن لتطبيقك استدعاؤها بطلب واحد.
القدرات التقنية للـ API: تتضمن البحث الموضوعي (Thematic Exploration)، العد الدقيق للكلمات (Precision Counting) الذي يتفادى أخطاء التقدير في الـ LLMs، التحليل الجذري للكلمات (Root & Lemma Analysis)، والفلترة المنطقية (Logic-Aware Filtering) لاستبعاد النتائج المنفية.
3. الفرق الهندسي بين التوليد والاسترجاع
توضح الصورة أدناه الفرق الجوهري في معمارية النظام مقارنة بالنماذج التقليدية.
مقارنة بين "تخمين" النماذج العادية و"دقة" محركنا المعزز بالأدوات. بدلاً من أن يطلب من الذكاء الاصطناعي "تذكر" الآيات، نجعله يعمل كمحسن استعلامات ذكي (Query Optimizer) يتصل بقاعدة بيانات مفهرسة (Indexed Corpus).
4. اختبار النموذج وتجربة الاستعلامات (Live Demo)
يتيح الموقع بيئة تجريبية (Sandbox) للمطورين لاختبار قدرة النموذج على تحويل اللغة الطبيعية إلى استعلامات هيكلية (Structured Queries) قبل البدء في البرمجة.
تجربة حية من الموقع. لاحظ كيف كتب المستخدم "آيات عن الصبر والصلاة" باللغة الطبيعية، وقام الـ AI Analysis في الصندوق البرتقالي بتحليل النية وتحويلها لاستعلام دقيق جلب الآية (واستعينوا بالصبر والصلاة).
5. إدارة المفاتيح والتحليلات (Dashboard)
تم تصميم لوحة التحكم لتمكين المطورين من مراقبة أداء تطبيقاتهم واستهلاك الـ API بشكل لحظي.
لوحة التحكم (Dashboard). توفر نظرة شاملة على الـ API Key، ومخططات بيانية للاستخدام، وسجلات الطلبات (Logs) لمساعدة المطورين على تصحيح الأخطاء (Debugging).
6. مصدر مفتوح (Open Source) للتطبيق الكامل
لتسريع عملية الدمج (Integration)، لم نكتفِ بتوثيق الـ API، بل قمنا بنشر تطبيق iOS كامل مفتوح المصدر مكتوب بلغة Swift.
رابط المشروع على GitHub: AlKetab API Example iOS
مميزات هذا المشروع المفتوح:
- يعمل بالكامل ويوضح كيفية التعامل مع الـ Endpoints الخاصة بالبحث والصفحات (Pagination).
- مكتوب بطريقة معيارية (Modular) تجعل من السهل جداً قراءة المنطق البرمجي (Logic) وتحويله لأي لغة برمجة أخرى سواء Java/Kotlin للأندرويد أو JavaScript للويب.
- قريباً: نعمل حالياً على توفير نسخ جاهزة للأندرويد وتطبيقات الويب (React/Next.js) لتغطية كافة المنصات.
7. نموذج التكلفة ودعم "إتقان"
من المعلوم أن البنية التحتية للذكاء الاصطناعي تمثل التكلفة التشغيلية الأكبر، لا سيما مع اعتمادنا حالياً على نموذج Gemini 3 المتطور. وبالإضافة إلى ذلك، اتخذنا قراراً تقنياً بتجنب الـ "Cold Boot" للحفاظ على خوادم نشطة تضمن سرعة استجابة قصوى، رغم ما يفرضه ذلك من تكاليف إضافية.
لذا، نتوجه بالشكر لـ إتقان على مبادرتها بتقديم رصيد مجاني بقيمة 5$ لكل مطور؛ وهو رصيد كافٍ تماماً لتغطية مرحلة التطوير والبدء الفعلي في دمج الميزة داخل أي مشروع دون عوائق مالية. التكلفة بعد ذلك مدروسة بعناية (1 دولار = 1000 رصيد) لضمان الاستدامة.
ابدأ فوراً
أدخل على موقع AlKetab API فمن خلال توفير الواجهة البرمجية، والأمثلة مفتوحة المصدر، والرصيد المجاني، نهدف لتمكين مجتمع المطورين من بناء جيل جديد من التطبيقات القرآنية الذكية في وقت قياسي.
