التكامل مع Wagtail
مساعد ذكاء اصطناعي يجيب عن الأسئلة في موقع Wagtail الخاص بك
نظرة عامة
تضع حزمة Wagtail مساعد ذكاء اصطناعي في موقعك. يجلس زر الدردشة في زاوية كل صفحة، ويطرح الزوار سؤالهم بكلماتهم، وتأتي الإجابة من محتواك أنت: موقعك، والمستندات التي رفعتها، ومقالات المساعدة لديك.
تنويه بشأن الذكاء الاصطناعي: الإجابات في موقعك ينتجها ذكاء اصطناعي. قد تكون أحيانًا غير دقيقة أو ناقصة. تحقق منها قبل أن تعتمد عليها، خاصة في القرارات المهمة.
كيف يعمل
تضيف الحزمة وسيطًا برمجيًا يضع نصًا برمجيًا صغيرًا قبل وسم إغلاق body مباشرة في كل صفحة. ينتظر هذا النص انتهاء تحميل الصفحة، ثم يجلب أداة الدردشة من Asyntai، فيُرسم موقعك أولًا وتبقى سرعة الصفحة كما هي. لا يتحدث خادمك مع Asyntai أبدًا؛ متصفح الزائر وحده يفعل ذلك.
لا تغيّر أي شيء في قوالبك. يترك الوسيط البرمجي لوحة إدارة Wagtail وشأنها، ويترك كل ما ليس صفحة HTML وشأنه.
المتطلبات
- حساب Asyntai. الخطة المجانية تكفي للبداية.
- موقع Wagtail بالإصدار 5.2 أو أحدث، على Django 4.2 أو أحدث و Python 3.9 أو أحدث.
- الوصول إلى شفرة ذلك الموقع، لأنك تثبّت حزمة Python.
التثبيت
اتبع هذه الخطوات لإضافة Asyntai إلى موقع Wagtail الخاص بك:
ثبّت الحزمة
ثبّتها من Python Package Index، في البيئة نفسها التي يعمل فيها موقعك:
pip install wagtail-ai-chatbot
أضفها إلى إعداداتك
أضف التطبيق ووحدة إعدادات Wagtail إلى INSTALLED_APPS، والوسيط البرمجي في أعلى MIDDLEWARE:
INSTALLED_APPS = ["wagtail_asyntai", "wagtail.contrib.settings", ...]
MIDDLEWARE = ["wagtail_asyntai.middleware.AsyntaiWidgetMiddleware", ...]
شغّل الترحيل
هذا ينشئ الجدول الذي يحفظ إعداداتك:
python manage.py migrate wagtail_asyntai
الصق معرّف الأداة
في لوحة إدارة Wagtail افتح Settings ثم Asyntai chat assistant. ألصق معرّف الأداة واختر Save. تجد المعرّف في لوحة تحكم Asyntai ضمن قسم Setup & Integration. يمكنك لصق المقتطف كاملًا؛ تحتفظ الحزمة بالمعرّف فقط.
نصيحة: أضف مستنداتك وأسئلتك وأجوبتك وتعليماتك في لوحة Asyntai قبل النشر، ليجيب المساعد إجابة صحيحة منذ أول زائر.
الإعدادات
- معرّف الأداة: الدردشة تعمل ما دام هذا الحقل يحمل معرّفًا صحيحًا، وتتوقف عندما يكون فارغًا.
- إظهار الدردشة للزوار غير المسجّلين فقط: المستخدمون الذين سجّلوا الدخول لا يرون الدردشة أبدًا. مفيد عندما يكون المساعد موجودًا لمن لم يسجّلوا بعد.
- عنوان نص الأداة البرمجي: اترك هذه القيمة كما هي، إلا إذا طلب منك دعم Asyntai تغييرها.
الإعدادات لكل موقع على حدة، فالمشروع الذي يقدّم عدة مواقع من تثبيت Wagtail واحد يمكنه أن يعطي كل موقع مساعده الخاص.
الإعدادات في ملف الإعدادات لديك
المشروع الذي يحفظ إعداداته في متغيرات البيئة يمكنه تخطي لوحة الإدارة ووضع القيم في الشفرة. إذا كان الاثنان معبّأين، تفوز لوحة الإدارة.
ASYNTAI_WIDGET_ID = "asyntai_ab12cd34"
ثلاث قيم أخرى اختيارية: ASYNTAI_SHOW_TO_ANONYMOUS_ONLY و ASYNTAI_SCRIPT_URL و ASYNTAI_SKIP_PREFIXES. الأخيرة تسمّي المسارات التي لا تلمسها الأداة أبدًا، وتحتاجها عندما لا تكون لوحة إدارتك على /admin/.
وضع الأداة يدويًا
إذا فضّلت اختيار المكان بنفسك، اترك الوسيط البرمجي وضع الوسم في قالبك الأساسي. الوسم والوسيط البرمجي لا يعملان معًا أبدًا، لذا يمكنك الاحتفاظ بالاثنين.
{% load asyntai %} ... {% asyntai_widget %}
ما الذي يستطيع المساعد فعله
- الإجابة عن أسئلة الزوار فورًا، على مدار الساعة، في كل صفحة
- الرد بأكثر من 80 لغة، تُكتشف تلقائيًا من نص السؤال
- البقاء مفتوحًا بينما ينتقل الزائر من صفحة إلى أخرى
- استخدام مستنداتك المرفوعة والأسئلة الشائعة وتعليماتك لتقديم إجابات دقيقة
الخصوصية
تنشر الحزمة قيمتين اثنتين فقط في الصفحة: معرّف الأداة وعنوان النص البرمجي. لا يُرسل أي شيء عن صفحاتك أو مستخدميك إلى Asyntai. متصفح الزائر وحده يتحدث مع Asyntai، وذلك فقط عندما يفتح الزائر الدردشة.
الخطط والأسعار
التكامل مع Wagtail متاح في كل خطط Asyntai، بما فيها الخطة المجانية. تتضمن كل خطة عددًا شهريًا من الرسائل مشتركًا بين كل قنواتك وتكاملاتك. عرض الأسعار.
إزالة التثبيت
أفرغ حقل معرّف الأداة لإيقاف الدردشة. ولإزالة الحزمة، أخرج الوسيط البرمجي والتطبيق من إعداداتك وأزلها بأمر pip.
الشفرة المصدرية
الحزمة حرة ومفتوحة المصدر، برخصة MIT. يمكنك قراءة كل سطر على GitHub.
تحتاج مساعدة؟
إذا كان لديك أي أسئلة أو واجهت مشاكل، تواصل معنا على [email protected].