AI Copilot للتاجر في ڤاريونس: مساعد المحادثة للطلبات والولاء والموظفين والتصميم
مساعد محادثة داخل لوحة تحكم التاجر يقرأ بيانات متجرك عبر أدوات مقيدة بالصلاحيات، ويلخص الطلبات والولاء والموظفين والمظهر، ويجهز التعديلات كمسودة تنتظر تأكيدك الصريح قبل التنفيذ.
آخر تحقق: 2026-09-19
يعمل AI Copilot للتاجر عبر مسار POST /api/ai-copilot/chat داخل اللوحة. يرسل العميل سجل المحادثة مع مصدر المفاتيح keySource: إما platform الذي يستخدم مفاتيح ڤاريونس وحصة الخطة المجانية، أو tenant الذي يستخدم مفتاح API المشفر الخاص بمتجرك. ويرسل العميل أيضاً مسار الصفحة الحالي pageContext.pathname لتضييق قائمة الأدوات المعروضة على النموذج، وهذا توجيه للتجربة فقط وليس حداً أمنياً: عزل المستأجر يبقى مشتقاً من الجلسة ولا يُقبل من العميل.
تغطي الأدوات فئات كثيرة، أهمها للتاجر: الطلبات (عرض وقائمة وملخص وعدد وخط زمني، ثم إنشاء وتحديث وتغيير حالة وإلغاء وأرشفة واستعادة وملاحظات وتتبع)، والولاء (الملخص والإعدادات والمكافآت وإضافة النقاط وتعديلها والاستبدال وطلبات الاستبدال وكبار المستهلكين)، والموظفون (اثنتا عشرة أداة قراءة: نظرة عامة وملف كامل وقوائم الحسابات والموظفين والحضور والإجازات والأداء والمرتبات والرؤى)، ومظهر المتجر (الهوية وتخطيط الموقع والصفحات الثابتة والمكونات العامة وإعدادات المكونات وحل الصفحة).
القاعدة الأمنية الأهم: لا ينفذ المساعد أي تعديل مباشرة. كل تعديل يعود بحالة confirmation_required مع رمز دفعة واحد لعدة تعديلات، ولا يُنفذ إلا عبر POST /api/ai-copilot/confirm. وتعديلات المحرر الحي تُخزن كمسودة برمز أحادي الاستخدام وتُستهلك عبر POST /api/ai-copilot/draft/consume. والنص الظاهر للتاجر يُنقح من الأسرار والمفاتيح والمسارات والمعرفات التقنية، ومحتوى التفكير reasoningContent لا يغادر الخادم.
خطوات الإعداد في ڤاريونس
افتح المساعد من اللوحة
من أي صفحة في لوحة التحكم افتح زر المساعد. يعرض اللوح شرائح اقتراحات سريعة عندما تكون المحادثة فارغة، وهي مرتبطة بمسار الصفحة الحالي لتوجهك لما يمكن سؤاله هنا.
اختر مصدر المفاتيح
اختر platform لاستخدام مفاتيح ڤاريونس مع حصة خطتك المجانية، أو tenant لاستخدام مفتاح API الخاص بمتجرك المحفوظ في /dashboard/ai-usage/api-keys. المصدر الخاطئ يرفضه الخادم بخطأ صريح.
اسأل عن الطلبات والولاء والموظفين
اطلب ملخص الطلبات أو تفاصيل طلب برقمه، أو ملخص الولاء وأرصدة عميل، أو ملف موظف وحضوره. القراءة تتطلب صلاحية العرض لكل قسم، والكتابة تتطلب الإنشاء أو التعديل.
اقترح تعديلاً على المظهر
اطلب تغيير لون أو شعار أو نص في صفحة. الألوان والشعار تمر عبر مسار branding، وبقية التخطيط عبر website-layout، والمحتوى عبر الصفحات الثابتة والمكونات. في المحرر الحي تُحفظ التعديلات كمسودة معاينة.
راجع ثم أكّد التنفيذ
لا يُنفذ أي تعديل تلقائياً. راجع المسودة المعروضة، ثم أكّد عبر زر التأكيد ليستدعي العميل POST /api/ai-copilot/confirm (أو draft/consume في المحرر الحي). يمكنك تجاهل المسودة دون أي أثر.
تابع النشاط من سجل الاستخدام
افتح /dashboard/ai-usage لمراجعة ملخص التوكن وسجلات الطلبات وجدول تدقيق الأدوات لآخر التنفيذات، وتأكد أن ما نفذه المساعد يطابق ما أكّدته.
أسئلة شائعة
هل ينفذ المساعد التعديلات تلقائياً؟
لا. كل تعديل يعود كمسودة بحالة confirmation_required ولا يُنفذ إلا بعد تأكيدك الصريح عبر مسار التأكيد، ومسودات المحرر الحي أحادية الاستخدام.
هل يرى المساعد بيانات متاجر أخرى؟
لا. معرف المستأجر مشتق من الجلسة على الخادم فقط ولا يُقبل من العميل، وكل أداة تفحص صلاحياتك قبل التنفيذ.
ما الفرق بين keySource بقيمة platform وtenant؟
قيمة platform تستخدم مفاتيح ڤاريونس مع حصة خطتك المجانية الشهرية، وقيمة tenant تستخدم مفتاح API الخاص بمتجرك المحفوظ والمشفر في صفحة المفاتيح.
هل يمكن للموظفين استخدام المساعد؟
نعم ضمن صلاحياتهم: كل أداة تطلب صلاحية القسم نفسه، فموظف الطلبات يرى الطلبات فقط إذا كان يملك صلاحية عرض الطلبات، وهكذا.
ماذا يحدث إذا منعت خطتي فئة أدوات؟
تُرفض الأدوات في الفئات المحظورة بخطأ COPILOT_PLAN_TOOL_CATEGORY_DENIED قبل التأكيد أو التنفيذ، بينما تبقى أدوات المساعدة help_docs متاحة دائماً.
هل تظهر مفاتيح API في ردود المساعد؟
لا. النص الظاهر يُنقح من الأسرار والمفاتيح وكلمات المرور والمعرفات التقنية على الخادم وفي الواجهة، ولا تُرسل نتائج الأدوات الخام للمتصفح.
استكشاف الأخطاء
لماذا رُفض طلبي؟ 1) إذا ظهر COPILOT_PLAN_TOOL_CATEGORY_DENIED فالفئة محظورة في خطتك. 2) إذا رُفضت قراءة فقسمك بلا صلاحية العرض، واطلبها من مدير المتجر. 3) إذا لم يُنشأ منتج فالأرجح غياب فئة المتجر: الإنشاء يتطلب product.category. 4) إذا ظهر STREAM_UNSUPPORTED_PROVIDER فالبث يعمل مع OpenAI فقط في النسخة الحالية. 5) إذا لم تُنفذ مسودة المحرر الحي فتأكد أنك تستهلكها عبر draft/consume مرة واحدة وليس confirm.
حدود مهمة
• التعديلات لا تُنفذ دون تأكيد صريح، حتى لو طلب النموذج ذلك. • البث يعمل مع OpenAI فقط حالياً. • توليد مستندات Word يقتصر على 2MB قبل الترميز. • سياسة الخطة قد تحجب فئات كاملة رغم امتلاكك الصلاحية. • درجات التقييم والإشارات المساعدة ليست قرارات منع تلقائية.