استكشاف الأخطاء وإصلاحها

ابدأ بحالة قابلة لإعادة الإنتاج#

قبل تغيير أي إعدادات، سجّل ما يلي:

• مساحة العمل/الموقع، والمسار العام أو نقطة نهاية API، والوقت الدقيق مع المنطقة الزمنية.
• النتيجة المتوقعة والنتيجة الفعلية.
• المتصفح/الجهاز أو قناة المزوّد الخارجي.
• ما إذا كان العطل يؤثر في معاينة المالك، أو صفحة العرض التجريبي المستضافة المتبقية، أو التضمين، أو الموصّل، و/أو API.
• نص الحالة/الخطأ الآمن، أو قيمة x-request-id في الاستجابة، أو آخر خطأ للموصّل، أو معرّف حدث التسليم لدى المزوّد.
• آخر وقت كان يعمل فيه كل شيء بشكل سليم، وأصغر تغيير أُجري مؤخرًا.

لا تُدرج بيانات اعتماد API أو المزوّد أو الموصّل بنص صريح، ولا أسرار webhook، ولا بيانات العملاء الخاصة، ولا ترويسات التفويض كاملة، ولا محتوى المحادثات غير الضروري.

تغييرات الموقع لا تظهر#

1. تأكد من أن عنوان URL في لوحة التحكم يخص الموقع ومساحة العمل المقصودين.
2. تأكد من أن إجراء الحفظ أبلغ عن نجاحه.
3. تُطبَّق التعليمات والمعرفة المفهرسة على المحادثات الجديدة دون إعادة نشر. إذا كانت أداة الدردشة نفسها مخفية، فأعد تفعيلها من قائمة اجعله متاحًا في صفحة الـ agent ← أداة الموقع (أو من بطاقة على موقعك في تبويب نظرة عامة).
4. بالنسبة لإعدادات العرض (وشارة العلامة التجارية)، تُحفظ التغييرات تلقائيًا وتحدّث التضمين المباشر فورًا — لذا تجاوز إعادة النشر وافتح نافذة خاصة.
5. افتح تضمينًا فعليًا (أو slug مستضافًا متبقيًا إن كان لديك واحد) في نافذة خاصة.
6. إذا كانت المعاينة الاجتماعية فقط هي القديمة، فاستخدم أداة ذاكرة التخزين المؤقت/التصحيح الخاصة بتلك المنصة.

إلغاء النشر والتحرير أمران مختلفان. فقد يستمر موصّل المراسلة المتصل في الرد حتى لو كان التضمين متوقفًا.

إجابة الـ agent ضعيفة أو خاطئة#

اطرح السؤال نفسه في أداة الاختبار الخاصة بالمالك وفي محادثة عامة جديدة. تأكد من أن مصدر المعرفة ذا الصلة قد فُهرس، ويحتوي على إجابة صريحة، وهو محدّث، ولا يتعارض مع مصدر آخر. راجع قواعد اللغة/الشخصية بحثًا عن قيد يمنع الإجابة.

عندما لا يحتوي المصدر على إجابة، حسّن سلوك الإجابة البديلة/التصعيد بدلًا من توجيه الـ agent إلى التخمين. استخدم مصادر المعرفة لإنشاء مجموعة قبول تشمل الأسئلة المباشرة وإعادة الصياغة والحدود.

أداة التشغيل الخاصة بالتضمين مفقودة أو محظورة#

تأكد من أن الموقع منشور، وأن التضمين مفعّل، وأن السكربت يحمل slug الموقع بدقة، وأن أصل الصفحة الأم النهائي في المتصفح — بما في ذلك المخطط واسم المضيف والمنفذ — مدرج في قائمة السماح. في DevTools، افحص طلب embed.js، وأخطاء CSP، وحالة مدير الموافقة، وطلب iframe، ووجود جذر data-maf-embed واحد.

إذا كان النص يعمل لكن الميكروفون لا يعمل، فتحقق من HTTPS، وإذن المتصفح، وإذن allow الخاص بـ iframe، وسياسة Permissions Policy للمضيف. اتبع نظرة عامة على التضمين والأمان وCSP كاملتين.

