شروحات الوظائف 01: محرك التنسيق

من الطلب الأول إلى التصحيح المُختبر

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

مع هذا المنشور تبدأ سلسلة "شروحات الوظائف". إنها تجعل الآليات المركزية لـ Agent Argo مفهومة - لا كوعود تسويقية، بل على طول استخدامها الفعلي. الافتتاح يشكله محرك التنسيق: المسار الذي يحول متطلباً إلى عملية عمل خاضعة للرقابة.

1. قبل البدء: تحديد الجودة والتكلفة والاستقلالية

قبل أن يعالج Argo مهمة، هناك قراران مهمان. هما مفصولان عن قصد:

1. كيف يجب أن يوازن Argo بين التكلفة وجودة النتيجة؟
2. ما مدى استقلالية Argo في التصرف في المشروع؟

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

المستويات الثلاثة للتكلفة والجودة

يعرف موجه النموذج ثلاثة أوضاع مفهومة. إنها تغير مدى تأثير السعر ومستوى النموذج في الاختيار؛ تظل المهارة المطلوبة دائماً محورية.

المستوى	وضع الموجه	مناسب لـ
مقتصر	economy	المهام الروتينية، الاستخراج، التغييرات المحددة بوضوح. التكلفة لها وزن كبير.
متوازن	balanced	المعيار لمعظم التشغيلات: ملاءمة المهارة، التكلفة ومستوى الجودة في توازن.
مطلوب	expert	البنية، البحث، التحليلات المعقدة والمراجعات المطلوبة. مستوى النموذج له وزن أكبر بكثير، التكلفة أقل.

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

المستويات الثلاثة للاستقلالية

الاستقلالية لا تنظم ما يعتبره Argo صحيحاً، بل متى يحتاج لذلك إلى إنسان.

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

في الكود، هذه القواعد مطبقة بدقة كـ readonly، confirm_write، auto_write و bypass. المستويات الثلاثة تجعلها قابلة للتشغيل؛ لكن سياسة المشروع تظل دائماً السلطة الأخيرة. يمكنها مثلاً استبعاد مزودي السحابة، السماح بالنماذج المحلية فقط، حظر الوصول للشبكة، تقييد الأوامر، حماية الأسرار أو تحديد حد للتكلفة.

2. مستوى CEO يحول الطلب إلى خطة

يصف المستخدم الهدف أولاً بلغة عادية. يحصل مستوى CEO في Argo على نظرة عامة محدودة للمشروع، كتالوج النماذج المتاح ومعلومات المشروع ذات الصلة. يمكنه عند الأسئلة المفتوحة أن يسأل أولاً أو ينشئ خطة.

تحتوي الخطة على أكثر من قائمة مهام. كل مهمة تحصل على دور، وصف، تبعيات ومهارات مطلوبة - مثلاً coding، planning، qa_review أو context_comprehension. للمهام الصعبة يمكن أيضاً تدوين صعوبة أعلى. مستوى CEO لا يسمي نموذجاً بشكل صارم: إنه يصف العمل، ويقرر الموجه لاحقاً لكل مهمة النموذج المناسب.

تبقى الخطة بذلك الاتفاق القابل للقراءة إنسانياً حول المشروع، بينما قد تظل التنفيذ متكيفاً.

3. من الخطة يصبح رسم مهام (Task-Graph)

بعد الموافقة على الخطة، يحول Argo المهام إلى رسم مهام. عقدة قد تعمل فقط عندما تكون تبعياتها قد اكتملت بنجاح. المهام المستقلة يمكن أن تعمل بالتوازي.

المجدول (Scheduler) يرتب العقد الجاهزة وفقاً لخبرة نفعية قابلة للتتبع: الجودة المتوقعة ناقص عقوبة التكلفة والوقت والمخاطر. إذا كانت عقدة على المسار الحرج، تحصل على الأفضلية عند التساوي، لأنها تحدد المدة الإجمالية للتشغيل.

عند عدم يقين عالٍ أو مخاطر عالية، يمكن لـ Argo قبل المعالجة اختيار وضع تفكير مشترك: عدة منظورات تطور مناهج، تنتقد بعضها البعض وتقدم نهج عمل مبرر للعامل (Worker). ما إذا كان هذا يُسجل فقط أو يُنفذ حقاً، يقرره ملف تعريف التشغيل المختار قبل التشغيل.

4. قبل كل مهمة: سياق مناسب، قدرات مناسبة، نموذج مناسب

قبل أن يبدأ Worker، يبني Argo سياقاً مخصصاً للدور والمهمة. يتضمن ذلك الملفات ذات الصلة، نتائج التبعيات و - إن كان مفعلاً - حزمة ذاكرة مدمجة بالإضافة إلى أدلة مهارات مناسبة. Argo لا يأخذ معرفة المشروع كاملةً في البرومبت (prompt) بعمى. الذاكرة والمهارات تُختار حسب الصلة، المنشأ، الحداثة، التكلفة وحالة الأمان.

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

• ملاءمة القدرة: ما مدى جودة تقييم نموذج للمهارات المطلوبة؟ عند عدة مهارات يُنظر للمتوسط.
• التكلفة: كم تكلفة الطلب - أو عند توجيه التكلفة النشط النتيجة المتوقعة الناجحة؟
• مستوى النموذج: المهام الصعبة، الحرجة أمنياً، المعمارية والمراجعات قد تفضل مستوى Flagship.
• قيم الخبرة: بعد نتائج حقيقية كافية، تتدفق أحدث معدلات النجاح والتكرار لزوج نموذج/مهارة.

