وصف الأدوات

لدى وكيل تحليلات أداتان: get_data وquery. الأولى تقرأ جدولًا، والثانية تنفّذ SQL. وصف كل منهما أربع كلمات. في بيئة الإنتاج، يستدعي النموذج query لقراءة جدول كامل، فيتجاوز المهلة عند 30 ثانية، ثم يعيد استدعاء query بالاستعلام نفسه، ثم يجرّب get_data باسم جدول مُختلق. لا يوجد سطر خاطئ في الحلقة. لقد فعل النموذج ما يمكن توقعه منه: التخمين، لأن أحدًا لم يُخبره بشيء.

وصف الأداة ليس توثيقًا، بل هو المواصفة التي يعتمد عليها النموذج ليتخذ قراره. فهو يؤدي دور توقيع الدالة والتوثيق النصي (docstring) وعقد الأخطاء في آن واحد. المخطط غير الدقيق ينتج استدعاءات غير صالحة؛ والاسم الملتبس ينتج استدعاءات للأداة الخطأ؛ وقيمة الإرجاع سيئة التكوين تنتج دورات حلقة لا فائدة منها. هذه هي الأسباب الثلاثة الغالبة لانحراف الوكيل، وهي تتقدم كثيرًا على اختيار النموذج، ويمكن إصلاحها كلها في الملف الذي تصرّح فيه عن أدواتك.

مخطط الأداة كاملًا

إليك الشكل الكامل لتصريح قابل للاستخدام. قارن كثافة المعلومات فيه بكثافتها في get_data.