وكيل البرمجة الذي يعمل طوال فترة بعد الظهر يراكم سجلًا كبيرًا: ملفات قرأها، وأوامر شغّلها، ومخرجات اختبارات، وخطط، وتصحيحات. وفي كل دور يُرسَل هذا كله إلى النموذج من جديد. وطريقة إدارتك لهذا السياق المتنامي تحدد ثلاثة أشياء معًا: تكلفة كل دور، وسرعة الرد، وهل لا يزال الوكيل يتذكر ما كان يفعله.
نافذة المليون رمز تغيّر الموازنات بين هذه الأمور، لكنها لا تلغيها.
ماذا تمنح نافذة المليون رمز للوكيل طويل التشغيل؟
على BroadNet Inference، يقبل DeepSeek V4.1 Flash وGLM 5.3 ما يصل إلى 1,048,576 رمزًا لكل طلب، للأمر والإجابة معًا. ويقبل Qwen3.8 27B ما يصل إلى 262,144. مع النوافذ الأصغر، يضطر الوكيل إلى التلخيص بعد ساعة أو ساعتين من العمل. أما مع مليون رمز، فيستطيع عادةً الاحتفاظ بالسجل الخام لجلسة كاملة، ولا يضغطه إلا قرب نهاية تشغيل طويل جدًا.
هذه ميزة حقيقية: فالملخصات تفقد شيئًا من المعلومات، وكل ملخص فرصة لنسيان التفصيل الوحيد الذي كان مهمًا. لكن ثلاث تكاليف لا تزال تنمو مع طول الأمر:
- المال، على مفتاح يُحاسَب لكل رمز، لأن كل دور يعيد إرسال الأمر كاملًا.
- زمن الاستجابة، لأن الخادم يجب أن يعالج كل رمز إدخال قبل أول رمز إخراج.
- الانتباه. قد تنخفض الجودة مع نمو المدخلات، وهي ظاهرة تُسمّى تدهور السياق. وقد وجدت ورقة “Lost in the Middle” أن النماذج تميل إلى استخدام المعلومات في بداية المدخلات الطويلة ونهايتها بموثوقية أكبر من المعلومات في منتصفها. النماذج الأحدث أفضل في ذلك، لكن عادة إبقاء الحقائق المهمة قرب الطرفين لا تزال مفيدة.
القاعدة 1: لماذا يجب ألا يُضاف إلى السجل إلا في آخره؟
التخزين المؤقت للأوامر يطابق من بداية الأمر. فإذا كانت أول 300,000 رمز في هذا الدور مطابقة للدور السابق، أمكن تقديمها من الذاكرة المؤقتة؛ وأول رمز متغيّر ينهي المطابقة. تُبلغ واجهة BroadNet عن ذلك في usage.prompt_tokens_details.cached_tokens حين يُبلغ النموذج به، وتحاسب الإدخال المخزّن مؤقتًا بسعر أقل: $0.0055 لكل مليون رمز على DeepSeek V4.1 Flash، مقابل $0.175 للإدخال الجديد.
لذلك رتّب كل طلب بالترتيب نفسه، ولا تُضِف إلا في النهاية:
[ system prompt ] never changes during a session
[ tool definitions ] fixed order, never changes
[ project notes ] changes rarely, and only by appending
[ turn 1 ... turn N ] grows at the end
[ new message ]
أكثر ما يكسر البادئة عادةً: طابع زمني في أمر النظام، وتعريفات أدوات بترتيب غير ثابت، وإعادة تنسيق نتائج الأدوات القديمة. وفي الوكلاء أضِف سببًا آخر: القصّ بـ«النافذة المنزلقة» الذي يحذف أقدم دور في كل مرة، فيُزيح كل ما بعده. كل واحد من هذه يحوّل أمرًا مخزّنًا مؤقتًا إلى أمر جديد؛ ويسرد مقال بنية الأوامر للتخزين المؤقت بقية الأسباب، مع اختبار يثبت أن البادئة مخزّنة. وفي الجلسة الطويلة يكون الفرق كبيرًا: إذ يمكن أن يكون معظم الأمر إدخالًا مخزّنًا مؤقتًا بدل إدخال جديد. كيف يُحاسَب الإدخال المخزّن مؤقتًا.
القاعدة 2: كيف تقيس نسبة الاستفادة من التخزين المؤقت؟
سجّلها لكل طلب. مع OpenAI SDK تكفي ثلاثة أسطر بعد الاستدعاء:
import os
from openai import OpenAI
client = OpenAI(base_url="https://inference.broadnet.ai/v1", api_key=os.environ["BROADNET_API_KEY"])
resp = client.chat.completions.create(model="broadnet/deepseek-v4.1-flash", messages=history, max_tokens=8000)
u = resp.usage
cached = (u.prompt_tokens_details.cached_tokens if u.prompt_tokens_details else 0) or 0
print(f"turn prompt={u.prompt_tokens:,} cached={cached:,} ({cached / max(1, u.prompt_tokens):.0%})")
الوكيل السليم الذي يُلحق بالسجل فقط يُظهر حصة عالية من الإدخال المخزّن في كل دور بعد الأول. والهبوط المفاجئ إلى ما يقارب الصفر يعني أن شيئًا ما في بداية الأمر قد تغيّر. ابحث عنه وثبّته. وتحوّل حاسبة التخزين المؤقت للأوامر نسبة التخزين المؤقت إلى مبلغ لكل جلسة.
القاعدة 3: ماذا تقصّ أولًا حين يكبر السياق؟
حين تحتاج فعلًا إلى تقليص السياق، فما تحذفه مهم. في معظم سجلات الوكلاء يكون الجزء الأكبر مخرجات أدوات: سجل اختبارات من 4,000 سطر، أو ملف كامل قُرئ للعثور على دالة واحدة، أو قائمة محتويات مجلد. أما الجزء القيّم فصغير: الخطة، والقرارات وأسبابها، والأخطاء التي أُصلحت.
ترتيب الحذف، من الأول إلى الأخير:
- مخرجات الأدوات القديمة. استبدل محتوى نتائج الأدوات القديمة بسطر واحد مختصر: “ran pytest: 3 failures in test_api.py (fixed in turn 14)”.
- محتويات الملفات التي حلّ محلها غيرها. إذا قرأ الوكيل
api.pyثم عدّله ثم قرأه مرة أخرى، فالقراءة الأولى عبء بلا فائدة. - الاستكشاف الذي لم يؤدِّ إلى شيء. عمليات البحث والقراءة التي لم تنتهِ بتغيير.
- الاستدلال والخطط. احتفظ بها أطول مدة، فهي تشرح لماذا تبدو الشيفرة على ما هي عليه.
والأفضل من ذلك قصّ مخرجات الأداة لحظة إنتاجها. ضع حدًا لكل نتيجة أداة (مثلًا آخر 200 سطر من السجل مع عدد الأسطر) ودع الوكيل يطلب المزيد إن احتاج. هكذا يبقى السجل صغيرًا ولا يُضاف إليه إلا في آخره.
القاعدة 4: متى يضغط الوكيل سجله؟
الضغط (compaction)، أي تلخيص السجل الأقدم في كتلة أقصر، هو الأداة الثقيلة. فهو يعيد كتابة البادئة، لذا يدفع الدور الذي يلي الضغط سعر الإدخال الكامل لكل ما بعد أمر النظام. والضغط القليل كل بضعة أدوار يعني دفع هذا السعر مرة بعد مرة.
الأفضل:
- اختر عتبة عالية. مع نافذة بمليون رمز، يترك الضغط عند امتلاء 60–70% مثلًا مساحة لدور التلخيص ولامتداد طويل من العمل الجديد.
- احتفظ بالأدوار الأخيرة كما هي حرفيًا. لخّص الجزء القديم واترك آخر مجموعة من الأدوار سليمة. يصف توثيق الضغط في opencode ذلك: فهو يلخّص المحادثة ويحتفظ بالجزء الأحدث، نحو 15,000 رمز افتراضيًا.
- لخّص باستخدام الأمر الكامل. إرسال المحادثة كاملة إلى طلب التلخيص يتيح له إعادة استخدام التخزين المؤقت من الدور السابق.
- اضغط مرة واحدة، ثم عُد إلى الإلحاق. بعد الضغط تصبح البادئة الجديدة ثابتة، ويستأنف التخزين المؤقت عمله من هناك.
القاعدة 5: ما الذي يوضع في ملف الملاحظات؟
بعض الحقائق يجب أن تنجو من أي عدد من عمليات الضغط: الهدف، والقيود، والقرارات المتخذة، والأوامر التي تبني المشروع وتختبره. احفظها في ملف ملاحظات قصير (NOTES.md أو ملف مهمة) يضيف إليه الوكيل ويعيد قراءته. يقع هذا الملف قرب بداية الأمر، ونادرًا ما يتغيّر، وهو أول ما تقرؤه جلسة جديدة إذا أُعيد تشغيل العمل.
وهو أيضًا أرخص أشكال الذاكرة: بضعة آلاف من الرموز توفّر على الوكيل إعادة اكتشاف الحقائق نفسها بعد كل تلخيص.
كيف تؤثر رموز الاستدلال المنطقي في الميزانية؟
يستدل DeepSeek V4.1 Flash وGLM 5.3 وQwen3.8 27B منطقيًا قبل أن تجيب، ويُحتسب هذا الاستدلال ضمن max_tokens. الجلسة الطويلة لا تغيّر ذلك، لكن الأوامر الكبيرة تغري البعض بخفض max_tokens «لتوفير المساحة». لا تفعل. ميزانية الإخراج الضيقة تنتج إجابات فارغة، فيعيد الوكيل المحاولة. لماذا تعود الإجابات فارغة.
وتذكّر أيضًا أن النافذة تحتسب الأمر والإجابة معًا. فإذا اقترب الأمر من 1,048,576 رمزًا لم يبقَ مكان للإجابة. اضغط السياق قبل أن تصل إلى هناك؛ وتُظهر حاسبة نافذة السياق المساحة التي يتركها أمر معيّن.
هل يهم هذا في خطة بسعر ثابت؟
في جلسة خطة BroadNet، لا يوجد عدّاد رموز على DeepSeek V4.1 Flash: جلسة البدر (Full Moon) بسعر $60 شهريًا مهما طالت الأوامر. فتختفي حجة المال لصالح التخزين المؤقت. أما الحجتان الأخريان فتبقيان. البادئة المخزّنة مؤقتًا تُعالَج عادةً أسرع في كثير من أنظمة التقديم، والسياق المُدار جيدًا يعطي إجابات أفضل. العادات نفسها؛ السبب وحده هو الذي يتغيّر. كيف تعمل جلسات الخطط.
قائمة التحقق لإدارة السياق
- أمر النظام وقائمة الأدوات ثابتان طوال الجلسة.
- لا يُضاف إلى السجل إلا في آخره، ولا يُعاد تنسيق الأدوار القديمة.
- نسبة التخزين المؤقت مسجّلة لكل طلب.
- مخرجات الأدوات محدودة عند إنتاجها، والمخرجات القديمة تُستبدل لاحقًا بسطر مختصر.
- الضغط عند عتبة عالية، مع الاحتفاظ بالأدوار الأخيرة حرفيًا.
- ملف ملاحظات فيه الهدف والقيود والقرارات.
- ميزانية إخراج كبيرة بما يكفي للاستدلال المنطقي.
لمعرفة متى تستحق نافذة المليون رمز الاستخدام أصلًا، راجع دليل نافذة السياق بمليون رمز. ولإيقاف الجلسات التي تكبر دون أن تحرز تقدمًا، راجع ضبط تكلفة حلقات الوكيل.
