spinny:~/writing $ vim context-engineering-agents.md
1~2كلمة اللحظة، في عالم عملاء الذكاء الاصطناعي الصغير، هي هندسة السياق.3~4يبدو أنه تم اختراع علامة تجارية أخرى لبيع شيء قمنا به بالفعل. في جزء منه. ومع ذلك، وكما يحدث في كثير من الأحيان، فإن التسمية تنتشر لأنها تعطي اسمًا للألم الحقيقي.5~6الألم هو أن النماذج لا تفشل لمجرد أنها "لا تفكر". غالبًا ما يفشلون لأننا نرسلهم للعمل في الغرفة الخطأ.7~8نعطيهم تعليمات قديمة. نخفي عنه ملفات مهمة. نمرر لهم مستندات طويلة جدًا ولا نذكر ما يهم. نعرض لهم السجلات دون الأولوية. نعطيهم عشر أدوات دون أن نشرح لهم متى يستخدمونها. ثم نتفاجأ إذا تحرك الوكيل مثل شخص استيقظ في شقة مجهولة.9~10الموجه هو العبارة التي تقولها له. السياق هو العالم الذي تعده من حوله.11~12## من الهندسة الفورية إلى هندسة السياق13~14غالبًا ما كان يُنظر إلى الهندسة السريعة على أنها كتابة. اختر الكلمات المناسبة، واسأل بالطريقة الصحيحة، وأضف الأمثلة، وحدد التنسيق.15~16هندسة السياق أقرب إلى الهندسة المعمارية.17~18أنت لا تسأل فقط "كيف أقوم بصياغة الطلب؟". يسأل:19~20- ما هي المعلومات المطلوبة حقا؟21- ما هي الضوضاء؟22- ما الذي يجب استعادته بسرعة؟23- ما الذي يجب أن نتذكره؟24- ما هي الأدوات التي يجب أن تتعرض لها؟25- ما هي التعليمات المستقرة والتي تعتمد على المهمة؟26- كيف أجعل الوكيل يفهم ما هو المعتمد؟27~28إنه تغيير دقيق ولكنه ضخم. لأنه عندما تعمل مع الوكلاء، فإن السياق ليس كتلة ثابتة. يتغير في كل خطوة.29~30يفتح الوكيل ملفًا، ويتعلم شيئًا ما، ويجري اختبارًا، ويتلقى خطأ، ويحدث الخطة، ويستدعي أداة، ويكتشف التبعية. مع كل لفة عليه أن يقرر ما الذي سيأخذه معه وما الذي يجب تركه.31~32هذه هي الهندسة.33~34## السياق ليس مكب النفايات35~36أعطتنا القوالب ذات نوافذ السياق الكبيرة إغراءً: فلنضع كل شيء فيها.37~38إنه أمر مفهوم. إذا كان لدي مليون رمز، لماذا يجب أن أختار؟39~40لأنه حتى عندما تتمكن من وضع كل شيء، فهذا لا يعني أن كل شيء يساعد. في الواقع، الضوضاء لها تكلفة. إنه يكلف الرموز، ويكلف الاهتمام، ويكلف الكمون، ويكلف الجودة. يمكن أن يضيع النموذج في تفاصيل غير ذات صلة تمامًا مثلنا عندما نفتح عشرين علامة تبويب ولا نتذكر السبب.41~42السياق الجيد له تسلسل هرمي:43~441. تعليمات وسياسات النظام؛452. هدف محدد؛463. الوضع الحالي.474. البيانات ذات الصلة؛485. القيود؛496. الأدوات المتاحة.507. متابعة القرارات التي تم اتخاذها بالفعل.51~52ليست هناك حاجة للتعامل مع كل شيء على نفس المستوى. أمر المستخدم يستحق أكثر من ملاحظة قديمة. إن الاختبار الفاشل أصبح الآن يستحق أكثر من مجرد تفضيل جمالي منذ ثلاثة أشهر. إن سياسة الأمان تستحق أكثر من مجرد اختصار للإنتاج.53~54تعني هندسة السياق أيضًا إعطاء الأوزان، وليس البيانات فقط.55~56## الذاكرة: تذكر أقل، تذكر بشكل أفضل57~58تعد الذاكرة في الوكلاء واحدة من أكثر المواضيع زلقًا.59~60كمستخدم، تريد أن يعرفك الوكيل. تريده أن يتذكر اللهجة، والخطة، والاتفاقيات، والأشياء التي تم تحديدها بالفعل. كمهندس، أنت تعلم أن كل ذكرى مستمرة هي أيضًا خطر: يمكن أن تكون خاطئة، أو قديمة، أو شخصية جدًا، أو عامة جدًا، أو غير قابلة للتحقق.61~62يجب أن تتمتع الذاكرة المفيدة بثلاث صفات على الأقل:63~64- المصدر: من أين تأتي هذه المعلومات؟65- التاريخ: متى كان ذلك صحيحاً؟66- الغرض: ما نوع المهمة التي يجب استخدامها من أجلها؟67~68وبدون هذه الأشياء الثلاثة، تصبح الذاكرة خرافة.69~70أحب أن أفكر في الذاكرة الفاعلة باعتبارها مصنفًا، وليس كعقل سحري. هناك ملاحظات مؤقتة، وقرارات مؤكدة، وتفضيلات الأسلوب، والقيود الفنية، وروابط للمصادر. بعض الأشياء تنتهي صلاحيتها. البعض يحتاج إلى إعادة كتابة. ويجب حذف بعضها لأن الوكيل أخطأ في استنتاجها.71~72النظام الجيد يجب أن يجعل هذه الصيانة طبيعية. ليست بطولية.73~74## الاسترجاع والأدوات ليسا نفس الشيء75~76عندما نتحدث عن السياق، غالبًا ما ينتهي بنا الأمر فورًا إلى RAG. التضمين، قاعدة بيانات المتجهات، التقطيع، إعادة الترتيب.77~78كلها مفيدة. لكن الاسترجاع ليس سوى طريقة واحدة لجلب المعلومات إلى النموذج. إنه ليس الوحيد.79~80يمكن للوكيل الحصول على السياق من خلال قراءة الملفات، والاستعلام عن واجهة برمجة التطبيقات، والاتصال بخادم MCP، وفتح المتصفح، وإجراء الاختبارات، والبحث في Slack، والنظر إلى لوحة المعلومات، وسؤال الإنسان.81~82الجزء المثير للاهتمام هو تحديد الطريق الذي يجب استخدامه ومتى.83~84إذا كان العميل بحاجة إلى الإجابة على سؤال تاريخي، فربما يكون مجرد الاسترجاع كافيًا. إذا كان عليه إصلاح خطأ ما، فعليه قراءة التعليمات البرمجية الحقيقية. إذا كان بحاجة إلى فهم سبب فشل النشر، فيجب عليه إلقاء نظرة على السجلات الجديدة. إذا كنت بحاجة إلى الكتابة إلى العميل، فأنت بحاجة إلى استرداد النغمة والتاريخ وحالة التذكرة. وإذا كان لا بد من التصرف في الإنتاج، فعليه أن يستأذن.85~86السياق ليس قاعدة بيانات. إنه سير العمل.87~88## الوكيل الجيد يعرف أيضًا كيف يتجاهل89~90ستكون علامة النضج لدى الوكلاء هي القدرة على القول: لا أحتاج إلى هذه المعلومات.91~92يبدو الأمر تافها، لكنه صعب للغاية. تتراكم العديد من الأنظمة الوكيلة. يضيف كل استدعاء أداة نصًا. يبقى كل خطأ في المخزن المؤقت. تتم إضافة كل ملف يتم قراءته إلى المكدس. في النهاية، النموذج له تاريخ طويل جدًا ولا توجد به خريطة.93~94هناك حاجة إلى الضغط. هناك حاجة إلى التوليف المتوسط. يجب أن تكون منظمة.95~96ليس "هذا كل ما حدث"، ولكن:97~98- الهدف لا يزال صالحا؛99- الفرضية الحالية.100- الملفات التي تم فحصها بالفعل؛101- القرارات المتخذة؛102- المخاطر المفتوحة؛103- الإجراء التالي.104~105وهذا يجعل الوكيل أقل مسرحية وأكثر فائدة. ليس لأنه يبدو أكثر ذكاءً، ولكن لأنه يعمل بمكتب مرتب.106~107## هندسة السياق للفرق، وليس للفنانين الفوريين108~109السبب الذي يجعلني مهتمًا بهذا الموضوع هو أنه ينقل المسؤولية من الفرد إلى النظام.110~111في الهندسة السريعة، غالبًا ما يفوز الشخص الذي يمكنه التحدث إلى النموذج بشكل أفضل. في هندسة السياق، يفوز الفريق الذي ينظم عمله بشكل أفضل: التوثيق، والاتفاقيات، والقضايا، والسجلات، والاختبارات، والملكية، والتسمية، والمصادر.112~113يصبح المستودع النظيف سياقًا أفضل. إن القضية المكتوبة جيدًا تصبح وقودًا أفضل. يحفظ دليل التشغيل المحدث الرموز والقلق. سجل التغيير الواضح يقلل من الهلوسة.114~115هذه أخبار جيدة وغير مريحة إلى حد ما. جميل لأنه يكافئ الممارسات الجيدة. غير مريح لأنه لا يمكنك حل كل شيء بمطالبة ذكية.116~117يقوم الوكلاء بتضخيم نظافة النظام الذي يجدونه.118~119## كيف سأطبقه غدًا120~121إذا كنت سأقوم بإدخال هندسة السياق في مشروع حقيقي، فسأبدأ بأشياء صغيرة:122~123- ملف تعليمات المشروع القصير والمحافظ عليه؛124- أمثلة جيدة على المخرجات المتوقعة.125- قائمة بالأدوات المتاحة والحالات التي يمكن استخدامها فيها؛126- القرارات المعمارية المكتوبة بطريقة يمكن الاستشهاد بها؛127- قضية مع الحد الأدنى من السياق الإلزامي؛128- سهولة استرداد السجلات والاختبارات؛129- ذاكرة ثابتة قابلة للتعديل من قبل الإنسان.130~131ثم أود أن أقيس شيئًا بسيطًا: كم مرة يتعين على الوكيل أن يطلب توضيحًا أو يمضي في الاتجاه الخاطئ؟132~133إذا حدث ذلك كثيرًا، فلن أضيف نموذجًا أكبر على الفور. أود أن أنظر إلى السياق.134~135##قراءتي136~137هندسة السياق هي كلمة منتفخة بعض الشيء، نعم. لكن المفهوم سليم.138~139ويذكرنا أن ذكاء العميل لا يقتصر فقط على النموذج. إنه يكمن في البيئة التي نهيئها له: ما يراه، وما يتذكره، وما يمكنه فعله، وما يحظر عليه فعله، وما هي المصادر التي يعترف بصحتها.140~141الجزء البشري هو كما يلي: إعداد السياق جيدًا هو شكل من أشكال الرعاية. إنها تخبر الوكيل، ولكن أيضًا الفريق، "لا أريدكم أن تخمنوا، أريدكم أن تحصلوا على ما تحتاجون إليه."142~143سحر أقل. غرفة نظافة. الوكلاء يحتاجون إليها بقدر ما نحتاجها.144~145## المصادر146~147- [مدونة LangChain: ظهور هندسة السياق](https://blog.langchain.com/the-rise-of-context-engineering/)148- [سايمون ويليسون: هندسة السياق](https://simonwillison.net/2025/Jun/27/context-engineering/)149- [بروتوكول سياق النموذج: مقدمة](https://modelcontextprotocol.io/introduction)150- [أنثروبي: بناء عوامل فعالة](https://www.anthropic.com/engineering/building-efficiency-agents)151- [OpenAI: أدوات جديدة لوكلاء البناء](https://openai.com/index/new-tools-for-building-agents/)152~
NORMAL · context-engineering-agents.md [readonly]152 lines · :q to close