مساعد التسوق

مساعد التسوق محادثة في متجرك. يسأل المتسوق بالعربية أو الإنجليزية («أبغى فستان سهرة أحمر بأقل من 100»، «قارن بين أول اثنين»، «ما سياسة الإرجاع؟») فيحصل على إجابة قصيرة مع بطاقات منتجات من كتالوجك أنت، وإجابات من صفحات متجرك أنت.

القاعدة: الحقائق من بياناتك فقط

لا يخترع المساعد سعرًا ولا حالة مخزون ولا مواصفة أبدًا. وهذا مبني في النظام نفسه، لا مجرد وعد في التعليمات:

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

وإذا كان الذكاء الاصطناعي متوقفًا أو بطيئًا أو تجاوز الميزانية، تبقى الإجابات الجاهزة تعمل، ويحصل المتسوق على بطاقات المنتجات.

ما قسناه

في 200 محادثة مكتوبة مسبقًا و43 محاولة اختراق للتعليمات على كتالوج العرض (agent-recorded stand-in, not live Haiku 5.5): لم يُخترع أي سعر ولا حالة مخزون ولا مواصفة في 830 إجابة؛ وأظهرت 93.01% من الإجابات بطاقة منتج صالحة؛ وصُدّت 43 محاولة من أصل 43. المصدر: eval/report.md.

التفعيل

الباقة. المساعد متاح بحزمة مدفوعة في باقتي Growth وPro، ومضمَّن في Enterprise. ولا يوجد مساعد في Starter. راجع الباقات والفوترة.
الإعدادات. افتح المساعد في لوحة التحكم: فعّله، واضبط الاسم الذي يراه المتسوقون (الافتراضي اسأل <اسم المتجر>)، والتحية بالإنجليزية والعربية، والأسلوب، وميزانية الذكاء الاصطناعي الشهرية (بالدولار)، والتحويل إلى موظف (رقم واتساب أو رقم هاتف أو بريد إلكتروني).
صفحات المتجر. أضف أسئلتك الشائعة وسياساتك (الشحن، الإرجاع، الضمان، الدفع) في المساعد > الأسئلة الشائعة والسياسات. حتى 500 صفحة لكل متجر. ولا يجيب المساعد عن أسئلة السياسات إلا من هذه الصفحات.
المفتاح. أنشئ مفتاحًا عامًا مع خيار السماح أيضًا بمساعد التسوق (نافذة المحادثة). فالمفتاح العام العادي يتيح البحث والأحداث فقط.
الأداة. أضف data-assistant="on" إلى أداة البحث بلغة JavaScript. ولا يظهر زر المحادثة إلا إذا كان المساعد مفعّلًا لمتجرك.

التحويل إلى موظف

عندما يطلب المتسوق شخصًا، أو لا يستطيع المساعد المساعدة، يعرض رابط واتساب أو الهاتف أو البريد الخاص بك مع ملخص قصير للمحادثة. ويُرسل إشعار assistant.handover ليتابع فريقك.

الحدود

20 رسالة من المتسوق في كل محادثة، و40 رسالة في الساعة لكل جلسة متسوق (ثم يُرد بـ HTTP 429).
كل إجابة قصيرة (450 رمزًا على الأكثر) ولها حد زمني 8 ثوانٍ.
عند نفاد حزمة المحادثات أو ميزانية الذكاء الاصطناعي، تخبر المحادثة المتسوق بذلك بلطف، ويبقى يحصل على بطاقات البحث.

الخصوصية والمحادثات المحفوظة

تُحفظ المحادثات لتقرأها في المساعد > المحادثات، مع إخفاء البريد الإلكتروني وأرقام الهواتف. وتُحذف بعد مدة الاحتفاظ بالسجلات لديك (90 يومًا افتراضيًا). راجع الأمان وبياناتك.

الواجهة البرمجية

POST /v1/assistant/chat (مفتاح عام فيه صلاحية assistant): بصيغة JSON، أو بثّ أحداث متتابع (delta، products، done).
GET /v1/assistant/widget?locale=ar: هل المحادثة مفعّلة، واسمها وتحيتها.
GET/PUT /v1/assistant/settings و/v1/assistant/knowledge و/v1/assistant/conversations (مفتاح سري أو لوحة التحكم).

التفاصيل في مرجع الواجهة البرمجية.