هندسة السياق: كيف تمنع وكيل الذكاء الاصطناعي من التشتّت؟

إذا نجح الوكيل في العرض التجريبي ثم فقد تركيزه أثناء العمل الفعلي، فافحص ما يصل إلى النموذج قبل أن تضيف مزيدًا من التعليمات. تتيح لك هندسة السياق التحكم في 5 مدخلات في كل خطوة: التعليمات، والأدوات، والحقائق المسترجعة، والذاكرة، وسجل المحادثة. والهدف هو توفير ما يكفي من الأدلة لاتخاذ الإجراء الصحيح التالي، مع تقليل ما يصاحبها من معلومات لا تخدم المهمة.

ما المقصود بهندسة السياق؟

هندسة السياق هي تحديد ما يراه النموذج لحظة اتخاذ قراره التالي. ويشمل ذلك التعليمات التي تكتبها، والأدوات المتاحة له، والأدلة التي تعيدها تلك الأدوات، وما تحمّله من الذاكرة، وما تحتفظ به من المحادثة.

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

هذا الفرق يفسّر إخفاقًا مألوفًا في بيئات الإنتاج: قد يستطيع الوكيل الوصول إلى السياسة الصحيحة، لكنه يجيب اعتمادًا على محادثة قديمة لأن السياسة الحالية لم تصل إلى النموذج عند اتخاذ القرار. وفي المقابل، قد يؤدي تحميل جميع السياسات إلى إدخال استثناءات لا تخص المهمة ونسخ لم تعد سارية.

في مقالها الهندسي المنشور في 29 سبتمبر 2025، تصف Anthropic هذا العمل بأنه «انتقاء المجموعة المثلى من الرموز (المعلومات) والمحافظة عليها أثناء استدلال النموذج اللغوي الكبير». وهي تميّز بين كتابة التعليمات وإدارة المجموعة الأوسع من المعلومات المقدّمة أثناء التنفيذ. مقال Anthropic عن هندسة السياق.

ويصفه مقال LangChain المنشور في 2 يوليو 2025 بأنه «ملء نافذة السياق بالمعلومات المناسبة تمامًا في كل خطوة من مسار الوكيل». ويجمع العمل في أربع عمليات: الكتابة، والاختيار، والضغط، والعزل؛ أي حفظ حالة العمل المفيدة، وجلب المادة ذات الصلة، واختصار ما يبقى، وفصل التحقيقات المستقلة بعضها عن بعض. مقال LangChain عن هندسة السياق.

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

جرى التحقق من التوثيق في 13 أكتوبر 2026: روجع سلوك الأدوات الموضّح أدناه بالرجوع إلى توثيق Anthropic وOpenAI المتاح حينها. والمثال التطبيقي تصميم توضيحي، وليس معيار أداء مأخوذًا من نظام يعمل في الإنتاج.

ما الفرق بين هندسة السياق وهندسة الأوامر؟

تهتم هندسة الأوامر بتحسين التعليمات، بينما تهتم هندسة السياق بتحسين الطلب كاملًا بما يحيط بتلك التعليمات. وتظل بحاجة إلى كليهما.

في حالة وكيل برمجي، قد تستبدل هندسة الأوامر عبارة «أصلح التسجيل» بصياغة أدق: «ابحث عن سبب إرسال رسائل ترحيب مكررة عند إعادة محاولة التسجيل، واقترح تعديلًا بأقل قدر ممكن من التغييرات واختبارًا يمنع تكرار الخلل». بعد ذلك تحدّد هندسة السياق ملفات التسجيل، وسجلات إعادة المحاولة، وقواعد المشروع، والنتائج السابقة التي يتلقاها الوكيل قبل اقتراح الإصلاح.

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

المهارة الأهم في هندسة السياق: تحديد ما يدخل وما يخرج

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