لحساب التكلفة يمكن لـ Argo استخدام التكلفة المتوقعة للنجاح: السعر المباشر، التكرارات المتوقعة، جهد التحقق، إعادة العمل المحتملة وعقوبة زمن استجابة صغيرة. استدعاء فردي رخيص ليس إذن تلقائياً الحل الأرخص، إذا كان يفشل غالباً أو يطلق إعادة عمل.

توصية نموذج صريحة تُقبل فقط إذا كانت متاحة، مسموحة بالسياسة وكبيرة بما يكفي للسياق. التخطيط، التفويض وفهم السياق لمستوى CEO يستخدمون بدورهم نموذجاً قوياً، مختاراً خصيصاً لهذه القدرات الثلاث.

5. العامل (Worker) يعالج المهمة في خطوات صغيرة قابلة للتحقق

عامل لا يعمل بإجابة واحدة. يمر بحلقة ReAct محدودة:

1. النموذج يقترح إجراءات منظمة - مثلاً قراءة ملفات، بحث، تنفيذ اختبارات أو كتابة تغييرات.
2. المنفذ (Executor) يفحص الصلاحية، المسار، مخاطر الأمر والسياسة النشطة.
3. Argo ينفذ فقط الإجراءات المسموحة.
4. النتائج، الفروقات (diffs) ورسائل الأخطاء تتدفق كملاحظة zurück إلى النموذج.
5. على هذا الأساس يصحح العامل خطوته التالية أو ينهي المهمة.

بهذا يمكن لعامل أن يقرأ أولاً الكود المعني، ثم يجري تغييراً، ينفذ اختباراً ويضم نتيجة الاختبار في القرار التالي. المسار الكامل يبقى مرئياً في سجل التشغيل.

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

6. عند الأخطاء: تصحيح مستهدف بدلاً من تكرار أعمى

ليس كل مهمة فاشلة يعني أن التشغيل بأكمله فشل. محرك التنسيق يميز أسباب الأخطاء ويتفاعل بشكل متحكم:

• خطأ مؤقت يمكن إعادة المحاولة ضمن حدود ثابتة.
• نتيجة تحقق صلبة تقدم اعتراضها الملموس كطلب للمحاولة التالية.
• عند تفعيل التتالي (cascading)، تأخذ المحاولة التالية رؤى السابقة، بدلاً من البدء من الصفر.
• بعد محاولة فاشلة، قد يفضل Argo نموذجاً أقوى.
• إذا استُنفد ميزانية، لا يبدأ محاولة عمياء باهظة: العقدة تنتهي بنتيجة جزئية موثقة أو تُصعد بشكل مرئي.

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

7. بعد التنفيذ: مراجعة، تحقق ودورة محتملة أخرى

بعد معالجة المهام المخططة، يفحص Argo الوضع المدمج من عدة زوايا:

• عامل QA قد يقرأ ملفات وينفذ أوامر اختبار.
• عامل البنية يفحص الهيكل للقراءة فقط ويبقى بوعي دون حقوق كتابة.
• محققون حتميون يمكنهم تنفيذ اختبارات، فحص أنواع أو تنقيح (linting) كأوراكل موضوعية.
• نتائج قائمة على نموذج وحتمية تُدمج لحكم شامل.

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

محقق في وضع المراقبة يوثق النتائج، لكن لا يحجب. في الوضع الملزم، يمكن لنتيجة صلبة منع اعتبار النتيجة ناجحة. هكذا يمكن اختيار الصرامة لكل ملف تعريف تشغيل، دون التخلي عن القابلية للتتبع.

8. فقط عندما يكون الوضع مختبراً: توثيق وملخص CEO

بعد دورة عمل وفحص مكتملة، يمكن لعامل توثيق تثبيت التغييرات. ثم ينشئ مستوى CEO الملخص للمستخدم: ما تم إنجازه؟ ما بقي مفتوحاً؟ أي فحوصات جرت؟ أي ملفات أو قرارات معنية؟

النتيجة أكثر من نص محادثة. التشغيل يقود معرفاً مشتركاً للخطة، اختيار النموذج، التكاليف، الإجراءات، أحكام التحقق، انقطاعات المستخدم وقرارات التصحيح اللاحقة. بذلك يمكن تتبع كيف وصل Argo إلى نتيجة.

9. في النهاية يقرر الإنسان عن مساحة العمل الحقيقية

افتراضياً يعمل Argo في worktree معزول. التغييرات توجد هناك كتصحيح (patch)، ليس صامتاً في المشروع الحقيقي. حسب مستوى الاستقلالية يحدث بعدها أحد ثلاثة أشياء:

• التصحيح يبقى جاهزاً للقبول، التبني الجزئي، المعالجة أو الرفض.
• تصحيح ناجح يُتبنى تلقائياً.
• عند تعارض مع ملفات معدلة בינתיים، يتوقف Argo بشكل مرئي؛ لا يكتب فوق تغييرات أجنبية.

تشغيل فاشل لا يُطبق تلقائياً. تكوين مستقل جداً لا يلغي السياسة: حماية الأسرار، قواعد الأوامر، حدود المزود، حدود الميزانية وبوابات الإنسان اللازمة تظل فعالة.

ما يؤديه محرك التنسيق

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

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

المسار بذلك محدد.