مساعد ذكاء اصطناعي لمتجر سلة بالعربي: كيف بنينا IAI
- نُشر
- القراءة
- قراءة في 8 دقائق
- الكاتب
- محمود حمديمهندس برمجيات متكامل (Full-Stack)
IAI مساعد ذكاء اصطناعي لمتجر سلة سعودي يبيع منتجات الطباعة ثلاثية الأبعاد، يجيب العملاء بالعربية عن المنتجات والطلبات عبر نافذة محادثة في المتجر وعبر روبوت على Telegram. يأخذ إجاباته من قاعدة معرفة يكتبها المتجر، ومن بيانات المنتجات والطلبات التي يقرؤها عبر واجهة سلة البرمجية، ويحوّل المحادثة إلى موظف حين لا يكون واثقًا من الرد.
بنيت المساعد كاملًا، من خدمة المحادثة إلى لوحة التحكم والنشر. في هذا المقال أشرح كيف يعمل، ولماذا صُمّم بهذا الشكل، وما الذي يجب أن ينتبه له من يفكر في شات بوت لمتجره على سلة.
ما الذي يفعله مساعد ذكاء اصطناعي لمتجر سلة، وما الذي لا يفعله
أغلب أسئلة عملاء أي متجر إلكتروني تتكرر: هل هذا المنتج متوفر، كم سعره، أين طلبي، ما سياسة الإرجاع. كان المطلوب في IAI أن تأتي الإجابة عن هذه الأسئلة من معلومات المتجر نفسه وكتالوجه الحالي، لا من روبوت محادثة عام يخمّن.
لذلك لا يجيب المساعد من معرفة النموذج العامة. النموذج اللغوي هنا أداة صياغة: يتسلّم السؤال ومعه النصوص والبيانات المتعلقة به، ثم يكتب منها ردًا عربيًا واضحًا. إن لم تكن المعلومة في قاعدة المعرفة أو في بيانات المتجر، فليس من دوره أن يخترعها.
تمر كل رسالة داخل الخدمة بأربع خطوات:
- تصل الرسالة من نافذة المتجر أو من Telegram إلى خدمة واحدة مبنية بـ Node.js وTypeScript.
- يُصنَّف السؤال لمعرفة نيته: طلب، أو منتج، أو سؤال شائع، أو شحن، أو إرجاع، أو طلب التحدث إلى موظف.
- تُجمع المعلومات اللازمة للرد: فقرات من قاعدة المعرفة، أو بيانات منتج أو طلب من سلة.
- يكتب النموذج الرد عبر واجهة OpenAI أو Anthropic، أو تُحوَّل المحادثة إلى موظف إن كانت الثقة أقل من الحد المضبوط.
قناتان وخدمة واحدة: نافذة المتجر وTelegram
يدخل العميل من نافذة محادثة على موقع المتجر، أو من روبوت على Telegram. القناتان واجهتان فقط، والمنطق كله في خدمة واحدة، فلا تختلف إجابة السؤال نفسه باختلاف المكان الذي طُرح فيه.
في Telegram استخدمت الأزرار المضمّنة في الرسائل (inline keyboards)، فيختار العميل من خيارات جاهزة بدل أن يكتب كل شيء. ويتعرّف المساعد على لغة الرسالة، فيرد بالعربية على من كتب بالعربية وبالإنجليزية على من كتب بها، لأن جمهور المتجر ثنائي اللغة.
البحث الدلالي في قاعدة المعرفة: لماذا لا يكفي البحث بالكلمات
قاعدة المعرفة نصوص يكتبها المتجر عن سياساته وإجابات أسئلته المتكررة. المشكلة أن العميل لا يكتب بكلمات المتجر. قد يسأل «متى يوصل طلبي؟» والجواب مكتوب تحت عنوان «مدة الشحن»، وليس بين الجملتين كلمة مشتركة تقريبًا.
البحث الدلالي يحل هذه المشكلة. تُحوَّل كل فقرة من القاعدة مسبقًا إلى متجه رقمي (embedding) يمثّل معناها، ويُحوَّل السؤال عند وصوله بالطريقة نفسها، ثم تُختار الفقرات الأقرب إليه في المعنى. هذه الفقرات وحدها هي ما يُعطى للنموذج ليجيب منه، ويُعرف هذا النمط عمومًا باسم التوليد المعزز بالاسترجاع (RAG).
وهناك أمور تستحق الانتباه عند بناء قاعدة كهذه بالعربية. الفقرة القصيرة التي تتناول موضوعًا واحدًا تُسترجع بدقة أكبر من صفحة طويلة تخلط الشحن بالإرجاع. واختلاف صيغ الكلمة الواحدة، مثل الشحن والشحنة والتوصيل ويوصل، تقل مشكلته مع البحث الدلالي لكنه لا يختفي تمامًا.
والأهم أن جودة المساعد لا تتجاوز جودة ما كُتب في القاعدة. إن لم تكن سياسة الإرجاع مكتوبة فيها، فلن يعرفها المساعد، وهذا مقصود في التصميم.
تصنيف السؤال على مرحلتين قبل كتابة أي رد
لا يذهب كل سؤال مباشرة إلى النموذج ليكتب ردًا. قبل ذلك يمر بمصنّف للنية على مرحلتين.
الخطوة الأولى مرشّح سريع بالكلمات المفتاحية يضيّق الاحتمالات، فرسالة فيها رقم طلب أو كلمة «طلبي» غير رسالة تسأل عن منتج بعينه. وفي الخطوة الثانية يقيّم النموذج السؤال مقابل النوايا الست المذكورة أعلاه.
وعمومًا، للمرشّح بالكلمات فائدة عملية في أي مساعد. فهو رخيص وسريع، فيخفف الحمل عن النموذج، ويجعل سلوك المساعد أسهل في التتبع حين يخطئ. أما ناتج التقييم الثاني فليس النية وحدها، بل درجة ثقة فيها أيضًا، وهي التي تحدد ما يحدث بعد ذلك.
ربط متجر سلة بـ API: قراءة المنتجات والطلبات
سؤال «هل المنتج متوفر؟» لا تجيب عنه قاعدة المعرفة، لأن المخزون يتغير كل يوم. لهذا يقرأ IAI المنتجات والأسعار والمخزون وحالة الطلبات من واجهة سلة البرمجية بطريقتين: استعلام دوري يحدّث بيانات الكتالوج، وwebhooks ترسلها سلة إلى الخدمة حين يتغير شيء في المتجر.
ومن يبني تكاملًا مشابهًا يحتاج إلى ثلاثة أمور يشرحها توثيق سلة للمطورين:
- الصلاحية عبر OAuth: رمز الوصول صالح أسبوعين، ورمز التحديث صالح شهرًا ويُستخدم مرة واحدة فقط. إن استُخدم مرتين، كأن تحاول عمليتان متوازيتان التحديث في اللحظة نفسها، تلغي سلة الرموز ويضطر التاجر إلى إعادة تثبيت التطبيق. لذلك يجب أن يحدث تجديد الرمز في مكان واحد من الخدمة.
- التحقق من الـ webhook: ترسل سلة مع كل حدث ترويسة X-Salla-Signature، وهي بصمة SHA256 لجسم الطلب محسوبة بمفتاح سري. احسب البصمة بنفسك وقارنها مقارنة آمنة زمنيًا قبل أن تصدّق أي حدث.
- حدود المعدل: تحدد سلة عدد الطلبات في الدقيقة بحسب الخطة، فهو 120 طلبًا في الدقيقة في خطة Plus مثلًا، وترجع ترويسات مثل X-RateLimit-Remaining وRetry-After. مساعد يسأل سلة عند كل رسالة يصل إلى هذا الحد بسرعة.
هذا مثال توضيحي للتحقق من التوقيع في Node.js بحسب ما يصفه التوثيق:
import { createHmac, timingSafeEqual } from "node:crypto";
export function isFromSalla(rawBody: string, signature: string, secret: string) {
const expected = createHmac("sha256", secret).update(rawBody).digest("hex");
const a = Buffer.from(expected);
const b = Buffer.from(signature);
return a.length === b.length && timingSafeEqual(a, b);
}
وأمر أخير يخص أسئلة الطلبات: لا يكفي أن يكتب شخص رقم طلب ليعرف تفاصيله. ما أنصح به أن يتحقق المساعد من أن السائل صاحب الطلب، برقم الجوال المسجل أو بطريقة يتفق عليها المتجر، قبل أن يعرض أكثر من حالة الطلب.
التخزين المؤقت للإجابات المتكررة
يخزّن IAI الإجابات المتكررة مؤقتًا. كثير من الأسئلة تتكرر بصيغ متقاربة، واستدعاء النموذج لكل منها يكلّف مالًا ووقتًا، والرجوع إلى سلة في كل مرة يستهلك حد المعدل.
لكن ليس كل جواب صالحًا للتخزين بالمدة نفسها. جواب سياسة الإرجاع يبقى صحيحًا أسابيع، وجواب «هل المنتج متوفر؟» قد يتغير بعد ساعة، أما جواب «أين طلبي؟» فيخص عميلًا واحدًا ولا يجوز أن يصل إلى غيره.
لذلك فالقاعدة التي تستحق الانتباه في أي مساعد لمتجر: مدة صلاحية تختلف بحسب نوع السؤال، ومسح الجواب المخزّن عن منتج بمجرد أن يصل webhook بتحديثه، وعدم تخزين أي رد يحمل بيانات عميل بعينه.
متى يحوّل المساعد المحادثة إلى موظف
درجة الثقة الناتجة عن التصنيف هي ما يقرر إن كان المساعد يرد بنفسه أو يحوّل المحادثة إلى موظف. ومن طلب التحدث إلى إنسان صراحةً فطلبه نية معروفة في المصنّف، فيُحوَّل مباشرة دون أن يحاول المساعد إقناعه بالبقاء.
يضبط صاحب المتجر حد الثقة وقواعد التحويل وقوالب الردود من لوحة التحكم دون أي تعديل في الكود. صاحب المتجر أعرف بأي الأسئلة يحتمل الخطأ وأيها لا يحتمله، فالأفضل أن يكون القرار في يده لا في يد المبرمج.
لوحة التحكم ومستودع واحد لكل أجزاء المساعد
لوحة التحكم تطبيق Next.js مستقل عن خدمة المساعد. يرى فيها صاحب المتجر سجلات المحادثات وتوزيعها على النوايا، ويعدّل القوالب وقواعد التحويل.
والمشروع كله مستودع واحد (monorepo) يديره Turborepo، فيه ثلاث حزم: خدمة المساعد، ولوحة التحكم، وحزمة مشتركة تضم أنواع TypeScript وأدوات الاتصال بواجهة سلة ومخططات التحقق من البيانات. نتيجة هذا التقسيم أن شكل القالب أو قاعدة التحويل يُعرَّف مرة واحدة، فلا يتغير في اللوحة دون أن تعرف به خدمة المساعد. ويُشغَّل كل ذلك عبر Docker.
ما لا ننشره عن IAI وحدود ما بنيناه على سلة
لا أنشر أرقام استخدام لـ IAI: لا عدد محادثات، ولا نسبة ردود صحيحة، ولا أثرًا على المبيعات. ليست لدينا أرقام موثّقة عنه.
والحدود واضحة كذلك. بنيت مساعدًا واحدًا متصلًا بمتجر واحد على سلة، ولم نبنِ ثيمات لسلة ولا تطبيقات منشورة في متجر تطبيقاتها. إن كان هذا ما تبحث عنه، فهو عمل لم نقدّمه من قبل.
تفاصيل المشروع في دراسة حالة IAI، وما نبنيه من مساعدات وأدوات أتمتة في صفحة الشات بوت وأتمتة المهام. نحن مهندسان في المنوفية بمصر نعمل عن بُعد لعملاء في مصر والخليج.
إن كانت أسئلة عملاء متجرك على سلة تتكرر كل يوم، أرسل لنا وصفًا قصيرًا.