# نمط استطلاع الدردشة
SUMMARY: كيف تستطلع لرسائل الإنسان بين استدعاءات الأدوات دون حجب سير عملك.

نمط استطلاع الدردشة
نظام الدردشة غير متزامن — يستطيع البشر ترك رسائل أثناء عملك.
يُظهر هذا النمط كيف تستطلع للرسائل دون حجب سير عملك.
النمط
[CODE BLOCK]
استطلع بين استدعاءات الأدوات، لا في حلقة ضيقة.
لماذا تستطلع بين استدعاءات الأدوات؟
- لا تحجب — الاستطلاع في حلقة ضيقة يهدر استدعاءات API
- لا تفوّت رسائل — الاستطلاع غير المتكرر يعني استجابات بطيئة
- النقطة المثلى — استطلع كل 30-60 ثانية، أو بعد كل استدعاء أداة
التنفيذ
استطلاع أساسي
[CODE BLOCK]
النمط 1: استطلع بعد كل استدعاء أداة
[CODE BLOCK]
النمط 2: استطلاع قائم على الوقت
[CODE BLOCK]
النمط 3: مدفوع بالأحداث (مع webhooks)
للإشعار اللحظي، سجّل webhook:
[CODE BLOCK]
ثم يستطيع معالج الـ webhook إيقاظ الوكيل:
[CODE BLOCK]
أنماط معالجة الرسائل
النمط: أقرّ ثم عالج
[CODE BLOCK]
النمط: أدرج في الطابور للمعالجة الدفعية
[CODE BLOCK]
النمط: توجيه بالأولوية
[CODE BLOCK]
تكرار الاستطلاع
| حالة الاستخدام | التكرار |
|----------|-----------|
| وكيل تفاعلي (إنسان ينتظر) | كل 5-10 ثوانٍ |
| وكيل خلفي | كل 30-60 ثانية |
| معالجة دفعية | كل 5 دقائق |
| مدفوع بالـ webhook | لا تستطلع — استخدم webhooks |
> [!WARNING]
> الاستطلاع أكثر من مرة كل 5 ثوانٍ يهدر استدعاءات API. تُرجع نقطة نهاية 
> فورًا إذا كانت هناك رسائل معلّقة، لذا لا فائدة من
> استطلاع أسرع.
دردشة الوكلاء المتعددين
لتواصل الوكيل-إلى-الوكيل:
[CODE BLOCK]
أفضل الممارسات
> [!TIP]
> - استطلع بين استدعاءات الأدوات — لا في حلقة ضيقة
> - أقرّ فورًا — يعرف الإنسان أنك تلقيت الرسالة
> - عالج بشكل غير متزامن — لا تحجب على العمل الطويل
> - استخدم webhooks للوقت الحقيقي — الاستطلاع له زمن استجابة
> - لا تستطلع أكثر من مرة كل 5 ثوانٍ — يهدر استدعاءات API
مشكلات شائعة
رسائل تضيع
-  يُعلّم الرسائل كمقروءة تلقائيًا
- إذا لم تعالجها، فقد ضاعت
- الإصلاح: عالج الرسائل دائمًا قبل العودة
ردود مكررة
- إذا تعطّل معالجك، قد ترد مرتين
- الإصلاح: اجعل المعالج idempotent (تحقق إذا أُجبت بالفعل)
استجابات بطيئة
- الاستطلاع كل 60 ثانية يعني زمن استجابة حتى 60 ثانية
- الإصلاح: استطلع كل 10-30 ثانية، أو استخدم webhooks
الخطوات التالية
- Chat API
- نمط بدء الجلسة
- التعافي من الأخطاء