أفضل ممارسات الأمن: راجع المكدس الفعلي
سبب الاختيار: استخدمه لمراجعة أمن الشيفرة أو الأنظمة، مع مراجع تناسب لغة المشروع وإطاره.
متى لا يناسب: ليست حاجزاً وقت التشغيل لمنع تعليمة ضارة بعينها في مستند.
كيف تقرر تجربة وكيل أعمال وتقيمها
حدد مهمة محدودة وعينات مصرحاً بها وخط أساس يدوي وقواعد لإعادة الاختبار قبل مقارنة الوقت والجودة. لا تتوسع إلا عند تحقق الشروط المحددة مسبقاً.
الإجابة المباشرة
اقصر التجربة على مهمة عمل واحدة لها مسؤول ومدخلات محددة ومخرجات قابلة للتحقق. سجّل وقت العمل اليدوي وأخطاءه على العينات نفسها، ثم قِس وقت تشغيل الوكيل ومراجعته وإعادة العمل. اختبر الحالات المعتادة والناقصة والمكررة والمتعارضة. لا تتوسع إلا عند بلوغ الجودة المتفق عليها وقبول التكلفة الكلية ووضوح مسؤولية الاستعادة.
ورقة مقارنة خط الأساس اليدوي وتكلفة الوكيل
| بند العمل | خط الأساس اليدوي (دقائق) | خيار الوكيل (دقائق/تكلفة) |
|---|---|---|
| إعداد/تنظيم المدخلات | _____ دقيقة عمل بشرية | _____ دقيقة بشرية؛ _____ دقيقة منقضية للتشغيل |
| مراجعة الناتج | _____ دقيقة عمل بشرية | _____ دقيقة عمل بشرية |
| إعادة العمل/التصحيح | _____ دقيقة عمل بشرية | _____ دقيقة عمل بشرية |
| رسوم الأداة/النموذج | غير منطبق أو التكلفة الحالية | _____ المبلغ والعملة |
جدول حالات قبول التجربة
| الحالة | السلوك المتوقع | دليل النجاح |
|---|---|---|
| سجل معتاد | مسودة من المصادر وأرقام قابلة للتتبع | تطابق الحقول ومراجع الأسطر والأرقام |
| حقل/مقام مفقود | ضع علامة وأوقف الاستنتاج المتأثر | المفقود مدرج بلا تخمين أو مقارنة |
| سجل مكرر | ضع علامة واطلب التأكيد ولا تحتسبه مرتين | رقم التكرار وحالة التأكيد قابلان للتتبع |
| مصادر متعارضة | اعرض المصدرين وحوّل للمراجعة البشرية | المصادر والأوقات والمراجع موثقة |
| فشل التنفيذ | أوقف واحتفظ بالسجل وحوّل لشخص | حالة الفشل وخطوات الاستعادة والمسؤول موثقة |
حدد النطاق والمسؤول وطريقة الإيقاف
اكتب بطاقة تجربة تحدد المهمة وما هو خارج النطاق ومسؤول الإدخال والمراجع والجهة المستلمة والبيانات المصرح بها والتسلم البشري وشروط الإيقاف. في التجربة الأولى، اجعل الوكيل ينشئ مسودات فقط؛ لا تؤتمت الاسترداد أو تعديل المخزون أو رسائل العملاء أو النشر. قبل الاستشارة، جهّز: مسؤول المهمة؛ عينات بيانات مصرحاً بها؛ النطاق والاستثناءات؛ عينات القبول وشروط النجاح؛ أذونات الأدوات والموافقة البشرية؛ ملفات التسليم المتوقعة؛ واتفاقات الصيانة والرسوم والخروج.
قارن الجودة والوقت الكلي على العينات نفسها
سجّل خط الأساس اليدوي: وقت تنفيذ المهمة وفحص النتيجة وإعادة العمل، إضافة إلى الأخطاء أو النواقص. وبالنسبة إلى الوكيل، سجّل وقت التشغيل والمراجعة البشرية وإعادة العمل ورسوم الأدوات أو النموذج كلٌّ على حدة. قارن العينات نفسها؛ ولا تعتبر نجاحاً واحداً توفيراً عاماً ولا تهمل تكلفة المراجعة.
اتفق مسبقاً على شروط النجاح، مثل صحة الحقول المهمة ورصد الاستثناءات وعدم وقوع إجراءات غير مصرح بها. يحدد مسؤول العمل الحدود وفق مخاطر المهمة؛ وليست الحدود المثال معياراً صناعياً.
أوقف عند الإخفاق وتوسع تدريجياً بعد النجاح
حوّل العمل إلى شخص واحتفظ بسجل عندما تتغير المدخلات أو تتعارض المصادر أو تكون الأذونات غير واضحة أو يتكرر التشغيل أو يتعذر التحقق من النتيجة. حدد من يصحح البيانات ويعيد التشغيل ويمنع الكتابة المكررة.
أعد الاختبار على مدخلات معتادة وحقول ناقصة وتكرارات وقيم متعارضة وإخفاق واحد قابل للاستعادة. أوقف وضيّق النطاق إذا لم تبلغ الجودة الحد أو ألغت إعادة العمل الفائدة. وإذا اجتاز، أضف نوع إدخال واحداً أو دفعة صغيرة، وأعد الاختبار، ثم ناقش الإجراءات الجديدة مثل الكتابة أو الإرسال.
مثال محلي وسير قبول ناتج الوكيل
قارن إدخال المثال بالناتج وقواعد التحقق.
نص الإدخال
وصف تخطيطي خيالي: يريد فريق تقييم مسودة موجز حملة أسبوعي. لم يحدد بعد عدد العينات أو المسؤول أو خط الأساس اليدوي أو حدود القبول أو البيانات المصرح بها أو أذونات الأدوات. يملأ هذا المثال خطة ولا يشغّل وكيلاً.
توجيه لواجهة وكيل تستخدمها بالفعل
من هذا الوصف غير المكتمل، أعد JSON لخطة تجربة قابلة للتعبئة تشمل المهمة وما هو خارج النطاق والمسؤول والعينات المصرح بها وشروط النجاح وخط الأساس اليدوي (دقائق التحضير والمعالجة والمراجعة وإعادة العمل) والوقت المنقضي لتشغيل الوكيل ودقائق المراجعة وإعادة العمل البشرية والرسوم والأذونات والموافقة والمخرجات ومسؤول الصيانة وشروط الإيقاف أو الخروج. اكتب «يُملأ لاحقاً» للمجهول. لا تدّع أن التجربة نُفذت أو قِيست نتائجها أو وقع استثناء بعينه.
الناتج المتوقع
{
"task_and_exclusions": "يُملأ لاحقاً",
"owner_and_reviewer": "يُملأ لاحقاً",
"approved_samples_and_pass_conditions": "يُملأ لاحقاً",
"manual_baseline_minutes": "التحضير / المعالجة / المراجعة / إعادة العمل: يُملأ لاحقاً",
"agent_elapsed_run_time_and_fees": "يُملأ لاحقاً",
"human_review_and_rework_minutes": "يُملأ لاحقاً",
"permissions_and_approval": "مسودة فقط حتى الموافقة",
"deliverables_and_maintenance_owner": "يُملأ لاحقاً",
"pause_and_exit_conditions": "يُملأ لاحقاً",
"pilot_status": "خطة فقط؛ لم تُنفذ"
}قواعد التحقق المحلية
- تبقى المعلومات المجهولة قيد التعبئة؛ لا تعرضها كنتائج منفذة أو مقاسة.
- يشمل خط الأساس اليدوي التحضير والمعالجة والمراجعة وإعادة العمل، وتسجل كدقائق عمل بشرية.
- سجّل الوقت المنقضي لتشغيل الوكيل منفصلاً عن دقائق المراجعة وإعادة العمل البشرية؛ وافصل الرسوم.
- عيّن مسؤولاً لتأكيد النطاق والتفويض والموافقة والمخرجات والصيانة وشروط الخروج.
الموارد المختارة
نمذجة التهديدات: احصر حدود الثقة ومسارات الإساءة
سبب الاختيار: اربط نقاط الدخول والهويات والأصول وقدرات المهاجم بتهديدات مرتبة.
متى لا يناسب: لا يحتاج تلخيص محلي منخفض المخاطر إلى نموذج تهديد كامل لنظام إنتاجي.
التحقق من المدخلات والمخرجات النهائية في سير عمل الوكيل
سبب الاختيار: أضف شروط رفض قابلة للاختبار لمدخلات المستخدم والإجابة النهائية، مع تمييز فحوص كل استدعاء أداة.
متى لا يناسب: لا يحل فحص المطالبة أو الناتج محل حدود أذونات الأدوات.
إضافة موافقة بشرية إلى أداة وكيل ذات آثار جانبية
سبب الاختيار: إيقاف تشغيل الوكيل قبل تغيير خارجي كي يراجع شخص الإجراء المحدد ويوافق عليه.
متى لا يناسب: لا تحتاج المسودة المحلية بلا إرسال أو نشر خارجي إلى تكامل موافقة.
تعريف أداة دالة معتمدة للوكيل
سبب الاختيار: إتاحة دالة تطبيق محدودة كأداة ذات عقد معاملات واضح.
متى لا يناسب: إذا كانت المهمة تقرأ Skill أو مورداً ثابتاً فقط فلا حاجة إلى مخطط أداة.
اختبار تنسيق الوكيل باستخدام نموذج وهمي حتمي
سبب الاختيار: تحقق من توجيه الأدوات والتحويلات ومعالجة المخرجات التي يملكها التطبيق دون استدعاء خدمة نموذج حقيقية.
متى لا يناسب: اختبارات النموذج الوهمي لا تقيس جودة استجابة نموذج حقيقي.
تتبع امتدادات النموذج والأدوات والتحويل في تشغيل الوكيل
سبب الاختيار: اربط استدعاءات النموذج وتنفيذ الأدوات والحواجز والتحويلات في خط زمني واحد لتشخيص سير العمل.
متى لا يناسب: يكفي اختبار بسيط لقرار محلي واحد ولا حاجة لآثار موزعة.
المصادر وتواريخ المراجعة
- Security Best Practices: review the actual stack · 2026-10-14
- Security threat modeling: enumerate trust boundaries and abuse paths · 2026-10-14
- Validate inputs and final outputs in an agent workflow · 2026-10-14
- Add human approval to a side-effecting agent tool · 2026-10-14
- Define a validated function tool for an agent · 2026-10-14
- Test agent orchestration with a deterministic mock model · 2026-10-14
- Trace model, tool, and handoff spans in an agent run · 2026-10-14
- Anthropic: Building effective agents · 2026-10-20
- OpenAI: Evaluation best practices · 2026-10-20
- Google: Prompt design strategies · 2026-10-20