مكان قاعدة تنسيق الشيفرة هو التعليمات الدائمة. أما ملاحظة «فرع إعادة المحاولة لم يُختبر بعد» فمكانها مذكرة تسليم المهمة الحالية. وتُحفظ استجابة مزوّد الخدمة كاملة في ملف أدلة يمكن الوصول إليه، ثم تُحمّل الحقول ذات الصلة حين تؤثر في القرار.

ولهذا أيضًا فإن التوليد المعزّز بالاسترجاع، أو RAG، ليس سوى جزء من العمل. فهو يجلب المواد الداعمة للنموذج، لكن يبقى عليك اختيار التعليمات، والأدوات، وسجل المحادثة الذي تحتفظ به، ومخرجات ذلك الاسترجاع.

هندسة السياق لوكلاء الذكاء الاصطناعي: الأساليب الأساسية

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

اضغط سجل المحادثة حول القرارات، لا حول الموضوعات وحدها

يوفّر Claude Code، الوكيل البرمجي من Anthropic، الأمر /context لفحص استخدام السياق، والأمر /compact لاختصار المحادثة. وتحذف إدارته التلقائية مخرجات الأدوات الأقدم، ثم تلخّص المحادثة عند الحاجة. ويحذّر التوثيق صراحة من احتمال فقدان تعليمات تفصيلية وردت في مراحل سابقة من المحادثة. إدارة السياق في Claude Code.

حدّد غرضًا واضحًا للضغط. في التحقيق بشأن رسائل الترحيب، استخدم /compact Preserve the current goal, change boundaries, relevant file paths, observed evidence, failed hypotheses, and the next unresolved question. هذا أمر يحمل توجيهات تخص المهمة، وليس ضمانًا لبقاء كل التفاصيل.

قبل المتابعة، تأكّد من أن الملخّص ما زال يميّز بين ما لوحظ وما استُنتج وما لم يُفحص. فعبارة «جرى التحقيق في إعادة محاولة إرسال البريد» لا تتعدى تسمية الموضوع. أما «تأكّد قبول مزوّد الخدمة للطلب، وما زال مسار تسجيل الإقرار المحلي بحاجة إلى فحص» فتنقل حالة عمل يمكن البناء عليها.

يفقد الضغط بعض المعلومات. أبقِ الأدلة الأصلية في متناول الوكيل، وضع القواعد الثابتة في تعليمات المشروع، حتى تتمكن خطوة لاحقة من استعادة التفاصيل التي تحتاج إليها.

استرجع الأدلة عند الحاجة إليها

اجلب المصدر الذي يجيب عن السؤال التالي، ثم وسّع البحث فقط إذا لم تكفِ النتيجة. يصف مقال Anthropic الهندسي هذا الأسلوب بالاحتفاظ بإشارات مرجعية موجزة واستخدام الأدوات لتحميل المعلومات عند الحاجة. توفير السياق عند الحاجة.

تدعم أدوات قراءة الملفات وتنفيذ أوامر الطرفية في Claude Code هذا الأسلوب. اطلب منه تحديد معالج إعادة المحاولة، وقراءة المعالج والجزء الذي يستدعيه، وفحص تسلسل الأخطاء المطابق. وحيث تكون أداة Grep المخصّصة مفعّلة، يمكنها إعادة مسارات الملفات أو المحتوى المطابق أو أعداد التطابقات بدلًا من الملفات كاملة. مرجع أدوات Claude Code.

إذا كنت تبني وكيلك الخاص، فأعد مع النتيجة معرّفًا يتيح الرجوع إلى المصدر، ومقتطفًا ذا صلة، وبيانات وصفية تكفي لتحديد نطاق انطباقه، مثل البيئة أو هوية السجل أو الإصدار أو تاريخ السريان. ويمكن لاستدعاء لاحق للأداة فتح المادة المحيطة بالمقتطف.

