ابنِ وكيلك الأول دون فوضى

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

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

١. اكتب نتيجة يمكن فحصها

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

قاعدة أنور بي آي: إذا لم تستطع كتابة اختبار بسيط للنتيجة، فلن يعرف الوكيل متى يتوقف.

٢. استخدم حلقة قصيرة وواضحة

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

while not done:
    step = planner.next(goal, state)
    result = tools.run(step)
    state.record(result)
    done = verifier.check(goal, state)

٣. اجعل الأدوات ضيقة الصلاحية

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

عملياً: تحقق من المدخلات قبل التنفيذ، واطلب موافقة بشرية قبل الإرسال أو الحذف أو الدفع، واحتفظ بسجل واضح للطلب والنتيجة.

٤. الذاكرة ليست صندوقاً واحداً

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

قائمة الفحص قبل التشغيل

هل توجد نتيجة نهائية قابلة للتحقق؟ هل لكل أداة مدخلات وصلاحيات محددة؟ هل يستطيع الوكيل التوقف عند الفشل؟ هل العمليات الحساسة تحتاج موافقة؟ هل يمكنك إعادة تشغيل المهمة من السجل؟

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