العودة إلى لوحة التحكم

التوثيق

تعلّم كيفية استخدام Asyntai

سياق المستخدم

مرر معلومات المستخدم لتخصيص محادثات الذكاء الاصطناعي

إعداد سياق المستخدم
خطط Standard و Pro

نظرة عامة

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

ينشئ هذا تجربة سلسة حيث يعرف الذكاء الاصطناعي مسبقاً عن المستخدم - خطة اشتراكه وحالة طلبه ونقاط الولاء أو أي بيانات أخرى ذات صلة تختار مشاركتها.

كيف يعمل

  1. فعّل سياق المستخدم في إعدادات لوحة التحكم
  2. أضف JavaScript إلى موقعك لتعيين بيانات المستخدم
  3. يتلقى الذكاء الاصطناعي السياق مع كل رسالة يرسلها المستخدم
  4. يخصص الذكاء الاصطناعي الردود باستخدام المعلومات المقدمة
المساعد الذكي
أين طلبي؟
مرحباً Sarah! لقد تحققت للتو من طلبك #8847 — إنه في طريقه للتوصيل مع FedEx ومن المتوقع وصوله اليوم بحلول الساعة 5 مساءً.
هل يمكنني ترقية خطتي؟
بالطبع! أنت حالياً على خطة Basic مع 847 استدعاء API متبقي. يمكنني مساعدتك في الترقية إلى Pro للحصول على ميزات إضافية وحدود أعلى.

التنفيذ

اختر الطريقة التي تناسب إعداداتك:

أخرج بيانات المستخدم مباشرة من قالب جانب الخادم:

<!-- After your Asyntai widget script -->
<script>
window.Asyntai = window.Asyntai || {};
window.Asyntai.userContext = {
    "Customer name": "<?php echo $user->name; ?>",
    "Email": "<?php echo $user->email; ?>",
    "Subscription plan": "<?php echo $user->plan; ?>",
    "Order status": "<?php echo $user->latest_order_status; ?>"
};
</script>

عيّن السياق بعد تحميل تطبيقك لبيانات المستخدم:

// After user logs in or data loads
window.Asyntai = window.Asyntai || {};
window.Asyntai.userContext = {
    "Customer name": currentUser.name,
    "Email": currentUser.email,
    "Subscription plan": currentUser.subscription.planName,
    "Cart total": cart.total,
    "Loyalty points": currentUser.loyaltyPoints
};

// You can update it anytime - changes apply to the next message
window.Asyntai.userContext["Cart total"] = newTotal;

اجلب بيانات المستخدم فقط عند فتح المحادثة (الأفضل للأداء):

// Define a function to fetch user context
window.Asyntai = window.Asyntai || {};
window.Asyntai.fetchUserContext = function() {
    return fetch('/api/your-user-context-endpoint/')
        .then(function(response) { return response.json(); })
        .then(function(data) {
            window.Asyntai.userContext = data;
        });
};

// The widget automatically calls this when the chat opens

الأفضل للأداء: تكتشف الأداة fetchUserContext وتستدعيها تلقائياً عند فتح المحادثة، لذا تُحمّل البيانات فقط عند الحاجة.

أنت تقرر ما تشاركه. مرر فقط البيانات ذات الصلة بحالتك - اسم العميل وحالة الطلب ومستوى الاشتراك ومحتويات السلة أو أي معلومات أخرى تساعد الذكاء الاصطناعي في مساعدة مستخدميك بشكل أفضل. استخدم تسميات وصفية حتى يفهم الذكاء الاصطناعي السياق.

أمثلة على حالات الاستخدام

التجارة الإلكترونية

"أستطيع رؤية أن طلبك #4521 في طريقه حالياً ومن المتوقع وصوله بحلول يوم الجمعة."

SaaS

"لديك 847 استدعاء API متبقي هذا الشهر في خطة Pro."

الدعم

"أرى أنك عضو Gold ولديك 3 تذاكر مفتوحة. كيف يمكنني المساعدة؟"

التعليم

"لقد أكملت 78% من دورة JavaScript. هل أنت مستعد لبدء الوحدة 8؟"

الضيافة

"تم تأكيد حجزك ليوم 17 سبتمبر. يبدأ تسجيل الوصول الساعة 3 مساءً."

الرعاية الصحية

"موعدك القادم مع Dr. Smith مجدول ليوم الثلاثاء الساعة 10 صباحاً."

ملاحظات مهمة

اختياري - تعمل المحادثة بشكل مثالي بدون سياق المستخدم. إنها تحسين للمستخدمين المسجلين.
الوقت الفعلي - يُرسل السياق مع كل رسالة، لذا يمكنك تحديثه ديناميكياً عند تغيّر بيانات المستخدم.
الأمان - لا تُضمّن أبداً كلمات المرور أو أرقام بطاقات الائتمان أو أي بيانات حساسة. مرر فقط المعلومات غير الحساسة.
حدود الحجم - سياق المستخدم محدود بـ 2,000 حرف في خطة Standard و10,000 حرف في خطة Pro. إذا تم تجاوز الحد، سيتم اقتطاعه. اجعل سياقك موجزاً.

حالة التكامل

بعد التنفيذ، قم بزيارة صفحة إعدادات سياق المستخدم للتحقق من عمل التكامل. ستعرض بطاقة الحالة:

  • ما إذا كان السياق يتم استلامه
  • آخر رسالة مع سياق
  • معاينة بيانات السياق المُرسلة