قد يفوت الاسترجاع أدلة مهمة، لذلك ضع قاعدة لتوسيع البحث. إذا لم يُظهر البحث الضيق شيئًا، فغيّر نطاقه أو استعلامه قبل الاستنتاج بأن المعلومة غير موجودة. وإذا لم يكفِ المقتطف لمعرفة ما إذا كان استثناء ما ينطبق، فحمّل القسم المحيط به.

اختصر نتائج الأدوات قبل إدخالها في المحادثة

أعد النتيجة اللازمة للقرار التالي، مع وسيلة لاستعادة التفاصيل المحذوفة. توصي Anthropic باستخدام التصفية، وتقسيم النتائج إلى صفحات، واختيار نطاقات محددة، والاقتطاع للأدوات كثيرة المخرجات، مع إرشادات مفيدة عندما تُختصر النتائج. إرشادات Anthropic لتصميم الأدوات.

يطبّق Claude Code صورة عملية من هذا الأسلوب على المخرجات الكبيرة لأوامر الطرفية الناجحة: عندما تتجاوز حد العرض داخل المحادثة، يقدّم مسار ملف محفوظ ومعاينة، فيستطيع الوكيل البحث في الملف أو قراءته عند الحاجة. أما التعامل الموثّق مع الأوامر الفاشلة فيختلف، فلا تفترض أن كل رسالة خطأ مقتطعة تتضمن مسار ملف يمكن استعادتها منه. التعامل مع مخرجات الطرفية.

بالنسبة إلى وكيل التسجيل، تتضمن نتيجة السجل المفيدة الحدث المطابق، والعملية السابقة له، والخطأ، وموضع المصدر. ويمكن إبقاء الطلبات السليمة المتكررة في ملف السجل. حافظ على رمز الخطأ وهوية الحدث كما هما؛ فوصف نثري مثل «انتهت مهلة شيء ما» قد يمحو الدليل الذي يتوقف عليه اختيار الإصلاح.

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

استخدم وكلاء فرعيين لا يرثون المحادثة لبدء تحقيقات بسياق مستقل

يستطيع الوكلاء الفرعيون في Claude Code إجراء تحقيق محدّد النطاق داخل نافذة سياق منفصلة، ثم إعادة النتيجة. يبدأ الوكيل الفرعي غير المتفرّع من المحادثة من تعريفه والمهمة المقدّمة له فقط، بينما يرث فرع المحادثة سجل الوكيل الأصل. ويفصل كلاهما العمل اللاحق، لكن الأول وحده يمنحك سياق بداية خاليًا من السجل السابق. الوكلاء الفرعيون وفروع المحادثة.

فوّض مهمة من قبيل: «افحص مسار إعادة محاولة إرسال البريد. لا تعدّل الملفات. أعد المسارات ذات الصلة، والأدلة على تكرار التسليم، والتفسيرات البديلة، والفحص التالي». وأدرج القيود التي يحتاج إليها الوكيل الفرعي، بدلًا من افتراض اطلاعه على محادثة الوكيل الأصل.

احصر ما يعيده في قدر يسهل استخدامه: النتائج، ومراجع الأدلة، وما بقي غير محسوم. فالوكيل الذي يعيد سجل قراءاته كاملًا لا يفعل سوى نقل التضخّم إلى المحادثة الرئيسية.

يرسل الوكلاء الفرعيون طلباتهم الخاصة ويستهلكون موارد الاستخدام. وقد يكررون عملًا سابقًا إذا أغفل تكليفهم قرارًا حسمه الوكيل الأصل. استخدمهم حين يمكن فصل التحقيق عن بقية العمل والاستغناء عن مخرجاته الوسيطة. وأبقِ الاستدلالات المترابطة بشدة معًا. تجد تفاصيل الإعداد في الوكلاء الفرعيين في Claude Code.

اجعل لملفات الذاكرة دورًا محدودًا وثابتًا

