كل الأعمال / شخصي
Notee مساعد مستندات ذكي مبني بـ Next.js وLangChain
مساعد ذكي لمستنداتك: ارفع مصادرك ثم اسأل عنها في محادثات منظمة.
ما الذي يفعله
لكل محادثة في Notee مصادرها الخاصة: ترفق بها ملفات PDF ثم تسأل بالعربية أو الإنجليزية. ومع كل سؤال يقرر المساعد أين يبحث، في هذه الملفات أم في الويب، ثم يجيب مما وجده. هو مشروع شخصي بنيت فيه الواجهة بـ Next.js والنظام الخلفي بـ Strapi.
كيف يُجاب عن السؤال
حين تتغير مصادر المحادثة، تُقسَّم ملفاتها إلى مقاطع من 500 حرف يتداخل كل منها مع سابقه بخمسين حرفاً، ثم تُحوَّل إلى متجهات بنموذج text-embedding-3-small من OpenAI وتُحفظ في فهرس متجهات على Redis خاص بهذه المحادثة وحدها. بعدها يعمل وكيل LangChain بأداتين: البحث في هذا الفهرس واسترجاع أقرب ثلاثة مقاطع، والبحث في الويب عبر Tavily. ويبقى سجل كل محادثة في Redis سبعة أيام، ويصل الرد إلى المتصفح أولاً بأول أثناء كتابته.
قرارات في التصميم
لا يُعاد بناء الفهرس إلا إذا تغيّرت قائمة مصادر المحادثة فعلاً: تُحفظ روابط المصادر إلى جانبه وتُقارن مع كل طلب، فلا تُعالَج الملفات نفسها من جديد مع كل سؤال. ويعمل النموذج عبر واجهة متوافقة مع OpenAI، هي OpenRouter افتراضياً، فيمكن تبديله من الإعدادات. وقيمة temperature صفر لأن استدعاء الأدوات يكون أدق بها، ولا يتجاوز الوكيل ست خطوات.
الواجهة والنظام الخلفي
الواجهة البرمجية مبنية بـ Strapi 5 وTypeScript، مع مسارات مخصصة لإضافة مصادر المحادثة وحذفها وقراءة رسائلها وبث الرد. ويتم تسجيل الدخول عبر نظام المستخدمين والصلاحيات في Strapi، ومنه الدخول بحساب Google. أما الواجهة الأمامية فمبنية بـ Next.js (App Router) مع TanStack Query وReact Hook Form وZod ومكوّنات shadcn/ui، وتُعرض الإجابات بتنسيق Markdown. ويعمل Redis Stack، الذي يوفّر البحث بالمتجهات، من ملف Docker Compose.