كيف تكتب نوافذ النظام لوكلاء الذكاء الاصطناعي التي لا تفشل في الإنتاج

جدول المحتويات

محدّث يوليو 2026.

TL;DR: نافذة نظام الإنتاج تحتوي على خمس طبقات: الهوية (من هو الوكيل وما لا يمكنه فعله)، السياق (ما يعرفه عن البيئة)، المهمة (كيف يبدو النجاح خطوة بخطوة)، تنسيق المخرجات (الطبقة الأكثر إهمالاً)، والحالات الحدية (ماذا تفعل عندما تكون المدخلات خاطئة). معظم نوافذ النظام تفشل لأنها تتخطى الطبقتين 4 و5. اكتب تنسيق المخرجات أولاً — هذا يجبرك على أن تكون دقيقاً فيما تريده حقاً.

[منظور المشغّل] أدير أكثر من 30 وكيل ذكاء اصطناعي في الإنتاج لعلامتي التجارية الاستشارية وPickleland، وهو منشأة بيكلبول في بفلوغرفيل، تكساس. لقد أعدت كتابة نوافذ نظام أكثر مما كتبت — في الغالب لأن الإصدار الأول بدا جيداً في الاختبارات ثم تدهور بهدوء في الإنتاج. هذا ما تعلمته عن كتابة النوافذ التي تدوم.

مشكلة نافذة النظام التي لا يعترف بها أحد

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

المشكلة ليست أن النافذة الأصلية كانت سيئة. المشكلة أن معظم النوافذ تُكتب لإثبات “المسار السعيد”. إنها مصممة للمدخلات التي كنت تفكر فيها عند بناء الوكيل، وليس للتوزيع الكامل للمدخلات التي سيراها الوكيل فعلياً.

الطبقات الخمس لنافذة نظام الإنتاج

أفكر في كل نافذة نظام أكتبها بخمس طبقات. لا يجب أن تظهر بهذا الترتيب — لكن يجب أن تكون جميعها موجودة.

الطبقة 1: الهوية

الهوية تخبر النموذج من هو وما هي قيوده التشغيلية. ليس شخصية لعب أدوار — بل تعريف وظيفي لما يفعله هذا الوكيل وما لا يفعله.

طبقة هوية قوية تجيب على ثلاثة أسئلة:

• ما المسؤوليات التي يحملها هذا الوكيل؟
• عن ماذا هو غير مسؤول صراحةً (ويجب تصعيده أو رفضه)؟
• ما المعايير التي يلتزم بها؟

النطاق الصريح لما هو “خارج النطاق” هو الجزء الذي يتخطاه معظم المشغلين. بدونه، سيحاول النموذج أن يكون مفيداً خارج اختصاصه — وهنا تحدث المشاكل.

الطبقة 2: السياق

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

لا تفترض. احقن.

الطبقة 3: المهمة

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

الطبقة 4: تنسيق المخرجات

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

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

للوكلاء عالية المخاطر، أستخدم المخرجات المنظمة من Claude مع مخطط JSON محدد.

الطبقة 5: الحالات الحدية

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

كيف أصون نوافذ النظام بمرور الوقت

نافذة نظام الإنتاج وثيقة حية:

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

الأسئلة الشائعة

ما الطول المناسب لنافذة نظام الإنتاج؟

طويلة بما يكفي لتغطية الطبقات الخمس. قصيرة بما يكفي لقراءتها في دقيقتين واكتشاف الانجراف. بالنسبة لمعظم وكلائي، هذا 200-600 كلمة.

متى يجب تقسيم المهمة المعقدة إلى وكلاء متعددين بدلاً من نافذة طويلة واحدة؟

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

ما أكثر سبب شائع لفشل النافذة التي عملت في الاختبارات في الإنتاج؟

مدخلات الاختبار لم تكن ممثلة لتوزيع الإنتاج. أنشئ مجموعة اختبار من حركة مرور الإنتاج الفعلية، وليس من المدخلات المتخيلة.

كيف أعرف متى أحدّث النافذة مقابل الكود؟

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