المراقبة والتصحيح
كيف تتبع وتصلح مشاكل الوكلاء
أحمد: "الوكلاء أكثر تعقيداً من البرومبتات العادية. كيف أعرف ما يفعله داخلياً؟" سارة: "سؤال مهم جداً! Anthropic يقولون: 'أولوية للشفافية - أظهر خطوات تخطيط الوكيل بوضوح.' هذا يعني: • سجل كل خطوة يتخذها • أظهر سبب كل قرار • تتبع استخدام الأدوات • قس الأداء والتكلفة" أحمد: "مثل الصندوق الأسود في الطائرة؟" سارة: "بالضبط! لكن هنا نسميه Observability - القابلية للمراقبة."
📊 عناصر المراقبة
💡 مثال: سجل تنفيذ وكيل
``` [10:30:01] USER: أين طلبي رقم ORD-5678? [10:30:02] THOUGHT: سأبحث عن الطلب [10:30:02] TOOL: search_orders(order_id="ORD-5678") [10:30:03] RESULT: {status: "shipped", tracking: "SA123..."} [10:30:03] THOUGHT: وجدت الطلب، سأخبر العميل [10:30:04] RESPONSE: "طلبك تم شحنه! رقم التتبع: SA123..." --- Stats: - Duration: 3 seconds - Tool calls: 1 - Tokens: 450 - Cost: $0.0045 - Success: ✅ ```
🔧 تصحيح مشاكل الوكلاء
**مشكلة: الوكيل لا يستخدم الأداة الصحيحة** → راجع وصف الأداة، هل واضح متى تُستخدم؟ **مشكلة: حلقة لا نهائية** → أضف شرط توقف وحد أقصى للخطوات **مشكلة: تكلفة عالية** → هل يستخدم نموذج أكبر من اللازم؟ → هل هناك خطوات يمكن اختصارها؟ **مشكلة: نتائج غير متسقة** → هل التعليمات واضحة بما فيه الكفاية؟ → جرب تقليل Temperature **مشكلة: تسليمات خاطئة** → راجع شروط التسليم، هل هناك تداخل؟
📋 قائمة فحص الإنتاج
**قبل نشر وكيل للإنتاج، تأكد من:** ✅ **الاختبار:** - [ ] اختبرت الحالات السعيدة - [ ] اختبرت الحالات الحدية - [ ] اختبرت محاولات الاختراق ✅ **المراقبة:** - [ ] التتبع مفعّل - [ ] التنبيهات معدّة - [ ] لوحة تحكم جاهزة ✅ **الأمان:** - [ ] القيود محددة - [ ] الصلاحيات محدودة - [ ] Human-in-the-loop للعمليات الحساسة ✅ **التكلفة:** - [ ] حد أقصى للتكلفة/المستخدم - [ ] تنبيه عند تجاوز الميزانية