توثيق روبوت محادثة ذكي من محتوى موقعك لووردبريس
دليل روبوت محادثة ذكي من محتوى موقعك: وصل حساب الذكاء الاصطناعي، وقراءة موقعك، ونافذة المحادثة، وكيف تُصنع الإجابات والاعتذارات، والتحويل إلى شخص، والحماية والتكلفة، والسجل والخصوصية.
يشرح الإصدار 1.0.0حُدّث في 29 أكتوبر 2026
ابدأ من هنا
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| إجابات من محتواك فقط | تُقسَّم صفحاتك ومقالاتك ومنتجاتك المنشورة وصفحات السياسات المختارة إلى مقاطع. ومع كل سؤال تُعطى أفضل المقاطع للذكاء الاصطناعي مع قاعدة الإجابة منها فقط. |
| روابط المصادر | تذكر كل إجابة الصفحات التي جاءت منها. وتُحذف من الإجابة الروابط التي تشير إلى مواقع أخرى. |
| اعتذار واضح | حين لا يتطابق أي مقطع بما يكفي يقرأ الزائر «لم أجد هذا في الموقع» ولا يُسأل الذكاء الاصطناعي أصلًا. |
| تحدث مع شخص | بعد الاعتذار أو حين يطلب الزائر شخصًا: نموذج بريد ورابط واتساب ورابط صفحة التواصل. |
| لا يقرأ المحتوى الخاص أبدًا | لا تُقرأ المسودات والعناصر الخاصة والمحمية بكلمة مرور، ويخرج من الفهرس فورًا كل عنصر يتوقف عن كونه عامًا. |
| مقاومة إساءة الاستخدام | رمز أمان وحقل خفي ضد الرسائل الآلية وحدود لكل عنوان زائر ولكل محادثة وأطول سؤال وسقوف إنفاق يومية وشهرية. |
| تحصين ضد حقن التعليمات | يُمرَّر نص الزائر ومحتوى الموقع كبيانات بين محددات، وتُحجب الحيل الواضحة قبل الذكاء الاصطناعي، وتُستبدل الإجابة التي تكرر التعليمات. |
| محادثة تجريبية | اطرح الأسئلة في لوحة الإدارة وانظر المقاطع التي وُجدت مع نسبة تطابقها. |
| أسئلة بلا إجابة | مع السجل الاختياري: الأسئلة التي لا تجيب عنها صفحاتك، الأكثر تكرارًا أولًا. |
| نافذة سهلة الوصول | تعمل بلوحة المفاتيح ومع قارئات الشاشة ومن اليمين إلى اليسار وعلى الجوال، بلونك وموضعك. |
| العربية | الأسئلة بالعربية تُجاب بالعربية، والإضافة ودليلها بالعربية أيضًا. |
المتطلبات
| البند | التفاصيل |
|---|---|
| ووردبريس | 6.0 أو أحدث |
| PHP | 7.4 أو أحدث |
| أيضًا | ووكومرس 8.0+ اختياري: معه تُقرأ المنتجات أيضًا |
| مزوّد ذكاء اصطناعي | حساب ومفتاح واجهة لدى خدمة متوافقة مع OpenAI (OpenAI أو OpenRouter أو Azure أو خادم محلي مثل Ollama...) أو لدى أنثروبيك. تدفع لمزوّدك مقابل ما تستخدمه؛ ولا رسوم استخدام في الإضافة. |
| الرخصة | GPL-2.0-or-later |
التثبيت
- فُكّ ضغط الحزمة التي نزّلتها. بداخلها
ai-chatbot-from-site-content-for-wordpress.zip(لا تفكّ هذا الملف). - في ووردبريس افتح الإضافات ← أضف جديدًا ← رفع إضافة واختر
ai-chatbot-from-site-content-for-wordpress.zipواضغط التثبيت الآن. - اضغط تفعيل الإضافة.
- افتح روبوت المحادثة الذكي ← الإعدادات ← الاتصال بالذكاء الاصطناعي واختر المزوّد والصق مفتاح الواجهة واضغط اختبر الاتصال.
صِل الذكاء الاصطناعي
| الحقل | المعنى |
|---|---|
| المزوّد | متوافق مع OpenAI (OpenAI وOpenRouter وAzure وGroq وOllama وLM Studio...) أو أنثروبيك. |
| عنوان الواجهة | اتركه فارغًا للعنوان الرسمي. ولخدمة أخرى اكتب عنوانها، مثلًا http://localhost:11434/v1. |
| مفتاح الواجهة | يُحفظ في قاعدة بياناتك (ولا يظهر ثانية). ويمكنك تعريفه في wp-config.php فيختفي الحقل. |
| النموذج | اسم النموذج لدى مزوّدك. يكفي نموذج صغير رخيص لأغلب المهام. |
| أقصى طول للإجابة | يحدّ رموز الإجابة الواحدة فلا يكلّف الطلب أكثر مما تتوقع. |
| الحد اليومي | عدد الطلبات التي تجريها الإضافة في اليوم (0 = بلا حد). وعند بلوغه تتوقف الإضافة عن الطلب حتى الغد. |
| الخصوصية | يخفي عناوين البريد وأرقام الهاتف والأرقام الشبيهة ببطاقات الدفع قبل إرسال النص. |
| المزوّد | كيف يُعثر على المقاطع |
|---|---|
| متوافق مع OpenAI مع نموذج تضمين (مثل text-embedding-3-small) | بالمعنى: «متى تصلني الكنبة؟» تجد صفحة التوصيل حتى دون كلمة التوصيل. |
| أنثروبيك، أو اختيار «بالكلمات فقط» | بالكلمات (مع توحيد أشكال الحروف العربية). بلا تكلفة تضمين، لكن على الزائر أن يستخدم كلمات صفحاتك. |
الخطوات الأولى
- افتح روبوت المحادثة الذكي ← الإعدادات واختر ما يقرؤه الروبوت (الصفحات والمقالات والمنتجات) وصفحات السياسات التي تُدرج دائمًا.
- افتح روبوت المحادثة الذكي ← المصادر واضغط اقرأ … الآن. يعرض شريط تقدم القراءة، ويمكنك الإيقاف في أي لحظة.
- افتح المحادثة التجريبية واسأل ما قد يسأله زوارك. افحص الإجابات والمقاطع.
- تبدأ المحادثة للمسؤولين فقط: زر موقعك وجرّبها. وحين ترضى اضبط أظهر المحادثة على لكل زائر.
ما يقرؤه الروبوت
| القاعدة | التفصيل |
|---|---|
| لا يُقرأ أبدًا | المسودات والمعلّقة والمجدولة والخاصة والمحمية بكلمة مرور، وصفحات السلة والدفع والحساب، والمنتجات المخفية من البحث. |
| يخرج من الفهرس فورًا | العنصر الذي يُلغى نشره أو يُنقل إلى المهملات أو يصير خاصًا أو تُضاف له كلمة مرور. |
| يُقرأ ثانية | في الخلفية حين يُحفظ العنصر (خيار). ولا يُرسل النص غير المتغير ثانية. |
| تستبعده أنت | حدّد لا تستخدم هذا في روبوت المحادثة في صندوق شاشة التحرير، أو اضغط استبعد في قائمة المصادر. |
| لا يُقرأ | التعليقات والمرفقات وملفات PDF ومخرجات الرموز القصيرة والكتل الديناميكية والحقول المخصصة (يمكن لمرشح برمجي إضافتها). |
نافذة المحادثة
/blog/* لقسم كامل) لإظهارها هناك فقط أو في كل مكان عداها.| إمكانية الوصول | كيف |
|---|---|
| لوحة المفاتيح | Tab إلى الزر، وEnter للفتح، وEnter للإرسال، وShift+Enter لسطر جديد، وEscape للإغلاق؛ ويعود التركيز إلى الزر. |
| قارئات الشاشة | اللوحة حوار له عنوان، وتُعلن الرسائل الجديدة عبر منطقة حية. |
| من اليمين إلى اليسار | تنعكس النافذة في العربية، وتظهر الإجابات بالاتجاه الصحيح. |
| الحركة | تتوقف الحركات حين يطلب الزائر من نظامه تقليل الحركة. |
كيف تُصنع الإجابات
| الخيار | المعنى |
|---|---|
| المقاطع المرسلة مع السؤال | من 1 إلى 8. مقاطع أكثر، قراءة أكثر، تكلفة أعلى. |
| أدنى تطابق | ارفعه إن أجاب الروبوت عن أسئلة خارج الموضوع، واخفضه إن رفض أسئلة جيدة (تعرض المحادثة التجريبية أقرب المقاطع). وقد ضُبطت القيمة الافتراضية 30% بنموذج الاختبار الخاص بالإضافة ولم تُقس بنموذج تضمين حقيقي: جرّبها في المحادثة التجريبية بأسئلتك قبل فتح المحادثة للجميع. |
| أسئلة المتابعة | تُحفظ الأسئلة السابقة في المحادثة نفسها على الخادم لمدة 30 دقيقة (ولا تؤخذ من المتصفح أبدًا). |
| أعد استخدام الإجابات | السؤال الأول نفسه يحصل على الإجابة نفسها دون طلب جديد حتى يتغير المحتوى. |
| لغة الإجابات | فارغ = لغة كل سؤال. |
تحدث مع شخص
الحماية والتكلفة
| الحماية | التفصيل |
|---|---|
| رمز الأمان | يحمل كل سؤال رمز nonce من ووردبريس، وتحصل الصفحة المقدَّمة من ذاكرة مؤقتة على رمز جديد تلقائيًا. وللزوار غير المسجلين يكون هذا الرمز واحدًا للجميع لنحو 12 ساعة: فهو يمنع المواقع الأخرى من إرسال أسئلة عبر متصفح زوارك، ولا يمنع الروبوتات. ما يوقف الروبوتات هو حدود المعدل وسقوف الإنفاق. |
| حقل الرسائل الآلية | حقل خفي لا يراه الناس، ويُرفض الروبوت الذي يملؤه. |
| حدود المعدل | الأسئلة في الدقيقة وفي اليوم من عنوان زائر واحد (يُحفظ كبصمة مملّحة، لا كنص واضح)، وفي الساعة في محادثة واحدة. |
| أطول سؤال | تُرفض الأسئلة الأطول، وللإجابة سقف من الرموز. |
| سقوف الإنفاق | يومية وشهرية، تُقدَّر من الأسعار التي تكتبها. وقبل كل سؤال تُحجز أسوأ تكلفة له (وتُحسب الأسئلة التي تصل في اللحظة نفسها واحدًا بعد الآخر) ثم تُصحَّح بالتكلفة الحقيقية بعد الإجابة، وحين يُتجاوز سقف تعرض المحادثة رسالة لطيفة بأنها غير متاحة. |
| حيل التعليمات | لا تُرسل إلى الذكاء الاصطناعي أسئلة مثل «تجاهل تعليماتك» (خيار). ويُمرَّر نص الزائر ومحتوى الموقع كبيانات بين محددات مع تحييد الأقواس الزاوية. |
| التسريب | توضع علامة خفية في التعليمات، والإجابة التي تحتويها أو تنسخ القواعد تُستبدل بالاعتذار. |
| الروابط | روابط موقعك فقط قابلة للنقر، ولا تُدرج النافذة HTML أبدًا. |
| الوسيط | يُقرأ عنوان الزائر من X-Forwarded-For فقط إن قلت إن موقعك خلف وسيط (وإلا يمكن تزييفه). ويُستخدم آخر عنوان في الترويسة، وهو الذي يضيفه الوسيط (أما الأولى فيكتبها الزائر). ولإعداد آخر يعطي مرشح للمطورين (tqcb_visitor_ip) العنوان. |
| أين تظهر المحادثة | هذه القواعد تخفي النافذة ولا تحمي شيئًا؛ فحين تكون المحادثة مفتوحة للجميع يمكن إرسال أسئلتها من أي صفحة. |
السجل والأسئلة بلا إجابة
الخصوصية
من يفعل ماذا
| من | يستطيع |
|---|---|
| المسؤولون | الإعدادات والاتصال بالذكاء الاصطناعي وقراءة الموقع واستبعاد العناصر والمحادثة التجريبية والسجل (التصدير والحذف). |
| المحررون والكتّاب | تحديد «لا تستخدم هذا في روبوت المحادثة» في العناصر التي يستطيعون تحريرها. |
| الزوار | طرح الأسئلة وإرسال نموذج التواصل ضمن الحدود. |
العربية ومن اليمين إلى اليسار
ما لا تفعله
| الحد | التفصيل |
|---|---|
| قد يخطئ | قد يسيء الذكاء الاصطناعي فهم مقطع. تحمل الإجابات مصادرها وإشعارًا؛ افحص المحادثة التجريبية قبل فتح المحادثة للجميع. |
| المكتوب فقط | لا حالة طلبات، ولا مخزون لحظي بين قراءتين، ولا بيانات حسابات، ولا إجراءات (لا يضيف إلى السلة ولا يحجز شيئًا). |
| لا محادثة حية | التواصل عبر البريد أو واتساب أو صفحة التواصل؛ لا موظف حي داخل النافذة. |
| حجم الموقع | يُقارن كل سؤال بكل مقاطع الفهرس (عدد المقاطع في شاشة المصادر). وبالقياس على حاسوب سريع مع PHP 8.3 وتضمينات من 1536 رقمًا (مثل text-embedding-3-small): تستغرق 5000 مقطع نحو 1.3 ثانية لكل سؤال، و50000 مقطع نحو 12 ثانية، قبل أن يجيب الذكاء الاصطناعي، وتبقى الذاكرة صغيرة. وبالكلمات فقط: نحو 0.1 و0.8 ثانية. والاستضافة المشتركة أبطأ. فوق نحو 10000 مقطع اختر بالكلمات فقط، أو اقرأ أنواع محتوى أقل، أو اخفض المقاطع لكل عنصر. |
| محتوى الأعضاء | يتبع الروبوت حالة العنصر وكلمة مروره في ووردبريس فقط. والنص الذي تخفيه إضافة عضوية أو تقييد في عنصر منشور يُقرأ ويمكن اقتباسه: استبعد هذه العناصر (مربع شاشة التحرير، أو زر الاستبعاد، أو المرشح tqcb_indexable). |
| حدود المعدل | تستخدم المؤقتات العابرة في ووردبريس، وذاكرة كائنات دائمة تجعلها أسرع في المواقع المزدحمة. |
| ليست أداة قانونية | لا تجعل موقعك ممتثلًا لقوانين الخصوصية بمفردها. |
للمطورين
// Ask the chatbot from your own code (same rules as the widget: sources, refusal, caps)
$r = TQCB_Chat::ask( 'How long does delivery take?' );
// $r['type'] is answer, refusal, handover or unavailable; $r['text'], $r['sources'] (title, url)
// Keep some items out of the index (drafts, private items and passwords are always out)
add_filter( 'tqcb_indexable', function ( $ok, $post ) {
return $ok && ! has_category( 'internal', $post );
}, 10, 2 );
// Add a custom field to the text that is read
add_filter( 'tqcb_item_text', function ( $text, $post ) {
return $text . "\n\nOpening hours: " . get_post_meta( $post->ID, 'hours', true );
}, 10, 2 );
// Your brand voice (keep the rules of the prompt)
add_filter( 'tqcb_system_prompt', function ( $prompt ) {
return $prompt . "\nUse a warm, short style.";
} );
// Hide the widget on some pages
add_filter( 'tqcb_show_widget', function ( $show ) {
return $show && ! is_page( 'landing' );
} );
// The key can live in wp-config.php
define( 'TQCB_AI_KEY', 'sk-...' );استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| لا يظهر زر المحادثة | افحص أظهر المحادثة (للمسؤولين فقط في البداية) وقواعد الصفحات وضبط الاتصال بالذكاء الاصطناعي. |
| «لم أجد هذا في الموقع» لسؤال جيد | افتح المحادثة التجريبية: إن كان المقطع الصحيح دون أدنى تطابق بقليل فاخفضه، وإن كان غائبًا فتأكد أن الصفحة مقروءة (المصادر). |
| تبقى العناصر «منتظرة» | اضغط اقرأ … الآن. وفي الخلفية تستخدم القراءة WP-Cron الذي يعمل حين يُزار الموقع. |
| التضمين يحتاج إلى مزوّد متوافق مع OpenAI | مع أنثروبيك اختر بالكلمات فقط، أو استخدم خدمة متوافقة مع OpenAI للتضمين. |
| «المحادثة في استراحة الآن» | بلغ سقف إنفاق، أو لا يجيب الذكاء الاصطناعي. انظر بطاقات شاشة المصادر واختبار الاتصال. |
| «تطرح أسئلة كثيرة» | بلغ حد المعدل. ارفعه في الإعدادات إن بلغه زوار حقيقيون. |
| لا تصل رسالة نموذج التواصل | يجب أن يستطيع ووردبريس إرسال البريد؛ استخدم إضافة SMTP إن كانت رسائل الموقع الأخرى لا تصل أيضًا. |
التحديث والإزالة
ثبّت ملف الإصدار الجديد فوق القديم من الإضافات ← أضف جديدًا ← رفع إضافة (يعرض ووردبريس استبدال النسخة الحالية)، أو استبدل المجلد ai-chatbot-from-site-content-for-wordpress عبر FTP. تبقى إعداداتك والفهرس والسجل. ولإزالة الإضافة عطّلها ثم احذفها: تُحذف معها إعداداتها وجداولها (الفهرس والسجل) وبياناتها الوصفية ومهامها المجدولة.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الإضافة أو راسل support@taqnix.com مع إصدار ووردبريس وإصدار الإضافة ولقطة شاشة.