ملف CLAUDE.md مخصّص لتعليمات المشروع، وليس لتجميع كل المحادثات المنتهية. ويوفّر Claude Code أيضًا ذاكرة تلقائية للملاحظات التي يتعلّمها. ويميّز توثيقه بين هذين المصدرين وبين الإعدادات التي تُفرض تقنيًا: كتابة حظر في ملف ذاكرة لا تجعل الإجراء مستحيلًا من الناحية التقنية. الذاكرة في Claude Code.

في فريق منتج صغير، ضع في الملف الدائم قواعد المستودع، وأوامر البناء والاختبار الفعلية، وحدود التغييرات، وروابط المراجع الأكثر تفصيلًا. واحتفظ بحالة التحقيق المؤقتة في مذكرة مستقلة للمهمة. راجع ذاكرة الفريق في CLAUDE.md للاطلاع على بنية الملف.

هناك قيد قد يغيب عن الانتباه: استيراد مستند طويل داخل CLAUDE.md يؤدي إلى تحميل محتواه أيضًا. وقد يحسّن نقل النص إلى ملفات مستوردة التنظيم من دون أن يقلّل السياق النشط. وإذا كانت التعليمات تخص جزءًا فقط من المستودع، فانظر في القواعد الموثّقة المقيّدة بمسارات محددة. أما مسارات العمل القابلة لإعادة الاستخدام، فعادةً ما تعرض مهارات Claude Code أوصافها أولًا، ثم تحمّل تعليماتها الكاملة عند استدعائها. استيراد الذاكرة والقواعد محددة النطاق، تحميل المهارات.

قد تحفظ الملفات الدائمة افتراضات تجاوزها الزمن بالكفاءة نفسها التي تحفظ بها المعرفة المفيدة. احذف الحوادث التي عولجت والأوامر التي استُبدلت، وسجّل مصدرًا أو نسخة مرجعية للحقائق المتغيرة. ولتوضيح الفرق الأوسع بين الجلسة، وسياق العمل، والتخزين الدائم، اقرأ شرح ذاكرة الوكلاء.

كيف يطبّق Claude Agent SDK وCodex هذه الأساليب؟

توفّر هذه الأدوات الآليات اللازمة، لكن تطبيقك يظل مسؤولًا عن اختيار الأدلة وحدود المهمة. فلا تستطيع إدارة السياق التلقائية تحديد معلومة العمل التي نسي مسار عملك استرجاعها.

Claude Agent SDK: دمج حلقة عمل الوكيل في تطبيقك

يوفّر Claude Agent SDK الأدوات وحلقة عمل الوكيل وإدارة السياق التي يعتمد عليها Claude Code، لتستخدمها في تطبيقات Python وTypeScript. استخدمه حين تدمج وكيلًا في منتج أو عملية مؤتمتة تديرها. نظرة عامة على Agent SDK.

يضغط SDK السجل الأقدم تلقائيًا عندما تقترب النافذة من حدّها، ويصدر حدث نظام باسم compact_boundary. سجّل هذا الحدث بجانب نتائج المهمة لتحديد الإخفاقات التي تظهر بعد التلخيص. ويحتفظ وكلاء SDK الفرعيون الذين لا يتفرّعون من المحادثة بعملهم الوسيط في محادثاتهم الخاصة، ثم يعيدون رسالتهم النهائية. حلقة عمل الوكيل في SDK، الوكلاء الفرعيون في SDK.

حدّد بوضوح كيفية تحميل تعليمات المشروع. تفعّل الخيارات الافتراضية الحالية لـquery() مصادر المستخدم والمشروع. وإذا مرّرت settingSources في TypeScript أو setting_sources في Python، فأدرج project عندما تحتاج إلى ملف CLAUDE.md الخاص بالمشروع؛ إذ تمنع المصفوفة الفارغة تحميله. تتحكم مصادر الإعدادات في هذا السلوك، وليس اختيار الإعداد المسبق claude_code لتعليمات النظام. تحميل التعليمات في SDK.

