سجلات قرارات العمارة لمشاريع الذكاء الاصطناعي: دوّن السبب

بعد ستة أشهر من بدء مشروع وكلاء يسأل أحدهم لماذا تذهب مهام الدعم إلى نموذج متوسط المستوى، أو لماذا تقع الموافقات في بوابة الأدوات لا في الوكيل. تُظهر الشيفرة ما بُني. ولا تُظهر ما جرى النظر فيه. هذه هي الفجوة التي يملؤها سجل قرار العمارة، أو ADR.

صيغة صغيرة

اقترح Michael Nygard الصيغة عام 2011: وثيقة قصيرة لكل قرار مهم، فيها عنوان وحالة وسياق وقرار وعواقب. تُرقَّم السجلات بالتسلسل، ولا يُعاد استخدام رقم أبدًا.

• السياق: القوى المؤثرة، بما فيها القيود التي تفضّل ألا تكون موجودة.
• القرار: يُكتب بجمل كاملة وبصيغة المعلوم: سنفعل هذا.
• الحالة: مقترح أو مقبول أو مهمَل أو مستبدَل.
• العواقب: ما يصبح أسهل وما يصبح أصعب.

لا تعدّل التاريخ أبدًا

إذا عُكس قرار، فأبقِ السجل القديم ووسمه بأنه مستبدَل، مع إشارة إلى بديله. كثيرًا ما تكون البدائل المرفوضة أنفع جزء لقارئ في المستقبل، لأنها تمنع الفريق من إعادة النقاش نفسه.

قرارات تستحق التدوين في مشروع وكلاء

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

يمكن أن يكون السجل عشرة أسطر

مثال مختلَق للتوضيح: ADR-007، توجيه التصنيف إلى نموذج صغير. الحالة: مقبول. السياق: التصنيف يهيمن على الحجم ولا يحتاج إلى استدلال عميق. القرار: سنرسل التصنيف إلى أصغر مستوى ونصعّد عند انخفاض الثقة. البدائل المرفوضة: نموذج كبير واحد لكل شيء، بسبب الكلفة. العواقب: يجب أن نحتفظ بمجموعة تقييم لاكتشاف التراجعات حين يتغير النموذج الصغير.