المساعد الذكي داخل النظام

إلى جانب ربط العملاء الخارجيين عبر خادم MCP، يحتوي نظام نما على مساعد ذكي مدمج يعمل من داخل الواجهة مباشرة: نافذة محادثة يفتحها المستخدم ويسأل فيها بلغته الطبيعية — عربيةً أو إنجليزية — فيجيب المساعد من بيانات النظام الفعلية، ويشغّل التقارير، بل وينفّذ إجراءات، مستخدمًا نفس أدوات الذكاء الاصطناعي التي عرّفها مدير النظام وبنفس صلاحيات المستخدم الجالس أمام الشاشة.

المتطلبات

• وحدة الذكاء الاصطناعي (AI Module) مركبة ومرخصة.
• نموذج محادثة واحد على الأقل معرَّف في إعداد وحدة الذكاء الاصطناعي.
• الفهرس الدلالي مضبوطًا في الإعدادات نفسها: Open AI Embedding Key وText Embedding Model وVector Store URI (انظر إعداد التضمين الدلالي). بدونها لا يبدأ المساعد، وتجيب المحادثة الجديدة بالرسالة AI vector store is not configured (بالإنجليزية حتى على الشاشات العربية). عملاء MCP الخارجيون لا يحتاجون ذلك.
• أداة واحدة على الأقل معتمدة في شاشة AI Tool Definition (وإلا فالمساعد يحاور لكنه لا يصل إلى بيانات النظام).

أين تجد المساعد؟

أيقونة المساعد الذكي (Nama AI Assistant) ظاهرة في شريط الأدوات العلوي للنظام، تفتح نافذة المحادثة في أي وقت. كما يظهر المساعد أيضًا:

• داخل شاشات التقارير: تفتح المحادثة وأنت أمام تقرير، فيصبح ناتج التقرير الظاهر سياقًا يستطيع المساعد قراءته وتحليله — تسأله مثلًا أن يلخّص النتائج أو يبرز أعلى القيم.
• داخل شاشات تحرير السجلات: لمناقشة السجل المفتوح أمامك.

ماذا يستطيع المساعد أن يفعل؟

المساعد لا يملك أي قدرة من تلقاء نفسه — كل ما يفعله يمر عبر أداة معرّفة في شاشة AI Tool Definition. فإذا عرّفت أدوات استعلام وتقارير ومسارات كيان وأدوات نظام، صار بإمكان المساعد أن:

• يجيب عن أسئلة من بياناتك («كم عدد فواتير المبيعات هذا الشهر؟»، «من هم أعلى خمسة عملاء رصيدًا؟»).
• يشغّل تقريرًا بمدخلات يستنتجها من سؤالك ويقرأ ناتجه.
• ينفّذ إجراءً على مستند عبر مسار كيان (اعتماد، حفظ، ...).
• يقرأ سجلًا أو يستورد سجلات جديدة إن فُعّلت أدوات الاستيراد.
• يبحث في توثيق نما إن فُعّلت أداة وثائق النظام.

وفي كل الأحوال تسري صلاحيات المستخدم ومحدداته (الشركة، الفرع، ...): لا يرى المساعد إلا ما يراه المستخدم، ولا ينفّذ إلا ما يُسمح له به.

التعامل مع نافذة المحادثة

اختيار النموذج

أعلى النافذة قائمة منسدلة لاختيار نموذج المحادثة، تعرض النماذج المعرَّفة في إعداد الوحدة. يمكنك التنقل بين النماذج بحسب المهمة — نموذج أسرع للأسئلة البسيطة وآخر أقوى للتحليل المعقّد.

سجل المحادثات

يحفظ النظام محادثاتك في جلسات (Sessions) يمكن الرجوع إليها لاحقًا. من شريط المحادثة الجانبي:

• محادثة جديدة: لبدء جلسة نظيفة بلا سياق سابق.
• السجل (History): يستعرض جلساتك السابقة لاستئناف أيٍّ منها.

كل مستخدم يرى جلساته هو فقط.

تقييم الإجابات (Like / Dislike)

أسفل كل رد من المساعد زرّا إعجاب وعدم إعجاب. تقييمك يُحفظ مع الرسالة، ويساعد على متابعة جودة الإجابات وتحسين إعداد الأدوات والأوصاف لاحقًا.

الوضع المتقدّم (Expert Mode)

في الوضع العادي ترى المحادثة كحوار بسيط (سؤالك وجواب المساعد). أمّا الوضع المتقدّم فيكشف ما يجري خلف الكواليس ويصنّف كل رسالة:

نوع الرسالة	المعنى
User	رسالتك أنت
Assistant	رد النموذج اللغوي
System	تعليمات النظام الموجِّهة للنموذج
Tool Execution Result	ناتج تنفيذ أداة استدعاها النموذج

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

قائمة الأدوات المتاحة

يعرض الشريط الجانبي الأدوات المتاحة للمساعد في هذه الجلسة — وهي نفسها الأدوات المعتمدة وغير المعطلة المسموح بها لهذا المستخدم في شاشة AI Tool Definition. إن غابت أداة تتوقعها، فالغالب أنها غير معتمدة، أو معطّلة، أو ممنوعة عن المستخدم بجدول الصلاحيات.

كيف يختار المساعد أدواته

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

لهذا قد تكون الأداة في القائمة ولا تُستدعى أبدًا. إن أجاب المساعد دون الأداة التي توقعتها، فانظر أولًا في Description الأداة: يجب أن يُقرأ كالأسئلة التي يطرحها الناس فعلًا. أداة تقرير وصفها «تقرير أرصدة العملاء» فقط مطابقتها ضعيفة لسؤال «من أكثر من يدين لنا هذا الشهر؟»، أما الوصف الذي يقول ماذا يجيب التقرير، بالكلمات التي يستخدمها المستخدم، فيُختار. ويُظهر الوضع المتقدّم الأدوات التي استُدعيت مع كل رسالة.

حين لا يجد المساعد ما يبحث عنه

كثير من الأدوات تأخذ مرجعًا (عميل، صنف، ...). إذا أرسل المستخدم اسمًا تقريبيًا بدل الكود، يستعين المساعد بـالبحث الدلالي (Semantic Search) ليجد أقرب السجلات — شريطة أن يكون نوع الكيان مفهرسًا في إعداد التضمين الدلالي. بدون هذه التهيئة يبقى المساعد قادرًا على العمل بالأكواد الصريحة، لكنه لا «يخمّن» المرجع من نص حر.

علاقة المساعد بخادم MCP

المساعد الداخلي وعملاء MCP الخارجيون وجهان لقاعدة واحدة: كلاهما يستخدم نفس مجموعة الأدوات المعرَّفة في شاشة AI Tool Definition، وبنفس فحص الصلاحيات عند التنفيذ. الفرق أن المساعد الداخلي يعمل داخل واجهة النظام بهوية المستخدم المسجَّل دخوله، بينما يتصل العميل الخارجي عبر بيانات اعتماد API كما في دليل خادم MCP.