من سلوك الوكلاء إلى وثائق موجهة للوكيل: دراسة تجريبية تتناول كيفية اكتشاف الوكلاء البرمجيين وقراءة وكتابة الوثائق الفنية

في عالم البرمجة الحديث، حيث تتزايد قدرة الوكلاء البرمجيين (Coding Agents) على التفاعل مع الأطر البرمجية، تبرز تساؤلات حول كيفية تعاملهم مع الوثائق الفنية التي أُعدت في الأصل للمطورين البشر. لقد أجرينا دراسة قائمة على سلوك الوكلاء لفهم هذه التفاعلات بشكل أكبر، من خلال تحليل مجموعتين بيانات عامتين: 557 جلسة برمجة استُخدمت فيها الوكالة من مشروع SWE-chat و33,097 طلب سحب وكيل من مشروع AIDev.

عبر تحليل هذه البيانات، وجدنا أربعة نتائج أساسية تتحدى الممارسات الحالية في كتابة الوثائق:
1. يهيمن على أعمال الوثائق بالنسبة للوكالات العناصر الموجهة لهم، حيث تمثل ملفات التعليمات والملاحظات العملية 60.5٪ من كل التفاعلات الوثائقية، مقارنةً بنسب متدنية جداً للوثائق الفنية التقليدية (10.6٪) والمراجع البرمجية (1.3٪).
2. يبقى الرابط بين استشارة الوثائق وتحرير الشيفرة غير محسوم، حيث تشير البيانات إلى احتمالية منخفضة جداً للانتقال بينهما، وهذا يشير إلى قضية معقدة في التفاعل بين الكود والوثائق.
3. لم يُلاحظ تسلسل تحقق صريح يعتمد على الوثائق، وتمت ملاحظة أن الاستشارة ترتبط بتقليل فوري للاختبارات، مما يعكس أسلوب عمل مميز للوكلاء.
4. الاستشارة غالباً ما تكون ذاتية (70.2٪) أكثر من كونها مدفوعة بالفشل (7.5٪)، ما يشير إلى أن الوثائق لا تواكب الكود التغييرات.

استنادًا إلى هذه النتائج، طورنا نموذجًا وصفيًا لتفاعل الوكلاء مع الوثائق، والذي يظهر أنها دورة تتكون من مرحلتين بدلاً من رحلة خطية، مما يجعلنا نتساءل حول فعالية الخصائص التي تُعتبر "موجهة للوكيل" مثل القابلية للتنفيذ والتحقق.

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