حتى حلقة العمل المتقنة تحتاج إلى سياسة استرجاع تخص مجالها. فوكيل الدعم ما زال بحاجة إلى تعريفك للعميل المعني، والسياسة المنطبقة، والأدلة المطلوبة قبل أن يتصرف.

Codex: افصل تعليمات المستودع عن المحادثة الجارية

يقرأ Codex من OpenAI تعليمات AGENTS.md قبل بدء العمل. ويجمع الإرشادات العامة مع ملفات المشروع بدءًا من جذر المستودع وصولًا إلى مجلد العمل؛ وتكون الأولوية للإرشادات اللاحقة، كما يتقدّم AGENTS.override.md على غيره في المجلد الموجود فيه. تعليمات المشروع في Codex.

استفد من هذا التسلسل بوضع قواعد البناء العامة في الجذر والقواعد المتخصصة بالقرب من الملفات المعنية. ويوفّر Codex CLI أيضًا الأمر /compact لتلخيص المحادثة الظاهرة، والأمر /init لإنشاء هيكل أولي لملف التعليمات. راجع هذا الهيكل في ضوء مستودعك قبل اعتماده مرجعًا. أوامر Codex.

لا يحفظ ملف تعليمات المستودع حالة المهمة الجارية تلقائيًا. احفظ الهدف الحالي، والنتائج المؤكدة، والعمل المتبقي، ومواضع الأدلة بصورة مستقلة. وبعد إعادة التشغيل أو ضغط المحادثة، ينبغي أن يتيح الطلب التالي حالة المهمة من دون إعادة عرض التحقيق كاملًا.

مثال على هندسة السياق: من مدخلات متضخّمة إلى سياق مركّز

قلّل المادة المحيطة بالقرار مع الاحتفاظ بما يعتمد عليه. لنتأمل وكيلًا برمجيًا افتراضيًا كُلّف بالتحقيق في رسائل الترحيب المكررة بعد إعادة محاولة التسجيل. أسماء الملفات والأدلة التالية لتوضيح التصميم، وليست نتائج من نظام منشور.

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

1. 1

   أبقِ المهمة الحالية والقيود الثابتة واضحة

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

2. 2

   استبدل حشود الملفات بخريطة للأدلة

   احتفظ بمراجع إلى signup-handler.ts وwelcome-job.ts واختبار إعادة المحاولة وملف السجل ذي الصلة. هذه الأسماء توضيحية. اقرأ المعالج ووحدة تنفيذ المهمة عندما يجيبان عن السؤال التالي، وافحص ما يعتمدان عليه عند الحاجة. تجعل الخريطة الأدلة قابلة للوصول، لكنها لا تغني عن قراءتها.

3. 3

   صفِّ نتيجة الأداة حول موضع الإخفاق

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

4. 4

   افصل عملية بحث محددة النطاق

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

5. 5

   اختصر التحقيق في مذكرة تسليم قابلة للاستخدام

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

6. 6

   ابنِ الطلب التالي من المحتوى المتبقي

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

يمكن أن تكون مذكرة المهمة الناتجة على النحو التالي:

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

تُبقي هذه المذكرة الافتراضية ما لم يُحسم واضحًا. ويتلقى النموذج معها المقتطف الداعم عند إجراء التشخيص.

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

قالب لمذكرة تسليم المهمة في هندسة السياق

استخدم مذكرة مهمة تتضمن الحقول التالية، واملأها بأدلة فعلية من جولة العمل:

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

حدّث المذكرة عندما تتغيّر إحدى النتائج. فإضافة كل فكرة جديدة من دون مراجعة القديمة تعيد إنتاج المشكلة الأصلية داخل ملف أصغر.

الأرقام: حجم السياق والتكلفة يحتاجان إلى قياسين مختلفين

