معظم الحوادث تدور حول بيانات الاعتماد والنطاق والمحتوى القديم. تعرض هذه الصفحة ترتيب فرز سريع؛ أرفق السجلات والطوابع الزمنية عند فتح تذاكر.
أعد الإنتاج في دردشة الاختبار في لوحة التحكم لمعرفة ما إذا كانت المشكلة خاصة بقناة أو تشمل الوكيل بالكامل.
الدعم
استكشاف الأخطاء
أعطال شائعة — مفاتيح، موصلات، CSP للودجت، استرجاع فارغ — وكيف تعزل السبب قبل التواصل مع الدعم.
استكشاف أخطاءأخطاءتصحيح
أخطاء مفاتيح API والنموذج
401/403 تشير عادةً لمفتاح خاطئ أو مؤسسة خاطئة أو بيانات BYOK منتهية. تأكد أن البيئة (prod مقابل staging) تطابق المفتاح المُعدّ.
بعد التدوير، أعد تشغيل أو حدّث الخدمات التابعة التي تخزّن الرؤوس مؤقتًا.
إجابات ضعيفة أو فارغة
تأكد أن الوكيل يستخدم قاعدة المعرفة المتوقعة. أعد مهام sync أو زحف إذا تغيّر المحتوى مؤخرًا.
تحقق إن كانت التعليمات مقيّدة جدًا — قد يرفض النموذج حتى لو كان الاسترجاع صحيحًا.
الودجت لا يُحمَّل
تحقق من CSP ومانعات الإعلانات وموضع script. ابحث عن أخطاء console تذكر مضيفات connect-src محظورة.
تأكد أن مفتاح embed يطابق الوكيل وقوائم النطاقات المسموحة إن فُعّلت.
أخطاء حصة عند الاستيراد أو الزحف (402 / «بلغ الحد»)
إذا فشلت استيرادات المعرفة بخطأ حصة أو دفع بعد كثير من الصور أو ملفات الوسائط، ربما استنفدت حدود التعرف على الصور Gemini المستضافة أو نسخ الوسائط شهريًا.
التخفيف: أضف مفتاح Google Gemini API في الإعدادات → مفاتيح LLM API لاستخدام مشروع Google، اطلب من admin رفع حدود الخطة، أو استورد مؤقتًا صيغًا بنص أصلي وعطّل معالجة الوسائط في الزحف.
- الزحوفات التي تفعّل الصور أو الوسائط تتطلب إعداد Gemini قابلًا للحل (مستضاف أو المؤسسة)؛ وإلا ترفض API بدء الزحف برسالة نقص Gemini.
- نص OCR وحده من الصور قد يظهر عند تجاهل vision؛ لا تفترض فشل الملف بالكامل — راجع جسم المستند المخزّن.
تابع الاستكشاف
ميزات المنصة · HTTP API والـ webhooks · البدء السريع · اتصل بنا
ابنِ على بنيتك التقنية
هل أنت مستعد لإطلاق مساعدين مرتكزين؟
ابدأ تجربة أو تحدث معنا عن النشر والحوكمة ومتطلبات المؤسسات.