spinny:~/writing $ less context-engineering-agents.md
12كلمة اللحظة، في عالم عملاء الذكاء الاصطناعي الصغير، هي هندسة السياق.34يبدو أنه تم اختراع علامة تجارية أخرى لبيع شيء قمنا به بالفعل. في جزء منه. ومع ذلك، وكما يحدث في كثير من الأحيان، فإن التسمية تنتشر لأنها تعطي اسمًا للألم الحقيقي.56الألم هو أن النماذج لا تفشل لمجرد أنها "لا تفكر". غالبًا ما يفشلون لأننا نرسلهم للعمل في الغرفة الخطأ.78نعطيهم تعليمات قديمة. نخفي عنه ملفات مهمة. نمرر لهم مستندات طويلة جدًا ولا نذكر ما يهم. نعرض لهم السجلات دون الأولوية. نعطيهم عشر أدوات دون أن نشرح لهم متى يستخدمونها. ثم نتفاجأ إذا تحرك الوكيل مثل شخص استيقظ في شقة مجهولة.910الموجه هو العبارة التي تقولها له. السياق هو العالم الذي تعده من حوله.1112## من الهندسة الفورية إلى هندسة السياق1314غالبًا ما كان يُنظر إلى الهندسة السريعة على أنها كتابة. اختر الكلمات المناسبة، واسأل بالطريقة الصحيحة، وأضف الأمثلة، وحدد التنسيق.1516هندسة السياق أقرب إلى الهندسة المعمارية.1718أنت لا تسأل فقط "كيف أقوم بصياغة الطلب؟". يسأل:1920- ما هي المعلومات المطلوبة حقا؟21- ما هي الضوضاء؟22- ما الذي يجب استعادته بسرعة؟23- ما الذي يجب أن نتذكره؟24- ما هي الأدوات التي يجب أن تتعرض لها؟25- ما هي التعليمات المستقرة والتي تعتمد على المهمة؟26- كيف أجعل الوكيل يفهم ما هو المعتمد؟2728إنه تغيير دقيق ولكنه ضخم. لأنه عندما تعمل مع الوكلاء، فإن السياق ليس كتلة ثابتة. يتغير في كل خطوة.2930يفتح الوكيل ملفًا، ويتعلم شيئًا ما، ويجري اختبارًا، ويتلقى خطأ، ويحدث الخطة، ويستدعي أداة، ويكتشف التبعية. مع كل لفة عليه أن يقرر ما الذي سيأخذه معه وما الذي يجب تركه.3132هذه هي الهندسة.3334## السياق ليس مكب النفايات3536أعطتنا القوالب ذات نوافذ السياق الكبيرة إغراءً: فلنضع كل شيء فيها.3738إنه أمر مفهوم. إذا كان لدي مليون رمز، لماذا يجب أن أختار؟3940لأنه حتى عندما تتمكن من وضع كل شيء، فهذا لا يعني أن كل شيء يساعد. في الواقع، الضوضاء لها تكلفة. إنه يكلف الرموز، ويكلف الاهتمام، ويكلف الكمون، ويكلف الجودة. يمكن أن يضيع النموذج في تفاصيل غير ذات صلة تمامًا مثلنا عندما نفتح عشرين علامة تبويب ولا نتذكر السبب.4142السياق الجيد له تسلسل هرمي:43441. تعليمات وسياسات النظام؛452. هدف محدد؛463. الوضع الحالي.474. البيانات ذات الصلة؛485. القيود؛496. الأدوات المتاحة.507. متابعة القرارات التي تم اتخاذها بالفعل.5152ليست هناك حاجة للتعامل مع كل شيء على نفس المستوى. أمر المستخدم يستحق أكثر من ملاحظة قديمة. إن الاختبار الفاشل أصبح الآن يستحق أكثر من مجرد تفضيل جمالي منذ ثلاثة أشهر. إن سياسة الأمان تستحق أكثر من مجرد اختصار للإنتاج.5354تعني هندسة السياق أيضًا إعطاء الأوزان، وليس البيانات فقط.5556## الذاكرة: تذكر أقل، تذكر بشكل أفضل5758تعد الذاكرة في الوكلاء واحدة من أكثر المواضيع زلقًا.5960كمستخدم، تريد أن يعرفك الوكيل. تريده أن يتذكر اللهجة، والخطة، والاتفاقيات، والأشياء التي تم تحديدها بالفعل. كمهندس، أنت تعلم أن كل ذكرى مستمرة هي أيضًا خطر: يمكن أن تكون خاطئة، أو قديمة، أو شخصية جدًا، أو عامة جدًا، أو غير قابلة للتحقق.6162يجب أن تتمتع الذاكرة المفيدة بثلاث صفات على الأقل:6364- المصدر: من أين تأتي هذه المعلومات؟65- التاريخ: متى كان ذلك صحيحاً؟66- الغرض: ما نوع المهمة التي يجب استخدامها من أجلها؟6768وبدون هذه الأشياء الثلاثة، تصبح الذاكرة خرافة.6970أحب أن أفكر في الذاكرة الفاعلة باعتبارها مصنفًا، وليس كعقل سحري. هناك ملاحظات مؤقتة، وقرارات مؤكدة، وتفضيلات الأسلوب، والقيود الفنية، وروابط للمصادر. بعض الأشياء تنتهي صلاحيتها. البعض يحتاج إلى إعادة كتابة. ويجب حذف بعضها لأن الوكيل أخطأ في استنتاجها.7172النظام الجيد يجب أن يجعل هذه الصيانة طبيعية. ليست بطولية.7374## الاسترجاع والأدوات ليسا نفس الشيء7576عندما نتحدث عن السياق، غالبًا ما ينتهي بنا الأمر فورًا إلى RAG. التضمين، قاعدة بيانات المتجهات، التقطيع، إعادة الترتيب.7778كلها مفيدة. لكن الاسترجاع ليس سوى طريقة واحدة لجلب المعلومات إلى النموذج. إنه ليس الوحيد.7980يمكن للوكيل الحصول على السياق من خلال قراءة الملفات، والاستعلام عن واجهة برمجة التطبيقات، والاتصال بخادم MCP، وفتح المتصفح، وإجراء الاختبارات، والبحث في Slack، والنظر إلى لوحة المعلومات، وسؤال الإنسان.8182الجزء المثير للاهتمام هو تحديد الطريق الذي يجب استخدامه ومتى.8384إذا كان العميل بحاجة إلى الإجابة على سؤال تاريخي، فربما يكون مجرد الاسترجاع كافيًا. إذا كان عليه إصلاح خطأ ما، فعليه قراءة التعليمات البرمجية الحقيقية. إذا كان بحاجة إلى فهم سبب فشل النشر، فيجب عليه إلقاء نظرة على السجلات الجديدة. إذا كنت بحاجة إلى الكتابة إلى العميل، فأنت بحاجة إلى استرداد النغمة والتاريخ وحالة التذكرة. وإذا كان لا بد من التصرف في الإنتاج، فعليه أن يستأذن.8586السياق ليس قاعدة بيانات. إنه سير العمل.8788## الوكيل الجيد يعرف أيضًا كيف يتجاهل8990ستكون علامة النضج لدى الوكلاء هي القدرة على القول: لا أحتاج إلى هذه المعلومات.9192يبدو الأمر تافها، لكنه صعب للغاية. تتراكم العديد من الأنظمة الوكيلة. يضيف كل استدعاء أداة نصًا. يبقى كل خطأ في المخزن المؤقت. تتم إضافة كل ملف يتم قراءته إلى المكدس. في النهاية، النموذج له تاريخ طويل جدًا ولا توجد به خريطة.9394هناك حاجة إلى الضغط. هناك حاجة إلى التوليف المتوسط. يجب أن تكون منظمة.9596ليس "هذا كل ما حدث"، ولكن:9798- الهدف لا يزال صالحا؛99- الفرضية الحالية.100- الملفات التي تم فحصها بالفعل؛101- القرارات المتخذة؛102- المخاطر المفتوحة؛103- الإجراء التالي.104105وهذا يجعل الوكيل أقل مسرحية وأكثر فائدة. ليس لأنه يبدو أكثر ذكاءً، ولكن لأنه يعمل بمكتب مرتب.106107## هندسة السياق للفرق، وليس للفنانين الفوريين108109السبب الذي يجعلني مهتمًا بهذا الموضوع هو أنه ينقل المسؤولية من الفرد إلى النظام.110111في الهندسة السريعة، غالبًا ما يفوز الشخص الذي يمكنه التحدث إلى النموذج بشكل أفضل. في هندسة السياق، يفوز الفريق الذي ينظم عمله بشكل أفضل: التوثيق، والاتفاقيات، والقضايا، والسجلات، والاختبارات، والملكية، والتسمية، والمصادر.112113يصبح المستودع النظيف سياقًا أفضل. إن القضية المكتوبة جيدًا تصبح وقودًا أفضل. يحفظ دليل التشغيل المحدث الرموز والقلق. سجل التغيير الواضح يقلل من الهلوسة.114115هذه أخبار جيدة وغير مريحة إلى حد ما. جميل لأنه يكافئ الممارسات الجيدة. غير مريح لأنه لا يمكنك حل كل شيء بمطالبة ذكية.116117يقوم الوكلاء بتضخيم نظافة النظام الذي يجدونه.118119## كيف سأطبقه غدًا120121إذا كنت سأقوم بإدخال هندسة السياق في مشروع حقيقي، فسأبدأ بأشياء صغيرة:122123- ملف تعليمات المشروع القصير والمحافظ عليه؛124- أمثلة جيدة على المخرجات المتوقعة.125- قائمة بالأدوات المتاحة والحالات التي يمكن استخدامها فيها؛126- القرارات المعمارية المكتوبة بطريقة يمكن الاستشهاد بها؛127- قضية مع الحد الأدنى من السياق الإلزامي؛128- سهولة استرداد السجلات والاختبارات؛129- ذاكرة ثابتة قابلة للتعديل من قبل الإنسان.130131ثم أود أن أقيس شيئًا بسيطًا: كم مرة يتعين على الوكيل أن يطلب توضيحًا أو يمضي في الاتجاه الخاطئ؟132133إذا حدث ذلك كثيرًا، فلن أضيف نموذجًا أكبر على الفور. أود أن أنظر إلى السياق.134135##قراءتي136137هندسة السياق هي كلمة منتفخة بعض الشيء، نعم. لكن المفهوم سليم.138139ويذكرنا أن ذكاء العميل لا يقتصر فقط على النموذج. إنه يكمن في البيئة التي نهيئها له: ما يراه، وما يتذكره، وما يمكنه فعله، وما يحظر عليه فعله، وما هي المصادر التي يعترف بصحتها.140141الجزء البشري هو كما يلي: إعداد السياق جيدًا هو شكل من أشكال الرعاية. إنها تخبر الوكيل، ولكن أيضًا الفريق، "لا أريدكم أن تخمنوا، أريدكم أن تحصلوا على ما تحتاجون إليه."142143سحر أقل. غرفة نظافة. الوكلاء يحتاجون إليها بقدر ما نحتاجها.144145## المصادر146147- [مدونة 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
:هندسة السياق: العمل قبل الموجهlines 1-152 (END) — press q to close