دراسة حالة · لوحة قيادة للمشغّل
Ana Concierge OS
لوحة قيادة محلية أولاً لإدارة الملفات، يستطيع فيها المساعد أن يصوغ ويستشهد ويقترح، ويوافق إنسان على كل إجراء.
- الدور
- المطوّر الوحيد
- التقنيات
- TypeScript, React, Fastify, PostgreSQL, zod, Vitest
- الحالة
- أساس محلي يعمل؛ والإجراءات الخارجية خارج النطاق عن قصد
- الطبقات
- الواجهات، الأنظمة، النماذج، البيانات والتقييم
- من بنائي
- إنسان، أو نموذج خارجي
- المشغّلإنسان
- خادم Anaمن بنائي
- النموذجعبر مُشغِّل مقيَّد
- من المشغّل إلى خادم Ana: يسأل عن ملف
- خادم Ana: يعيد بناء السياق من PostgreSQL
- خادم Ana: يسترجع المقاطع ضمن النطاق
- من خادم Ana إلى النموذج: التعليمة والمقاطع؛ دون shell ودون أدوات عامة
- النموذج: يصوغ إجابة
- من النموذج إلى خادم Ana: JSON مطابق للمخطط: الإجابة، والاستشهادات، والإجراء المقترح
- خادم Ana: يرفض الاستشهادات غير المسترجعة والإجراءات الخارجة عن النطاق
- خادم Ana: يُجزّئ الاقتراح ويضعه في الطابور
- من خادم Ana إلى المشغّل: إجابة بمصادرها؛ واقتراح ينتظر الموافقة
- المشغّل: يوافق أو يرفض
- من المشغّل إلى خادم Ana: القرار
- خادم Ana: يسجّله في سجلّ التدقيق
الحدّ مكانه البنية
عمل خدمة الكونسيرج تيار من الملفات: أشخاص وطلبات ومتابعات ووثائق، والمعرفة اللازمة لإجابة جيدة. يستطيع المساعد أن يساعد في ذلك كله، شرط ألّا يختلق مصدراً أبداً وألّا يتصرّف وحده أبداً.
Ana Concierge OS محاولتي لبناء هذا الحدّ داخل البنية بدل التعليمة. يعمل محلياً، ويحفظ حالته في PostgreSQL، ويعامل النموذج كأداة صياغة يتحقّق الخادم من مخرجاتها ويوافق عليها إنسان.
ستة قرارات تُبقي المساعد أميناً
- 01 · الأنظمة
ملفات بقواعد وسجلّ
تعيش الملفات والعلاقات والمهام والمتابعات في PostgreSQL خلف واجهة Fastify برمجية مُنمَّطة، مع قواعد حتمية للملفات وطوابير عمل يومية وسجلّ للتدقيق.
بنيتُ الواجهة البرمجية بـ Fastify على Node.js، مع تحقّق zod من معاملات المسارات وسلاسل الاستعلام وأجسام الطلبات. وتشترط مسارات /v1/* رمز وصول (bearer token).
- 02 · الأنظمة
سياق يُعاد بناؤه على الخادم
تبدأ كل جولة للمساعد من حالة مرجعية يُعاد بناؤها من قاعدة البيانات، لا مما تصادف أن تتذكّره المحادثة.
- 03 · البيانات
استرجاع محدّد النطاق
تُوحَّد مصادر المعرفة وتُقسَّم وتُراجَع قبل تفعيلها. ويستخدم البحث النص الكامل في PostgreSQL، مُصفّى بحسب مساحة العمل والملف وحالة المراجعة والتاريخ والتصنيف، ويترك كل استرجاع أثراً.
- 04 · النماذج
نموذج تحت سيطرة محكمة
يشغّل المُشغِّل المحلي عميل النموذج دون shell، ويمرّر التعليمة عبر الإدخال القياسي، ويعطّل الأدوات العامة، ويشترط JSON مطابقاً للمخطط، ويتوقّف عند انتهاء المهلة.
- 05 · الأنظمة
استشهادات متحقَّق منها، وموافقة بشرية
يرفض الخادم أي استشهاد بمقطع لم يُسترجَع، وأي إجراء خارج نطاق المحادثة. وتُجزَّأ الاقتراحات وتنتظر في طابور الموافقة حتى يقرّر إنسان.
- 06 · البيانات
استيرادات تبقى محلية
استيراد الوثائق محلي ومحدود، يُتحقَّق منه بالتجزئة ويبقى معلّقاً حتى المراجعة، دون أي استدعاء للنموذج.
لوحة قيادة تُظهر عدم يقينها
واجهة React متجاوبة فيها عرض لأولويات اليوم، إلى جانب الملفات والعلاقات والمعرفة والاستيرادات والموافقات ومساعد دائم. وتُظهر إجابات المساعد استشهاداتها وعدم يقينها والإجراءات المقترحة بدل إخفائها.
ويتيح وضع استكشاف اصطناعي تصفّح المنتج كله دون أي بيانات تشغيلية.
اختبارات حيث يقع الحدّ
تغطي اختبارات الوحدات والتكامل الموافقاتِ، وسلامةَ المساعد، واسترجاعَ المعرفة، وخصوصيةَ استيراد الوثائق وقبولَه، وعزلَ مُشغِّل النموذج. وتختبر سكربتات فحص سريعة الواجهةَ البرمجية والمساعدَ من البداية إلى النهاية.
ما هو، وما ليس هو
الحالة. أساس محلي يعمل لإدارة الملفات؛ ولا أذكر له أي أرقام عن الاستخدام أو الاعتماد.
النطاق. الموصِّلات الخارجية للمراسلة والبريد الإلكتروني والتقويمات، وأي إجراء مستقل، خارجه عن قصد. والاسترجاع بحث معجمي في PostgreSQL، وقد تأتي التضمينات (embeddings) لاحقاً.