الصوت لا يعمل#

حدّد الوضع المعطّل: رسالة صوتية، أو مكالمة مباشرة، أو صوت الموصّل. نجاح مسار النص يثبت فقط سلامة مفتاح نموذج اللغة.

افحص مفاتيح التفريغ النصي وتحويل النص إلى كلام (TTS) والمزوّد الفوري كلًّا على حدة؛ ثم افحص أهلية الخطة ورصيد الـ credits وحصة الدقائق المباشرة وإذن المتصفح واللغات المهيأة. اختبر تسجيلًا قصيرًا وواضحًا قبل التحقيق في ملف طويل أو مليء بالضوضاء.

الموصّل لا يتلقى أي رسائل#

استخدم دليل القناة وقارن بين الطرفين. تأكد من أن الموصّل مفعّل، وأن بيانات الاعتماد ما تزال صالحة، وأن عنوان webhook/التفاعل/المهارة لدى المزوّد هو العنوان الحالي، وأن الحدث/الصفحة/الرقم/الكتلة المطلوبة مشترَك بها، وأن وضع التطبيق يشمل مستخدم الاختبار، وأن التسليم عبر HTTPS العام ينجح.

نجاح التحقق من webhook لا يثبت الاشتراك في أحداث وقت التشغيل ولا أذونات الإرسال. قارن سجلات التسليم لدى المزوّد مع آخر رسالة والخطأ المحفوظ للموصّل. اختبر النص قبل الصوت.

النطاقات المخصصة غير متاحة#

نحن لا نبيع نطاقات العملاء ولا نربطها. ضع الـ agent على الموقع الذي تملكه بالفعل عبر التضمين. أحداث الإضافة الخاصة بالنطاقات المتبقية في Polar تُتجاهل أو تُلغى ولا تمنح credits أبدًا.

فشل طلب API#

سجّل الأسلوب (method)، والمسار ذا الإصدار، والحالة، ورمز الخطأ الثابت، وقيمة x-request-id في الاستجابة، وترويسات حدّ المعدل ذات الصلة. ثم صنّف الحالة:

استخدم بيانات الاعتماد والرموز والنطاقات والأخطاء وحدود المعدل. لا تحلّ خطأ API أبدًا بنقل بيانات اعتماد الخادم إلى كود المتصفح.

الفوترة أو الاستخدام يبدو غير صحيح#

ميّز بين الوصول إلى المنصة، والـ credits الشهرية، والـ credits المشتراة، وعدد المواقع، والدقائق المباشرة، ومعدل API، وقنوات المراسلة (Operate+)، وBYOK/الفريق (Scale). الشحن الإضافي يغيّر الـ credits فقط. أما رسوم مزوّد BYOK فمنفصلة عن فوترة Make Agent Fast.

في حال الاستخدام غير المتوقع، احتوِ المصدر المرجّح قبل التحقيق: عطّل موصّلًا، أو ألغِ مفتاحًا، أو أزل أصل تضمين غير مقصود، أو أوقف حلقة إعادة محاولة API. احتفظ بالنطاق الزمني ومعرّفات الطلبات/المزوّد دون كشف أي أسرار.

اجمع تفاصيل دعم آمنة#

إذا بقيت المشكلة قائمة، فاستخدم عنصر التعليقات في الدليل الأكثر صلة أو تواصل مع الدعم من لوحة التحكم، مع تضمين ما يلي:

• معرّف الموقع/مساحة العمل والميزة المتأثرة.
• الطابع الزمني الدقيق/المنطقة الزمنية وخطوات إعادة الإنتاج.
• النتيجة المتوقعة مقابل الفعلية.
• عنوان URL عام غير سري عند الاقتضاء.
• حالة HTTP، ورمز الخطأ الثابت، وقيمة x-request-id، أو معرّف حدث المزوّد.
• لقطة شاشة منقّحة أو حمولة minimal بعد إزالة الأسرار والبيانات الشخصية.

اذكر ما فحصته بالفعل. فهذا يمنع تكرار نصائح الإعداد ويوضّح حدود العطل.