تطبيق الذكاء الاصطناعي في ڤاريونس: التثبيت ولوحة الاستهلاك والمفاتيح
تطبيق الذكاء الاصطناعي هو بطاقة id ai-copilot في السوق تفتح مسار /dashboard/ai-usage: لوحة مراقبة رموز شهرية وثلاثين يوماً مع سجل طلبات وتصدير CSV ورؤى وتدقيق أدوات، وصفحة مفاتيح مزودين منفصلة للحفظ والاختبار.
آخر تحقق: 2026-09-19
يثبَّت التطبيق من سوق /dashboard/apps بزر تثبيت على بطاقة «الذكاء الاصطناعي» المميزة بشارة Featured ووصف مساعد AI Copilot، ثم يظهر زر فتح ينقل إلى /dashboard/ai-usage. والبطاقة بشارة مجاني لأن نوع الفوترة free في الكتالوج.
لوحة الاستهلاك تبدأ بترويسة «أداء النظام» مع وصف المراقبة اللحظية للرموز، وزر «آخر ثلاثين يوماً» للتبديل بين الشهر وثلاثين يوماً، وزر «إضافة مفتاح API» الذي ينقل إلى /dashboard/ai-usage/api-keys، وزر «تصدير التقرير» الذي ينزّل ملف ai-copilot-usage-30d.csv. وتليها أربع بطاقات مؤشرات: إجمالي الرموز، وإجمالي التكلفة (تظهر شرطة مع ملاحظة أن تكامل الأسعار معلّق)، ومتوسط الرموز لكل طلب، والنماذج النشطة.
جدول السجلات يعرض الطلب والنتيجة والرموز والنموذج والوقت والتاريخ مع مرشحات كل السجلات والاستخدام المرتفع والأخطاء وترقيم خمسة عناصر لكل صفحة، يليه جدول «تدقيق أدوات Copilot» بالأداة والمدة والنتيجة والتأكيد (نعم أو لا)، ثم مخطط توزيع استخدام الرموز ولوحة «رؤى المؤسسات» بدرجة الكفاءة. وتُجلب البيانات بخمسة طلبات متوازية: الملخص والطلبات والرؤى والتوزيع وتدقيق الأدوات عبر GET /api/ai-copilot/usage/*.
صفحة المفاتيح تحمل عنوان «مفاتيح مزودي AI Copilot» مع قائمة مزودين (OpenAI وغيرها) وحقل لصق المفتاح وزر حفظ وحالة محفوظ أو غير مُعد مع معاينة مقنّعة وزر اختبار الاتصال لكل صف. والحفظ يطلب أولاً تحدياً عبر GET /api/ai-copilot/settings/challenge ثم يرسل POST /api/ai-copilot/settings بالمزود والمفتاح والتحدي، فيُشفَّر المفتاح بمغلف AES-256-GCM لكل متجر ولا يظهر كاملاً أبداً.
تُخزَّن البيانات في نماذج AICopilotPromptLog للطلبات والتصدير والرؤى وAICopilotUsageRollup للملخص وAICopilotTenantKey للمفاتيح المشفرة مع سجلات تدقيق المفاتيح ورموز التأكيد وجلسات الخادم ومسودات المحرر الحي.
خطوات الإعداد في ڤاريونس
ثبّت التطبيق من السوق
افتح /dashboard/apps واضغط تثبيت على بطاقة الذكاء الاصطناعي، ثم اضغط فتح للانتقال إلى /dashboard/ai-usage.
راقب الاستهلاك
راجع بطاقات المؤشرات وجدول السجلات مع المرشحات والترقيم، وبدّل نطاق العرض بين الشهر وثلاثين يوماً.
صدّر التقرير
اضغط تصدير التقرير لتنزيل ملف CSV بطلبات الفترة المحددة لمراجعة خارجية أو أرشفة.
أضف مفتاح مزود
من زر إضافة مفتاح API انتقل إلى صفحة المفاتيح واختر المزود والصق المفتاح ثم احفظ.
اختبر الاتصال
بعد الحفظ اضغط اختبار الاتصال لكل مزود للتأكد من صلاحية المفتاح قبل الاعتماد عليه.
أسئلة شائعة
هل تطبيق الذكاء الاصطناعي مجاني؟
نعم، بطاقة التطبيق بشارة مجاني في السوق، والتثبيت لا يتطلب شراء. أما مفاتيح المزودين الخارجيين فتخضع لأسعار مزوديها.
لماذا تظهر التكلفة شرطة؟
لأن تكامل الأسعار معلّق حالياً؛ البطاقة تعرض شرطة مع ملاحظة بذلك بينما تبقى أرقام الرموز دقيقة.
كيف أصدّر سجل الاستخدام؟
من زر تصدير التقرير في اللوحة يُنزَّل ملف ai-copilot-usage-30d.csv بطلبات الفترة والمرشح المحدد.
هل يظهر مفتاحي كاملاً بعد الحفظ؟
لا، يظهر معاينة مقنّعة فقط مع حالة محفوظ؛ المفتاح الكامل مشفّر بمغلف لكل متجر ولا يُعرض أبداً.
ما جدول تدقيق الأدوات؟
سجل بآخر عشرين تنفيذاً لأدوات Copilot يعرض الأداة والمدة والنتيجة وحالة التأكيد (نعم أو لا) لمراجعة ما نفّذه المساعد.
استكشاف الأخطاء
1) اللوحة فارغة: تأكد من تثبيت التطبيق وحدّث الصفحة؛ البيانات تُجلب بخمسة طلبات متوازية. 2) فشل الحفظ في المفاتيح: أعد المحاولة؛ الحفظ يتطلب تحدياً جديداً من GET /api/ai-copilot/settings/challenge. 3) اختبار الاتصال يفشل: راجع نسخ المفتاح كاملاً من لوحة المزود وتأكد من عدم وجود مسافات. 4) ملف CSV لا يُنزَّل: جرّب مرشحاً أضيق أو نطاقاً أقصر ثم أعد التصدير.
حدود مهمة
• إجمالي التكلفة تقديري ومعلّق على تكامل الأسعار. • سجل الطلبات خمسة عناصر لكل صفحة مع ترقيم. • تدقيق الأدوات يقتصر على آخر عشرين تنفيذاً. • المفاتيح لكل متجر ولا تُشارك بين المتاجر.