Phase 14: Agent Engineering

اكتشف تدفق العمل الذي يقوم به الناس في الواقع

لا تنتظر الاحتياجات في الاجتماع ليتم جمعها.

Type: Learn + Build

Languages: Python (stdlib)

Prerequisites: Phase 14 lesson 47

Time: ~70 minutes

أهداف التعلم

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

ابدأ بالنظام الحالي

لا تبدأ بسؤال ما هي الميزات التي يريدها الناس، ابدأ بإعادة بناء ما يحدث الآن.

لكل خطوة، سجل:

Field	Example
Actor	On-call engineer
Trigger	Production alert arrives
Action	Opens alert, then searches dashboards
Input	Alert payload and deployment record
Output	Candidate service and owner
Friction	Context switching across three tools
Authority	Incident commander approves a write
Evidence	Screen recording, incident log, runbook

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

الأدلة قوية

استخدم سلم الأدلة البسيط:

Direct behavior:الملاحظة، تتبع، تسجيل، أو حدث النظام.
Artifact:التذكرة، دفتر الدفع، السجل، النموذج، أو الناتج المكتمل.
Reported behavior:الشخص يصف ما يفعلونه
Inference:الفريق يختتم بما قد يحدث

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

flowchart TD
  T[Trigger] --> A1[Actor action]
  A1 --> H[Handoff]
  H --> A2[Next actor action]
  A2 --> O[Outcome]
  E1[Direct evidence] -.supports.-> A1
  E2[Artifact] -.supports.-> H
  E3[Reported behavior] -.supports.-> A2

ابحث عن أربعة أشياء

Friction:الجهد المتكرر، التأخير، إعادة الدخول، أو التعافي.
Hidden state:الحقائق التي تحمل في الذاكرة، أو المحادثة، أو الملاحظات الشخصية.
Authority:الشخص أو النظام الذي تمكن من إجراء تغييرات متتالية.
Exceptions:حالة توقف سير العمل الطبيعي عن أن يكون طبيعياً.

غالبا ما تفشل ميزات الذكاء الاصطناعي في التسليمات والاستثناءات لأن الطريق السعيد هو الطريق الوحيد الذي تم تشكيله.

لا تُبْلِّغوا الخلافات

يمكن للمستخدمين تنفيذ عمليات عمل مختلفة لأسباب جيدة. احتفظ بالفوارق حتى تفهم ما إذا كانت تمثل:

أدوار مختلفة
مستويات المخاطر المختلفة
الإرث والعملية الحالية
اختلافات الخبرة
خلاف سياسي حقيقي

متوسط تدفق العمل لا يمكن وصف أي شخص.

بناءها

المختبر يحتفظ بالأدلة في كل خطوة من سير العمل، ويمتدّل التنظيم والثقة، ويحسب نسبة الأدلة المباشرة، ويكتب outputs/workflow-evidence.json. . .

bashpython3 code/main.py
python3 -m unittest discover code/tests -v

إضافة مسار استثناء حيث لا يوجد سجل التنفيذ. الحفاظ على النظام الرئيسي سليم وتسجيل حيث تبدأ الفرع.

التمارين

إعادة إنشاء سير عمل واحد من سجل دون مقابلة أي شخص
إجراء مقابلة مع المستخدم وتسجيل كل ادعاء لا يزال يفتقر إلى أدلة مباشرة.
أضف حدة سلطة واحدة و خطوة واحدة للتعافي من الفشل
نموذج اثنين من خيارات سير العمل دون دمجها.
حدد ميزة المقترحة التي تزيل خطوة مرئية ولكن تترك العمل الخفي دون تناول.

ما تحافظ عليه

إبقoutputs/workflow-evidence.jsonيُحوّل التضارب والشك الملاحظ إلى خريطة افتراضية في الدروس التالية.

This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.

Browse the complete course catalog or open this lesson on GitHub.