حسّن تكلفة الوصول إلى نتيجة مقبولة، لا طول طلب واحد فقط. فقد تصغر المحادثة الرئيسية بينما يزداد عدد استدعاءات الوكلاء الفرعيين أو طلبات الاسترجاع أو المحاولات الفاشلة.

يوضّح حدّان موثّقان للتعليمات أهمية الانتباه إلى الوحدات. الحد الافتراضي للحجم الإجمالي لمستندات المشروع في Codex هو 32 KiB، أي 32 × 1,024 = 32,768 بايت. هذا حد بالبايت، وليس ميزانية رموز. ويوصي Claude Code بأن يبقى كل ملف CLAUDE.md دون 200 سطر؛ وهذه إرشادات للكتابة، وليست حدًا تقنيًا صارمًا لنافذة السياق. ولا يتيح أي من الرقمين توقّع الوفورات. حد التعليمات في Codex، إرشادات الكتابة في Claude Code.

في مسار عمل يعمل في الإنتاج، سجّل تكلفة الوكيل الرئيسي، والوكلاء الفرعيين، وضغط السياق، والاسترجاع، وإعادة المحاولات. ثم احسب:

تكلفة المهمة المقبولة = إجمالي تكلفة مسار العمل عبر جميع المحاولات ÷ عدد المهام التي تستوفي معايير القبول.

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

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

استعن بـتشخيص التخزين المؤقت للأوامر في GPT-6 للتمييز بين المشكلات الناتجة عن تغيّر الأجزاء الافتتاحية والمشكلات الناتجة عن محتوى غير ضروري. تجعل ذاكرة التخزين المؤقت معالجة المدخلات المتكررة أقل تكلفة، لكنها لا تحدّد ما إذا كانت تلك المدخلات تخدم المهمة أصلًا.

أفضل ممارسات هندسة السياق: ما الذي تغيّره أولًا؟

تدخّل عندما يُظهر سجل التتبّع خللًا في السياق، واختر أصغر تعديل يعالجه. وسجل التتبّع هو التسلسل المسجّل للطلبات واستدعاءات الأدوات والنتائج، بما يشمل ما رآه النموذج قبل كل قرار.

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

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

أما المشترون، فاسألوا هل يتيح المنتج الاطلاع على السياق ونتائج الأدوات التي استندت إليها الإجابة، وهل يحافظ على مراجع المصادر بعد التلخيص، وهل يسمح بالتحكم في التعليمات الدائمة. يصعب تشخيص مشكلات ميزة «ذاكرة» لا تكشف ما تحمّله إلى السياق.

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

أين تبدأ المبالغة في الوعود حول هندسة السياق؟

نافذة سياق أكبر، وذاكرة أكثر، ووكلاء أكثر: كلها قدرات، وليست دليلًا على قرارات أفضل. السؤال المفيد هو ما إذا كانت تساعد مسار العمل المعني على نقل المعلومات الصحيحة إلى الخطوة التالية.

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

الخطأ الأعلى تكلفة هو اعتبار الطلب الأقصر دليلًا على سلامة النظام. فالوكيل الذي يجيب بتكلفة منخفضة اعتمادًا على سياسة خاطئة يظل مخطئًا. وينبغي لسياسة السياق الجيدة أن تجعل التحقق من الإجابة أسهل: القاعدة الحاكمة ظاهرة، والدليل الداعم مرتبط بمصدر، وما لم يُحسم يظل معلنًا بوضوح.

أسئلة يطرحها مطوّر يفقد وكيله التركيز

هل تصلح هندسة السياق وكيلًا ينجح في العرض التجريبي ويفشل في الإنتاج؟

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

هل أحتاج إلى قاعدة بيانات متجهية أو إطار عمل متعدد الوكلاء كي أبدأ؟

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

كيف أعرف أنني حذفت من السياق أكثر مما ينبغي؟

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

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

اشترك في النشرة البريدية للحصول على أدلة عملية لبناء وكلاء مفيدين وتشغيلهم.