الجزء 05 · بطاقة منهجية ١ من ٥
اختر الحل الأبسط الذي ينجز المهمة
ليس كل طلب يحتاج إلى وكيل؛ ابدأ بنوع العمل ثم اختر الأداة المناسبة.
إجابة من معرفة عامة
استخدم نموذجًا عندما لا تحتاج إلى معلومة حديثة أو مصدر محدد.
معلومة حديثة أو موثقة
استخدم البحث عندما يلزم مصدر خارجي حديث، ثم تحقق من المصدر بنفسك.
حساب أو أثر خارجي
استخدم أداة مناسبة للحساب أو لتنفيذ إجراء مضبوط. اشترط موافقة بشرية عند الإرسال أو التعديل.
خطوات ثابتة أو متغيرة
اختر سير عمل للخطوات المحددة. استخدم وكيلًا فقط عندما يحتاج إلى اختيار الخطوة التالية أو الأداة، مع حدود واضحة.
تطبيق سريع
صنّف مهمة من عملك: نموذج، بحث، أداة، سير عمل، أم وكيل؟ اذكر سبب الاختيار ومتى تحتاج مراجعة بشرية.
✎ دوّن تطبيقك
الجزء 05 · بطاقة منهجية ٢ من ٥
الوكيل (Agent) يختلف عن سير العمل (Workflow)
سير العمل ينفذ خطوات محددة سلفًا، بينما يختار الوكيل بعض الخطوات أو الأدوات بحسب ما يظهر له.
سير العمل
مناسب عندما تعرف الخطوات مسبقًا: استقبال، تحقق، تلخيص، موافقة، إرسال.
الوكيل
مناسب عندما تعتمد الخطوة التالية على نتيجة سابقة أو يحتاج النظام البحث بأدوات متعددة. وهو أكثر تعقيدًا في التقييم.
القرار
ابدأ بالأبسط الذي يفي بالمهمة. لا تجعل كلمة «وكيل» غطاءً لسلسلة غير مضبوطة أو صلاحيات أوسع من اللازم.
تطبيق سريع
ارسم الخطوات. إذا كان المسار ثابتًا، نفذ Workflow. إذا احتاج اختيارًا متغيّرًا، حدد صلاحيات Agent.
✎ دوّن تطبيقك
الجزء 05 · بطاقة منهجية ٣ من ٥
الأداة جزء من تصميم المهمة
كل أداة توسع ما يمكن للنظام فعله، لكنها تضيف أيضًا احتمالًا جديدًا للفشل.
وصف جيد للأداة
اسم واضح، مدخلات متوقعة، نتيجة معروفة، وأمثلة لحالات الفشل. واجعل الأدوات متمايزة حتى لا يحتار بينها الوكيل.
صلاحيات متدرجة
امنح القراءة قبل الكتابة، والوصول المحدود قبل الوصول الشامل. افصل البحث عن الإرسال أو الحذف.
الاختبار
اختبر الأداة على نتيجة ناجحة، ونتيجة فارغة، وخطأ، ومدخل غير صالح. سجل ما ينبغي أن يفعله النظام عند كل حالة.
تطبيق سريع
قبل تنفيذ الإجراء الخارجي، اعرض ملخص الهدف والمستلم أو المحتوى واطلب موافقة عند لزومها.
✎ دوّن تطبيقك
الجزء 05 · بطاقة منهجية ٤ من ٥
حلقة الوكيل تحتاج إلى نقطة توقف واضحة
الهدف ← اختيار أداة ← تنفيذ ← ملاحظة النتيجة ← تحقق ← متابعة أو توقف.
التقدم
عرّف ما الذي يعد اكتمالًا، وما الحد الأقصى للتكرار والوقت والتكلفة.
المهلة والمحاولات
حدد وقتًا أقصى وعددًا محدودًا للمحاولات. أعد المحاولة عند خطأ مؤقت فقط، ولا تكرر الإجراء إذا كان أثره قد وقع.
منع تكرار الأثر
في الإرسال أو الدفع أو إنشاء سجل، تحقّق من نتيجة المحاولة الأولى قبل الإعادة، واستخدم معرّفًا يمنع تكرار العملية إن توفر.
الاسترداد
إذا استمر الفشل، صعّد المهمة إلى شخص أو أوقفها بأمان؛ لا تجعل الوكيل يعيد المحاولة بلا نهاية.
السجل
سجّل مدخلات الأدوات ومخرجاتها والقرارات المهمة، مع حماية البيانات. السجل يساعدك على اكتشاف الخطأ وتحسين الاختبار.
تطبيق سريع
توقف إذا تحقق [الشرط]، أو تجاوزت [الحد]، أو احتاج القرار صلاحية غير ممنوحة.
✎ دوّن تطبيقك
الجزء 05 · بطاقة منهجية ٥ من ٥
الموافقة البشرية ترتبط بأثر الإجراء
أشرك الإنسان عند اتخاذ قرار يغيّر حالة خارجية أو قد يسبب ضررًا يصعب التراجع عنه.
المهام قليلة الأثر
قد تكفي عينة تراجعها. أما إرسال رسالة أو نشر محتوى أو تعديل سجل، فيحتاج تحققًا بحسب طبيعة العمل.
موافقة عن علم
اعرض ماذا سيُنفَّذ، وعلى أي بيانات، وما أثره المتوقع. سؤال «هل توافق؟» وحده، دون تفاصيل، لا يحميك.
حدود التفويض
حدّد ما لا يجوز للنظام تنفيذه أبدًا، لا ما عليه أن يسأل عنه فقط.
تطبيق سريع
اطلب الموافقة قبل [النشر/الإرسال/الحذف/الشراء]. وإن لم تتوفر، جهّز مسودة ولا تنفّذ.
✎ دوّن تطبيقك
