يتوقّف في منتصف المهمة ويقول إنني بلغت حدًّا

ما الذي يحدث فعلًا

التعليمة الواحدة للوكيل ليست طلبًا واحدًا، بل حلقة، والحلقة هي التي تصطدم بالحدّ، غالبًا والمهمة نصفها منجز والسياق الذي جعلها متماسكة على وشك الضياع.

لماذا

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

خطوة خطوة

1. حدّد أي خطأ هو: حدّ معدل، أم نفاد حصة، أم طول سياق. ثلاث مشكلات مختلفة تُقرأ كلها على أنها «توقّف».
2. اجعل الوكيل يكتب خطته وتقدّمه في ملف داخل المستودع لا داخل المحادثة.
3. اعمل وحدة واحدة في كل تشغيل واحفظ بين الوحدات، فيكلّف الانقطاع وحدة واحدة.
4. خزّن البادئة الثابتة مؤقّتًا — أمر النظام وأي مرجع طويل لا يتغيّر — ليقلّ ثمن كل نداء في الحلقة.
5. ضع حدًّا صارمًا لتكرارات أي حلقة قادرة على إعادة المحاولة، وسقف إنفاق يوقف التشغيل لا سقفًا يراسلك بعده.

إن كنت ترى خطأ من الواجهة البرمجية

• OpenAI rate limit errors (429): causes, backoff, and real fixes
• Anthropic rate_limit_error (429): limits, acceleration, and the fix
• OpenAI insufficient_quota: what it means and how to fix it
• Gemini RESOURCE_EXHAUSTED (429): free-tier limits, quotas, and the fix